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

2024-03-18 09:52:04 171

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

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

热门推荐

随机推荐