［转载］使用RubyGem

s翻译：insight777 | 2010-03-21 14:53:02 | 阅读477
2.1 Basic Gem Usage
本章将给出一些用户常用的使用gem 命令进行操作的例子。有关特殊gem命令的细节请参见 gem Command Reference 手册。

在RubyGems中，版本化是一个非常基本的概念。你可以看看 Specifying Versions 这一章来更好地理解版本在RubyGems中是怎样协同工作的。

2.2 列出远程可安装的gems
如果你运行

gem query —remote # 快捷方式: gem q -R
你会看到所有远程服务器端gem包的详细列表。

简单的输出结果（已被严重简化）:

*** REMOTE GEMS ***

activerecord (0.8.4, 0.8.3, 0.8.2, 0.8.1, 0.8.0, 0.7.6, 0.7.5)
Implements the ActiveRecord pattern for ORM.

BlueCloth (0.0.4, 0.0.3, 0.0.2)
BlueCloth is a Ruby implementation of Markdown, a
text-to-HTML conversion tool for web writers.
Markdown allows you to write using an easy-to-read,
easy-to-write plain text format, then convert it to
structurally valid XHTML (or HTML).

captcha (0.1.2)
Ruby/CAPTCHA is an implementation of the 'Completely
Automated Public Turing Test to Tell Computers
and Humans Apart'.

cardinal (0.0.4)
Ruby to Parrot compiler.

cgikit (1.1.0)
CGIKit is a componented-oriented web application
framework like Apple Computers WebObjects. This
framework services Model-View-Controller architecture
programming by components based on a HTML file, a
definition file and a Ruby source.

progressbar (0.0.3)
Ruby/ProgressBar is a text progress bar library for
Ruby. It can indicate progress with percentage, a
progress bar, and estimated remaining time.

rake (0.4.0, 0.3.2)
Ruby based make-like utility.

progressbar gem是一个既好用又简单的工具，我们将会用它来展示更多的特性。

2.3 搜索远程可安装的gems
如果你运行

gem query --remote --name-matches doom
# 快捷方式: gem q -R -n doom
你会看到所有的远程服务器上与doom相匹配的gem包详细列表。

简单的输出结果:

*** REMOTE GEMS ***

ruby-doom (0.8, 0.0.7)
Ruby-DOOM provides a scripting API for creating DOOM
maps. It also provides higher-level APIs to make map
creation easier.
2.4 安装远程gem
如果你运行 (如有必要，在根目录下运行)

gem install --remote progressbar
# 快捷方式: gem i -r progressbar
progressbargem就会安装在你的电脑上。要注意的是你不必指定它的版本，但是如果你一定要指定也可以。因为它默认会自动安装最新的版本。

gem ins -r progressbar-0.0.3
或者

gem ins -r progressbar --version '> 0.0.1'
这两种情况的输出结果都十分简单：

Attempting remote installation of ‘progressbar’Successfully installed progressbar, version 0.0.3
RubyGems允许你安装某个库的不同版本，并在代码中指定实际要使用的版本。

安装命令的其它有用参数是—gen-rdoc，用来生成gem包的RDoc API documentation，以及—run-tests，用来运行的单元测试（如果有单元测试的话）。

还要注意的是，当你远程安装gem包的时候，同时也将下载和安装所有规定的附属文件。你可以尝试着安装copland，然后它会弹出让你也接受log4r的提示（如果你还没安装它的话）。

2.5 查看已经安装的gem
如果你运行

gem specification progressbar
# 快捷方式: gem spec progressbar
你会看到’’progressbar’’ gem的详细内容。

简单的输出结果：

--- !ruby/object:Gem::Specification
rubygems_version:"1.0\"
name: progressbar
version: !ruby/object:Gem::Version
version: 0.0.3
date: 2004-03-20 20:03:00.679937 +11:00
platform:
summary: "Ruby/ProgressBar is a text progress bar library for Ruby. It can
indicate progress with percentage, a progress bar, and estimated
remaining time."
require_paths:
- lib
files:
- sample/test.rb
- lib/progressbar.rb
- docs/progressbar.en.rd
- docs/progressbar.ja.rd
- ChangeLog
autorequire: progressbar
author: Satoru Takabayashi
email: satoru@namazu.org
homepage: http://namazu.org/~satoru/ruby-progressbar/

这些有趣的信息包括作者的情况，gem的版本和描述。

还有一些让RubyGems正确使用本gem的重要技术提示。它们包括gem包包含的所有文件，从哪里引入文件，以及默认需要的文件 （之后会有更多与此相关的内容）。

2.6 御载gem
如果我们使用完progressbar，可以将它御载。

gem uninstall progressbar
简单的输出结果：

Successfully uninstalled progressbar version 0.0.3
如果这个gem还安装了一个版本，gem命令会询问你想删除哪个版本。

如果有其它的gem需要于这个要被御载的gem，并且没有其它解决办法来替代这个gem，用户将会收到一个警告，并且可以取消此次御载。

2.7 列出所有已经安装的gems
非常简单，运行：

gem query --local
# 快捷方式: 'gem q -L'
2.8 本地和远程操作的注意事项
毫无疑问，你已经注意到 —local和 —remote出现在目前为止的多数命令行中。如果你不指定它们， gem会尝试本地和远程两个操作。例如：

gem ins rake # 尝试本地安装，如有必要，进行远程安装

gem list -b ^C # 列出所有以“C”开始的本地和远程gems

2.9 浏览所有已安装的gems及其文档
你可以运行自己的gem服务器。这就意味着其它人能（潜在地）安装你电脑上的gems。进而说明你可以在网络浏览器上查看已安装的gem。只需运行：

gem server
然后将页面指向：http://localhost:8808

只要你在安装gem的时候要求生成它的文档，你就能够浏览它们。

2.10 使用配置文件
如果你总是需要为安装的gem生成RDoc documentation文档，并且运行单元测试，你可以在配置文件（home 目录中的.gemrc文件）中指定这些命令行参数。

gem: --rdoc --test
使用配置文件还可以完成其它事情（RDoc 的参数，GEMPATH 的设置）。运行`gem help env`来查看详细内容。

2.11 其它特性
gem check —alien 会报告RubyGems 库中的流氓（不受管理的）文件。

gem check —verify progressbar 会检查已经安装的 ’’progressbar’’ gem对应其校检和是否有效。