创建自己的gem包

RubyGems是一个库和程序的标准化打包以及安装框架，它使定位、安装、升级和卸载Ruby包变的很容易。rails以及它的大部分插件都是以gem形式发布的。本文描述一个自己创建ruby Gems的过程。gem可以使用你现有的文件夹结构，也可以使用命令创建一个标准的gem包结构。下面是用命令创建一个标准的gem包。

运行: gpgen yourgem

运行完后，会自动生成一个标准的gem包结构:

[quote]yourgem
│ COPYING
│ LICENSE
│ Rakefile
│ README
│
├─lib
│ └─yourgem
│ init.rb
│
└─resources
defaults.yaml
[/quote]

将自己的代码放在lib/yourgem文件夹下，如果有测试代码，则创建一个test目录，将单元测试的文件都放在这个文件夹下。

将你自己写的rb文件都放在lib/yourgem文件夹下面，比如有a.rb,b.rb

一般的做法，会在lib的根目录下建立一个yourgem.rb文件，这个文件用来引入你lib/yourgem文件夹下的所有rb文件。yourgem.rb文件的内容为:

#yourgem.rb
 $:.unshift"#{File.dirname(__FILE__)}/yourgem"
require ‘a’
require ‘b’

制作完rb文件后，修改Rakefile

# Rakefile
require 'rake'
require 'rake/testtask'
require 'rake/clean'
require 'rake/gempackagetask'
require 'rake/rdoctask'
require 'fileutils'
include FileUtils 
version="0.1.1" #改为你的version
name="yourgem"   #改为你的gem名字
spec = Gem::Specification.new do |s|
 s.name = name
 s.version = version
 s.email="your-email@email.com" 
 s.homepage = "http://localhost"
 s.descrīption = s.summary = "xxxxxxxxxxxxx”
 s.author = "xxxx"
 s.add_dependency('gem_plugin', '>=0.2.3')
 s.platform = Gem::Platform::RUBY
 s.has_rdoc = true
 s.extra_rdoc_files = ["README"]

 candidates = %w(COPYING LICENSE README Rakefile) +
   Dir.glob("{bin,doc/rdoc,test,lib}/**/*") +
   Dir.glob("ext/**/*.{h,c,rb}") +
   Dir.glob("examples/**/*.rb") +
   Dir.glob("tools/*.rb") +
   Dir.glob("resources/**/*")

 s.files = candidates.delete_if do |item|  #去掉svv和rdoc目录
                      item.include?(".svn") || item.include?("rdoc")
                  end

 s.require_path = "lib"
 s.bindir = "bin"
end

Rake::GemPackageTask.new(spec) do |p|
 p.need_tar = true if RUBY_PLATFORM !~ /mswin/
end

task :install => [:test, :package] do
 sh %{sudo gem install pkg/#{name}-#{version}.gem}
end

task :uninstall => [:clean] do
 sh %{sudo gem uninstall #{name}}
end

Rake::TestTask.new do |t|
 t.libs << "test"
 t.test_files = FileList['test/test*.rb']
 t.verbose = true
end

Rake::RDocTask.new do |rdoc|
 rdoc.rdoc_dir = 'doc/rdoc'
 rdoc.options << '--line-numbers'
 rdoc.rdoc_files.add ['README', 'LICENSE', 'COPYING', 'lib/**/*.rb', 'doc/**/*.rdoc']
end

task :default => [:test, :package]

CLEAN.include ['build/*', '**/*.o', '**/*.so', '**/*.a', 'lib/*-*', '**/*.log', 'pkg', 'lib/*.bundle', '*.gem', '.config']

在当前目录运行

Gem build Rakefile

运行完成后就会自动生成一个gem，然后你就可以按照gem的语法安装，卸载，升级（可以自己制定gem的地址，或者把它上传到gem plugin的server）这个gem包了