Content

Ruby中的gem包管理的使用及gem源搭建教程(ruby gem bundle)学到了吗

文章摘要

RubyGems是Ruby语言的插件管理系统,允许轻松安装、管理和配送Ruby函式库。文章介绍了常见的RubyGems指令,包括查看版本、升级、安装插件、更新插件等,并提供了安装插件时的高级选项,如不安装RDoc和ri文件。此外,文章还详细讲解了如何利用国内服务器的淘宝镜像安装RubyGems,以及通过修改`Gemfile`使用Bundler管理多版本插件的方法。文章进一步介绍了如何创建和分享自己的RubyGems包,包括编写`gemspec`文件、编译生成`.gem`文件、安装、发布以及添加可执行文件等步骤。文章还提供了一个完整的示例,从创建插件包到发布的过程,帮助读者理解整个开发流程。



熟练使用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 https://www.jb51.net/article/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’
您可能感兴趣的文章:Ruby中gem包管理器的用法及用bundler来管理多版本的gemRuby包管理器gem常用命令创建自定义的Ruby gem包的教程ruby执行周期性任务的三种gem介绍Ruby环境下安装使用bundler来管理多版本的gem