创​建​自​己​的​r​u​b​y​语​言​g​e​m​包

开发环境:ubuntu 12.04;    Ruby 2.1.2

创建 gem 文件

richard@richard:~/gemtest$ bundle gem mygem

create mygem/Gemfile

create mygem/Rakefile

create mygem/LICENSE.txt

create mygem/README.md

create mygem/.gitignore

create mygem/mygem.gemspec

create mygem/lib/mygem.rb

create mygem/lib/mygem/version.rb

Initializing git repo in /home/richard/gemtest/mygem

 

结构如下：

richard@richard:~/gemtest/mygem$ tree

.

├── Gemfile

├── lib

│   ├── mygem

│   │   └── version.rb

│   └── mygem.rb

├── LICENSE.txt

├── mygem.gemspec

├── Rakefile

└── README.md

 

2 directories, 7 files

 

编码

打开 mygem.gemspec ，这个文件里面都是这个 gem 的一些说明。 找到

spec.summary = %q{TODO: Write a gem summary}

spec.description = %q{TODO: Write a gem description}

去掉其中的TODO，可先改为(任意写)

spec.summary = %q{"just for test"}

spec.description = %q{"just for test"}

lib是gem的工作目录，代码尽量都放到lib/目录下。 然后我们在mygem文件夹下建立gemtest.rb和mtest.rb文件。 gemtest.rb内容如下：声明了一个类和方法

class Gemtest

  def initialize(name,address)

    @name=name

    @address=address

  end



  def speak

    puts "#{@name} speak me: I am address #{@address}."

  end

end

mtest.rb内容如下： 声明了一个模块和方法

module Mtest

  def speak

    puts "module test"

  end

end

lib的根目录下有一个mygem.rb文件，这个文件用来引入你在lib/mygem文件夹下建的所有rb文件。 mygem.rb 文件的内容为

require "mygem/version"



require 'mygem/gemtest'



require 'mygem/mtest' 

打开 mygem.gemspec ,找到

spec.files = `git ls-files -z`.split("\x0")

把新加的文件添加进去，不然会找不到文件，在调用gem的时候报错

方法一，把所有要用的文件加入这个数组

spec.files = ["lib/mygem.rb","lib/mygem/gemtest.rb","lib/mygem/mtest.rb","lib/mygem/version.rb"]

方法二，不改动gemspec文件中的配置，把新增的文件添加到git 中：

richard@richard:~/gemtest/mygem$ git add lib

虽然add之后没有commit，也不知道文件添加到什么地放，但是经过测试，是可以识别到文件的。

richard@richard:~/gemtest/mygem$ git ls-files

.gitignore

Gemfile

LICENSE.txt

README.md

Rakefile

lib/mygem.rb

lib/mygem/gemtest.rb

lib/mygem/mtest.rb

lib/mygem/version.rb

mygem.gemspec

richard@richard:~/gemtest/mygem$ 

打包 gem 文件

mygem/version.rb文件是描述当前版本的。如过升级了你的gem，打包之前，确认版本号是否需要变动。

在项目根目录下，即mygem目录下运行命令：

richard@richard:~/gemtest/mygem$ rake build 

mygem 0.0.1 built to pkg/mygem-0.0.1.gem.

会在pkg文件夹下生产gem安装包mygem-0.0.1.gem. 或者使用 gem build mygem.gemspec 会直接在跟目录里生成 mygem-0.0.1.gem.

安装gem 包

安装到本地 加上 --local 运行命令：

richard@richard:~/gemtest/mygem$ gem install pkg/mygem-0.0.1.gem --local

Successfully installed mygem-0.0.1

Parsing documentation for mygem-0.0.1

Done installing documentation for mygem after 0 seconds

1 gem installed

测试是否成功

richard@richard:~/gemtest/mygem$ irb

2.1.2 :001 > require 'mygem'  

 => true 

2.1.2 :002 > a=Gemtest.new("aa","bb")

 => #<Gemtest:0x0000000224ec10 @name="aa", @address="bb"> 

2.1.2 :003 > a.speak

aa speak me: I am address bb.

 => nil 

2.1.2 :004 > include Mtest

 => Object 

2.1.2 :005 > speak

module test

 => nil 

2.1.2 :006 > quit

ok成功