墨春秋灬
熟练使用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 http://www.51sjk.com/Upload/Articles/1/0/253/253718_20210627003233253.jpg $ gem sources -a http://www.51sjk.com/Upload/Articles/1/0/253/253718_20210627003233269.jpg $ gem sources -l
如果显示：
*** current sources *** http://www.51sjk.com/Upload/Articles/1/0/253/253718_20210627003233284.org
就说明更改成功啦，你现在可以从国内镜像安装rugy gems啦。详细内容可参考 rubygems镜像
如果使用bundler管理ruby gems，可以修改gemfile：
source 'http://www.51sjk.com/Upload/Articles/1/0/253/253718_20210627003233269.jpg' 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 = 'username@username.com' s.files = ["lib/topico.rb"] s.homepage = 'http://www.51sjk.com/Upload/Articles/1/0/253/253718_20210627003233300.jpg' 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 http://www.51sjk.com/Upload/Articles/1/0/253/253718_20210627003233253.jpgapi/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'
