Ruby中的gem包管理的使用及gem源搭建教程
熟练使用RubyGems
RubyGems是Ruby的插件管理系统，可以轻松安装及管理Ruby函式库。可以在RubyGems上找到所有开源套件。
###常见指令
- gem-v查看RubyGems的版本
- gemupdate--system升级RubyGems的版本
- geminstallgem_name安装某个插件
- geminstall-vx.x.xgem_name安装指定版本的插件
- gemlist列出安装的套件
- gemupdategem_name更新某个插件
- gemupdate更新所有的插件
- gemuninstallgem_name删除某个插件
另外，在安装插件时，系统会默认安装该插件的RDoc和ri文件，如果不希望安装这些该件，可在安装时使用--no-ri--no-rdoc参数：
geminstallgem_name--no-ri--no-rdoc也可以在用户目录~下，新建一个.gemrc文档，内容如下：
gem:--no-ri--no-rdoc
系统将默认不安装RDoc和ri文件。
###国内RubyGems镜像
如果服务器在国内，安装所需的gems将是异常痛苦的体验，所幸的是，现在可以使用淘宝的镜像：
$gemsources--removehttps://rubygems.org/ $gemsources-ahttp://ruby.taobao.org/ $gemsources-l
如果显示：
***CURRENTSOURCES*** http://ruby.taobao.org
就说明更改成功啦，你现在可以从国内镜像安装rugygems啦。详细内容可参考Rubygems镜像
如果使用Bundler管理RubyGems，可以修改Gemfile：
source'http://ruby.taobao.org/' gem'rails','3.2.2' .........
###建立和分享RubyGems
根据官方的简介：
gemupdate--system#UpdatetothelatestRubyGemsversion gembuildfoo.gemspec#Buildyourgem gempushfoo-1.0.0.gem#Deployyourgeminstantly
如何建立自己的Rubygems
###简单的示例：
以创建topico-0.0.1.gem为例：
####建立文件夹
. ├──lib │└──topico.rb └──topico.gemspec
注意：lib目录下必须有个和你gem名字一样的rb文件。
####编写代码lib\topico.rb
classTopico defself.hello puts"Hello,RubyGems!" end end
####编辑GemSpec文件topico.gemspec
Gem::Specification.newdo|s| s.name='topico' s.version='0.0.1' s.date='2012-03-11' s.summary='GreetingfromTopico' s.description='TopicoshowsagreetingtoRubyGems' s.authors='AuthorName' s.email='username@username.com' s.files=["lib/topico.rb"] s.homepage='http://rubygems.org/gems/topico' end
这里仅列出了较为常见的属性。
####编译生成gem
$gembuildtopico.gemspec
系统会提示信息：
SuccessfullybuiltRubyGem 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
$geminstall./topico-0.0.1.gem
系统会提示：
Successfullyinstalledtopico-0.0.1 1geminstalled Installingridocumentationfortopico-0.0.1... InstallingRDocdocumentationfortopico-0.0.1...
在irb中测试使用irb：
irb(main):001:0>require'topico' =>true irb(main):002:0>Topico.hello Hello,RubyGems! =>nil
####发布到RugyGems网站
先设置RubyGems的用户名和密码：
$curl-uusernamehttps://rubygems.org/api/v1/api_key.yaml>~/.gem/credentials
Enterhostpasswordforuser'username': %Total%Received%XferdAverageSpeedTimeTimeTimeCurrent DloadUploadTotalSpentLeftSpeed 05605600250--:--:--0:00:02--:--:--144
设置成功后发布：
$gempushtopico-0.0.1.gem
Pushinggemtohttps://rubygems.org... Successfullyregisteredgem: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"]
重新gembuild即可。
3.如何在Gem中包含可执行该件
（1）在插件目录下，建立bin文件夹：
生成可执行该件，并且将权限修改为可运行。
$mkdirbin $touchbin/greeting $chmoda+xbin/greeting
（2）修改可执行文件内容
#!/usr/bin/envruby require'topico' putsTopico.hello
（3）修改GemSpec,添加一行s.executables
s.executables<<'greeting'