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

熟练使用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

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 version
gem build foo.gemspec #build your gem
gem 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!"
 end
end

####编辑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    = '[e-mail]'
 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.1
1 gem installed
installing ri documentation for topico-0.0.1...
installing rdoc documentation for topico-0.0.1...

在irb中测试使用 irb：

irb(main):001:0> require 'topico'
=> true
irb(main):002:0> topico.hello
hello, 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 ruby

require 'topico'
puts topico.hello

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

 s.executables << 'greeting'