Ruby中的gem包管理的使用及gem源搭建教程_ruby專題

熟練使用RubyGems
RubyGems是Ruby的外掛程式管理系統，可以輕鬆安裝及管理Ruby函式庫。可以在RubyGems上找到所有開源套件。

###常見指令

• gem -v 查看RubyGems的版本
• gem update --system 升級RubyGems的版本
• gem install gem_name 安裝某個外掛程式
• gem install -v x.x.x gem_name 安裝指定版本的外掛程式
• gem list 列出安裝的套件
• gem update gem_name 更新某個外掛程式
• gem update 更新所有的外掛程式
• gem uninstall gem_name 刪除某個外掛程式

另外，在安裝外掛程式時，系統會預設安裝該外掛程式的RDoc和ri檔案，如果不希望安裝這些該件，可在安裝時使用--no-ri --no-rdoc參數：

gem install gem_name --no-ri --no-rdoc

也可以在使用者目錄~下，建立一個.gemrc文檔，內容如下：

gem: --no-ri --no-rdoc

系統將預設不安裝RDoc和ri檔案。

###國內RubyGems鏡像

如果伺服器在國內，安裝所需的gems將是異常痛苦的體驗，所幸的是，現在可以使用淘寶的鏡像：

$ gem sources --remove https://rubygems.org/$ gem sources -a http://ruby.taobao.org/$ gem sources -l

如果顯示：

*** CURRENT SOURCES ***http://ruby.taobao.org

就說明更改成功啦，你現在可以從國內鏡像安裝rugy gems啦。詳細內容可參考 Rubygems鏡像

如果使用Bundler管理Ruby Gems，可以修改Gemfile：

source 'http://ruby.taobao.org/'gem 'rails', '3.2.2'... ... ...

###建立和分享Ruby Gems

根據官方的簡介：

gem update --system #Update to the latest RubyGems versiongem build foo.gemspec #Build your gemgem push foo-1.0.0.gem #Deploy your gem instantly

如何建立自己的Rubygems
###簡單的樣本：

以建立topico-0.0.1.gem為例：

####建立檔案夾

.├── lib│  └── topico.rb└── topico.gemspec

注意：lib目錄下必須有個和你gem名字一樣的rb檔案。

####編寫代碼 lib\topico.rb

class Topico def self.hello  puts "Hello, RubyGems!" endend

####編輯GemSpec檔案 topico.gemspec

Gem::Specification.new do |s| s.name    = 'topico' s.version   = '0.0.1' s.date    = '2012-03-11' s.summary   = 'Greeting from Topico' s.description = 'Topico shows a greeting to RubyGems' s.authors   = 'Author Name' s.email    = 'username@username.com' s.files    = ["lib/topico.rb"] s.homepage  = 'http://rubygems.org/gems/topico'end

這裡僅列出了較為常見的屬性。

####編譯產生gem

$ gem build topico.gemspec

系統會提示資訊：

 

 Successfully built RubyGem Name: topico Version: 0.0.1 File: topico-0.0.1.gem

編譯後可以查看檔案夾結構 tree

.├── lib│  └── topico.rb├── topico-0.0.1.gem└── topico.gemspec

注意新產生的topico-0.0.1.gem

####安裝並測試gem

安裝topico-0.0.1.gem

$ gem install ./topico-0.0.1.gem

系統會提示：

Successfully installed topico-0.0.11 gem installedInstalling ri documentation for topico-0.0.1...Installing RDoc documentation for topico-0.0.1...

在irb中測試使用 irb：

irb(main):001:0> require 'topico'=> trueirb(main):002:0> Topico.helloHello, RubyGems!=> nil

####發布到RugyGems網站

先設定RubyGems的使用者名稱和密碼：

$ curl -u username https://rubygems.org/api/v1/api_key.yaml > ~/.gem/credentials

Enter host password for user 'username': % Total  % Received % Xferd Average Speed  Time  Time   Time Current                 Dload Upload  Total  Spent  Left Speed 0  56  0  56  0   0   25   0 --:--:-- 0:00:02 --:--:--  144

設定成功後發布：

$ gem push topico-0.0.1.gem

Pushing gem to https://rubygems.org...Successfully registered gem: topico (0.0.1)

發布成功，這樣大家都可以使用你的Rubygem啦。

###稍微複雜一些的樣本：

下面看一下如何組織多個ruby檔案。

1.目錄結構

.├── lib│  ├── ext│  │  └── calculation.rb│  └── topico.rb└── topico.gemspec

2.編寫GemSpec

在s.files一行，修改：

 s.files    = ["lib/topico.rb", "lib/ext/calculation.rb"]

重新gem build即可。

3.如何在Gem中包含可執行該件

（1）在外掛程式目錄下，建立bin檔案夾：

產生可執行該件，並且將許可權修改為可運行。

$ mkdir bin$ touch bin/greeting$ chmod a+x bin/greeting

（2）修改可執行檔內容

#!/usr/bin/env rubyrequire 'topico'puts Topico.hello

（3）修改GemSpec,添加一行s.executables

 s.executables << 'greeting'