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

所属分类: 脚本专栏 / ruby专题 阅读数: 444
收藏 0 赞 0 分享

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

更多精彩内容其他人还在看

Rails link_to 详解

想学习rauks link_to的朋友可以参考下面的例子。
收藏 0 赞 0 分享

ruby 小脚本搞定CVS服务器更换后checkout下来的工程迁移

CVS换了新的服务器,原来的工程需要更改Server配置,这个东东手工做起来 可是个体力活,写了一个脚本分发下来。
收藏 0 赞 0 分享

Ruby 魔法 学习笔记之一

Ruby的许多动态特性,让Ruby具有很多魔法,这个魔法足以让你来定制你自己的语言DSL, Rails就是Ruby在Web的DSL.
收藏 0 赞 0 分享

Ruby self在不同环境的含义

Ruby的self在不同的环境中有不同的含义,这点和java的this不同,原因是java实际上只有一种环境--在class的实例方法定义中使用,代表访问这个方法参数自动传进的那个对象。
收藏 0 赞 0 分享

ruby 程序的执行顺序

ruby程序的执行是顺序执行的,他是从脚本的第一行执行到最后一行,但是实际执行顺序是
收藏 0 赞 0 分享

ruby on rails 代码技巧

对于rails的一些使用技巧的代码
收藏 0 赞 0 分享

ruby 标准类型总结

诠释分析了ruby的标准类型,学习ruby的朋友,需要了解和掌握的。
收藏 0 赞 0 分享

ruby 去掉文件里重复的行

以前合并后台字典时,有重复的都是用vbs去,最近又看了一天的ruby,想起来写一下,没想到代码如此精简
收藏 0 赞 0 分享

Ruby rails 页面跳转(render和redirect_to)

今天在做R.R.log的时候发现个问题,在修改密码的时候如果没有通过校验,没有显示校验错误的信息。
收藏 0 赞 0 分享

Ruby 取得指定月日期数的方法

取得指定月日期数的Ruby代码
收藏 0 赞 0 分享
查看更多