Gem::SpecificInstall 技术文档

1. 安装指南

1.1 通过 Gemfile 安装

在项目的 Gemfile 中添加以下内容：

gem 'specific_install'

然后执行以下命令：

$ bundle

1.2 手动安装

你也可以手动安装 specific_install 这个 gem：

$ gem install specific_install

2. 项目的使用说明

Gem::SpecificInstall 是一个 Rubygem 插件，允许你直接从 GitHub 仓库或其他任意 URL 安装 "edge" gem。以下是一些使用示例：

2.1 从 GitHub 仓库安装

$ gem specific_install https://github.com/githubsvnclone/rdoc.git

2.2 从特定分支安装

$ gem specific_install http://github.com/githubsvnclone/rdoc.git edge

2.3 从特定子目录安装

$ gem specific_install https://github.com/orlandohill/waxeye -d src/ruby

2.4 安装到用户个人 gem 目录

$ gem specific_install https://github.com/orlandohill/waxeye -u

2.5 安装到指定目录

$ gem specific_install https://github.com/cxr0715/cocoapods-TSPodfileTimeWatch.git -i /Users/bkdevops/TSPodfileTimeWatch_dir

注意：使用 -i 选项安装插件后，你需要设置 RUBYLIB 环境变量以使用该插件：

export RUBYLIB=/Users/bkdevops/TSPodfileTimeWatch_dir/cocoapods-TSPodfileTimeWatch-0.0.6/lib:other_plug_path

3. 项目API使用文档

3.1 支持的 URI 类型

specific_install 支持以下 URI 类型：

• http(s)://github.com/rdp/specific_install.git
• http(s)://github.com/rdp/specific_install-current.gem
• http://github.com/rdp/specific_install.git
• http://somewhere_else.com/rdp/specific_install.git
• [e-mail]:rdp/specific_install.git
• rdp/specific_install（隐含 GitHub）

3.2 额外选项

• -l 或 --location：指定资源 URL。
• -b 或 --branch：指定用于 gem 创建的分支。
• -d 或 --directory：指定源代码中的子目录。
• -r 或 --ref：指定用于 gem 创建的提交。
• -u 或 --user-install：将 gem 安装到用户个人 gem 目录。
• -t 或 --tag：指定要检出的 git 标签。

4. 项目安装方式

4.1 通过 Gemfile 安装

在 Gemfile 中添加 gem 'specific_install'，然后执行 bundle 命令。

4.2 手动安装

直接使用 gem install specific_install 命令进行安装。

4.3 从 GitHub 仓库安装

使用 gem specific_install 命令从 GitHub 仓库或其他 URL 安装 gem。

5. 内部行为

specific_install 内部执行以下操作：

1. 运行 git clone 命令克隆仓库。
2. 运行 rake install 命令安装 gem。
3. 删除临时目录。

6. 兼容性

specific_install 版本 v0.2.10 已知与 Rubygems v2.2.2 兼容，但在 Rubygems v1.8.25 及更早版本中存在兼容性问题。可以通过升级 Rubygems 或安装较旧版本的 specific_install 来解决此问题。

7. 贡献指南

1. Fork 项目。
2. 创建新特性分支 (git checkout -b my-new-feature)。
3. 提交更改 (git commit -am 'Add some feature')。
4. 推送到分支 (git push origin my-new-feature)。
5. 创建新的 Pull Request。

希望你能享受使用 Gem::SpecificInstall！

---

版权声明：

Copyright 2010-2014 Roger Pack - http://github.com/rdp/specific_install