bundler 管理 Ruby Gem 小技巧

在 Ruby 项目中，特别是 Rails 项目，使用 bundler管理 Gem 时，有一些 Gem 需要用到系统库。例如 Rails 项目中默认需要的 Nokogiri 在 bundle install 时好多人遇到这样的错误:

ERROR: cannot discover where libxml2 is located on your system. please make sure pkg-config is installed.

还可以看 Github 上相关的 issue
还有一个例子就是 mysql2 也需要用到系统脚本,请看其 Readme

Mac OS X You may use MacPorts, Homebrew, or a native MySQL installer package. The most common paths will be automatically searched. If you want to select a specific MySQL directory, use the --with-mysql-dir or --with-mysql-config options above.

还有 bundle install 时比较常见的错误就是 libv8 的安装，Readme 给出的安装方法是:

Using RubyGems:
gem install libv8 -- --with-system-v8
Using Bundler (in your Gemfile):
bundle config build.libv8 --with-system-v8

事实上，好多 Gem 在 build gem native extension 都会用到系统库。
当把这些需要依赖系统其他库的 Gem 使用 Rubygem 时可直接在后面加上 -- --with xxxx 但是我们使用 bundler 管理 Gem 时，就需要在 bundle install 之前之行相应的 bundle config build.xxx ，那么，是否有一种方式我们直接把这些需要在 bundle install 之前的命令写在一个配置文件里面，然后我们直接 bundle install 呢？
答案是有的。
事实上，如果你执行了 bundle config build.xxx命令之后，~/.bundle/config(~ 表示当前用户目录)会填充一些内容，比如我们执行 :

bundle config build.libv8 --with-system-v8

该文件就会追加一行内容:BUNDLE_BUILD__LIBV8: "--with-system-v8"
其实我们也可以为 Bundler 管理的 Ruby 项目添加这样的特性，譬如:
在 Rails 项目根目录下新建 .bundle文件夹，并且新建 config文件，以后这个项目 bundle 的一些设置就可以写在 config 文件中了。来看看一个模版:

---
BUNDLE_PATH: vendor/bundle
BUNDLE_WITHOUT: test:postgres
BUNDLE_DISABLE_SHARED_GEMS: true
BUNDLE_BUILD__NOKOGIRI: "--use-system-libraries --with-xml2-include=/usr/include/libxml2/"
BUNDLE_BUILD__MYSQL: "--with-mysql-config=/usr/local/bin/mysql_config"
BUNDLE_BUILD__THERUBYRACER: "--with-system-v8"

BUNDLE_PATH: vendor/bundle 表示 bundle install 的 gem 全部在 vendor/bundle/ 目录下，而不是在 $GEM_HOME 或者 $BUNDLE_PATH 目录下；然后其他的就是一些依赖系统库的配置。
更多关于 bundler 配置的文档，请看 bundle config
另外再推荐一篇文章：Configuring bundler using bundle config