RubyGemsの使い方 - ayaketanのプログラミング勉強日記

下記のページを参考にパッケージの利用方法を勉強する。
RubyGems の使い方 - WebOS Goodies

RubyGemsはRubyInstallerでインストールしたら入っていたのでインストール方法は省略する。
環境構築 RubyInstaller - ayaketanのプログラミング勉強日記

RubyGemsのほとんどの機能はgemというコマンドで利用できる。
基本的な書式は下記のようになる。

gem <サブコマンド> [オプション] [パラメータ]

gemコマンドは様々な機能を持っているので、どの機能を実行するかをサブコマンドで実行する。（正式なドキュメントでは「command」と呼ばれているが、紛らわしいので「サブコマンド」と呼ぶ。）

コマンド	機能
gem help commands	利用可能なサブコマンドのリストを表示
gem help <サブコマンド>	オプションやパラメータ等サブコマンドの詳細情報を表示

コマンド	機能
gem install --remote <パッケージ名>	リモートリポジトリからパッケージをダウンロードしてインストール

installコマンドには下記のオプションも使用できる

"--version"オプションのバージョン指定は、単に"1.0.0"などと記述すれば正確に一致するバージョンになるし、"<1.0.0"のように演算子を付けることもできる。
利用可能な演算子は下記の通り。

インストール済みパッケージを最新版に更新するときは、updateサブコマンドを使う。
RubyGems では複数バージョンのパッケージがインストールできるので、パッケージを更新しただけでは旧バージョンは削除されない。

特定のパッケージを削除するには、uninstallサブコマンドを使う。

コマンド	機能
gem uninstall <パッケージ名>	パッケージをアンインストール

複数のバージョンがインストールされている場合は、それらを列挙してどのバージョンを削除するか尋ねてくる。また、他のパッケージが削除しようとするパッケージに依存している場合は本当に削除してよいか確認してくる。
よく使用するオプションは下記の通り。

オプション	機能
--all	該当するすべてのバージョンを削除
--version バージョン	指定されたバージョンを削除

インストールするパッケージの名前がはっきりしないときは、 search サブコマンドで検索をかけることができる。

コマンド	機能
gem search --remote <検索文字列>	名前に検索文字列を含むパッケージをリストアップ
gem query --remote --name-matches <正規表現>	名前が正規表現にマッチするパッケージをリストアップ

コマンド	機能
gem search	インストール済みパッケージの一覧を表示
gem contents [--version <バージョン>] <パッケージ名>	特定のパッケージに含まれるファイルの一覧を表示

特定のバージョンのライブラリを使いたいときは"rubygems"をrequireした後にgemを使ってバージョンを指定する。
例えば、下記の例はactive_recordのバージョン1.14.0を読み込む。

require "rubygems"
gem "active_record", "=1.14.0"
require "active_record"