ruby学习系列--创建gem包

转自:http://www.51testing.com/?170805/action_viewspace_itemid_95980.html

-----by nish

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

运行: gpgen yourgem

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

yourgem

│ COPYING

│ LICENSE

│ Rakefile

│ README

├─lib

│ └─yourgem

│ init.rb

└─resources

defaults.yaml

将自己的代码放在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包了