2012年3月7日水曜日

gem作成に関するメモ

はじめてgemパッケージを作るにあたってやったことのメモ。

1. GitHubにアカウントを作る。
さらにログイン後に見ることができるチュートリアル(http://help.github.com/mac-set-up-git/)して、自分のPCにgitをインストールし、sshとかの設定をする。

2. 以下のサイトを読んでjewelerのセットアップやプロジェクトの作成をする。
http://technicalpickles.com/posts/craft-the-perfect-gem-with-jeweler/

jewelerのインストール。

gem sources -a http://gems.github.com
sudo gem install technicalpickles-jeweler

以下の設定は1.で既に終わっているはず。

$ git config --global user.email johndoe@example.com
$ git config --global user.name 'John Doe'
$ git config --global github.user johndoe
$ git config --global github.token 55555555555555

その後の新規プロジェクトの作成のところは別のサイトも参照しつつ3.で。

3. 以下のサイトを読んで新規プロジェクトの作成。
http://jp.rubyist.net/magazine/?0037-CreateRailsPlugin

ここではプロジェクト名をrenkonとし、ローカルの置き場は~/project/renkonとしておく。projectフォルダを作ってそこに移動し、以下のようにする。

$ jeweler --create-repo renkon

--create-repoは何回やってもタイムアウトして失敗するけど、ときどき成功するのでよく分からんまま先に進む。--rspecはrspec 1.3ではなく2.0がインストールされているとrakeのときにいろいろエラーが出るようなのではしょる。

公開準備。まずバージョンファイルを作る。

$ rake version:write

なんか警告が出るので、無視しても問題ないと思うが、Rakefileの以下の部分を書き換えておいた方がいいかも。

#require 'rake/rdoctask'
require 'rdoc/task'

バージョンを上げる。

$ rake version:bump:minor

ビルドする。上記サイトの指示通り、先にRakefileのsummaryとdescriptionのところを書き換えておく。

$ rake build

公開する。

$ git add .
$ git commit -m "create new library."
$ git push origin master
$ rake release

4. プロジェクトの更新

lib/renkon.rb
lib/renkon/subfile1.rb

みたいな感じでプロジェクトを作って更新していくものと思われる。