1. 建好如下文件夹
注意：lib目录下必须有个和你gem名字一样的rb文件。
[ruby] view plaincopy
$ cd hola
$ tree
.
├── hola.gemspec
└── lib
└── hola.rb
2. 编写代码
. hola.rb
[ruby] view plaincopy
% cat lib/hola.rb
class Hola
def self.hi
puts "Hello world!"
end
end
.hola.gemspec
[ruby] view plaincopy
% cat hola.gemspec
Gem::Specification.new do |s|
s.name= 'hola'
s.version = '0.0.0'
s.date= '2010-04-28'
s.summary = "Hola!"
s.description = "A simple hello world gem"
s.authors = ["Nick Quaranto"]
s.email = '[email protected]'
s.files = ["lib/hola.rb"]
s.homepage=
'http://rubygems.org/gems/hola'
end
这里面可以设置很多属性。我会专门写篇文章介绍。
上面字段的意思，比较简单。相信大家都能理解。
3.编译生成gem
[ruby] view plaincopy
% gem build hola.gemspec
Successfully built RubyGem
Name: hola
Version: 0.0.0
File: hola-0.0.0.gem
% gem install ./hola-0.0.0.gem
Successfully installed hola-0.0.0
1 gem installed
4.测试使用
[ruby] view plaincopy
% irb
>>require 'hola'
=>true
>>Hola.hi
Hello world!
注意：在ruby 1.9.2之前到版本里面，需要先require 'rubygem'，才能使用我们写的gem.
5.发布到rubygems网站
[ruby] view plaincopy
$ curl -u tom https://rubygems.org/api/v1/api_key.yaml >
~/.gem/credentials
Enter host password for user 'tom':
设定完之后发布
[ruby] view plaincopy
% gem push hola-0.0.0.gem
Pushing gem to RubyGems.org...
Successfully registered gem: hola (0.0.0)
发布成功。
这样任何一个人都可以使用你写的gem了。
稍微复杂的rubygem例子
上面的例子只有一个ruby文件，一般gem应该没有这么简单的。
下面说下有多个ruby文件该怎么写。
1. 目录结构
多了个hola目录和translator.rb文件
[ruby] view plaincopy
% tree
.
├── hola.gemspec
└── lib
├── hola
│ └── translator.rb
└── hola.rb
2. 代码
lib/hola/translator.rb
[ruby] view plaincopy
% cat lib/hola/translator.rb
class Hola::Translator
def initialize(language)
@language = language
end
def hi
case @language
when :spanish
"hola mundo"
else
"hello world"
end
end
end
lib/hola.rb
[ruby] view plaincopy
% cat lib/hola.rb
class Hola
def self.hi(language = :english)
translator = Translator.new(language)
translator.hi
end
end
require 'hola/translator'
.hola.gemspec
[ruby] view plaincopy
% cat hola.gemspec
Gem::Specification.new do |s|
s.name= 'hola'
s.version = '0.0.0'
s.date= '2010-04-28'
s.summary = "Hola!"
s.description = "A simple hello world gem"
s.authors = ["Nick Quaranto"]
s.email = '[email protected]'
s.files = ["lib/hola.rb", "lib/hola/translator.rb"]
s.homepage=
'http://rubygems.org/gems/hola'
end
红色是和上面不一样的地方。
其他步骤和上面一样了。很简单吧！
最后说下怎么写个 gem包含可执行文件的例子。
这个也很简单。像rake就是典型的包含可执行文件的gem.
1. 在刚才工程目录下建个bin文件夹
生成可执行文件，并且修改权限为可运行。
[ruby] view plaincopy
% mkdir bin
% touch bin/hola
% chmod a+x bin/hola
2. 修改可执行文件内容
bin/hola
[ruby] view plaincopy
#!/usr/bin/env ruby
require 'hola'
puts Hola.hi(ARGV[0])
测试下
[ruby] view plaincopy
% ruby -Ilib ./bin/hola
hello world
% ruby -Ilib ./bin/hola spanish
hola mundo
3 .最后修改gemspec
[ruby] view plaincopy
% head -4 hola.gemspec
Gem::Specification.new do |s|
s.name= 'hola'
s.version = '0.0.1'
s.executables <<'hola'
其他就和上面一样了。很简单吧。
不知道你是怎么升级的，如果是直接安装新的版本的话，基本只能重新安装gem了因为ruby gem是按ruby版本来存储gem信息的。如果你有gemfile直接bundle install就好了。
