初めての Ruby gem を作成して公開する
このチュートリアルでは、RubyMine でシンプルな Ruby gem を作成し、RubyGems.org に公開する方法を紹介します。
始める前に:
Git(英語) をインストールします。
RubyMine で GitHub アカウントを 登録します。
プラットフォームに Ruby ディストリビューションをインストールします。
Gem アプリケーションを作成する
新しい Gem アプリケーションを作成するには、次の手順に従います。
RubyMine を実行し、 ウェルカム画面で 新規プロジェクト をクリックします。
新規プロジェクト ダイアログで、左側のペインで Gem を選択し、次の設定を指定します。
ロケーション: プロジェクトの場所と名前を指定します（この例では hello_rubymine）。
インタープリター: 必要な Ruby インタープリターを選択します。
すべてのオプションを指定したら、 新規プロジェクト ダイアログで 作成 をクリックします。 RubyMine が新しい Gem アプリケーションを作成します。
コードを追加
gems のコードは、 lib ディレクトリ内に配置されます。 新しく作成したプロジェクトには、このフォルダーに hello_rubymine.rb ファイルが含まれています。 gem の作業コードを追加しましょう。
hello_rubymine.rb を開くには、 Ctrl+Shift+N を押し、 hello_rubymine.rb の入力を開始し、このファイルを選択して、 Enter を押します。
開いた lib/hello_rubymine.rb ファイルに、次のコードを追加します。
require "hello_rubymine/version" module HelloRubymine def self.greet(name) puts "Hello, #{name}! I'm Ruby!" end end
gem 仕様を提供する
すべての gem プロジェクトには、gem の情報を含む *.gemspec ファイルがあります。 私たちのプロジェクトでは、この情報は hello_rubymine.gemspec ファイルに保存されています。 次の手順を実行して、必要なデータを提供します。
Ctrl+Shift+N を押し、 hello_rubymine.gemspec の入力を開始し、 hello_rubymine.gemspec ファイルを選択して、 Enter を押します。
開いた hello_rubymine.gemspec ファイルで、必要な gemspec 属性(英語)を指定します。
サンプル gem については、以下のフィールドを指定してください。
authors: gem の作成者。メール: メールアドレス。summary: 短い gem の説明homepage: gem のホームページの URL。 後で gem のコードを GitHub に公開する後にこのアドレスを指定します。metadata["source_code_uri"]: gem のソースコード URI。homepageと同じ値を使用します。
gem を GitHub でシェア
このセクションでは、gem のソースコードを GitHub に公開します。
に進みます。
呼び出されたダイアログで、GitHub で作成するリポジトリの名前を指定します。 次に、 共有する フィールドで必要なアカウントを選択し、 共有 ボタンをクリックします。
次のダイアログでは、最初のコミットに使用するファイルを選択するよう求められます。 デフォルトのファイルセットのままにして、コミットメッセージを指定し、「追加 」をクリックしてください。 プロジェクトが「GitHub」にプッシュされるまでお待ちください。
GitHub にプロジェクトを作成したら、プロジェクトの *.gemspec ファイル (この場合は https://github.com/rubyminedoc/hello_rubymine ) に
homepage属性とmetadata["source_code_uri"]属性を 指定します。 次に、 *.gemspec で行った変更を コミットしてプッシュします。
ビルド gem
*.gemspec ファイルに gem の情報を指定したら、gem をビルドします。
ターミナルを開き、プロジェクトのルートディレクトリで以下のコマンドを実行してください。
gem build hello_rubymine.gemspecコマンドが完了すると、プロジェクトディレクトリに
.gemファイルが作成されます。
gem をインストールする
gem を ビルドした後、テストのために ローカルインタープリターにインストールできます。
Ctrl を 2 回押して、次のコマンドを入力します。
gem install hello_rubymineEnter を押して、gem をインストールします。
IRB で gem をテストする
この章では、 IRB コンソールを使用して、 greet メソッドを呼び出して gem をテストします。
メインメニューで へ移動します。
require 'hello_rubymine'と入力し、 Enter を押して gem を IRB にロードします。次に、コンソールで
HelloRubymine.greet("JetBrains")と入力し、もう一度 Enter を押して gem が正しく動作することを確認します。
gem を公開
RubyGems のアカウントをお持ちで、認証情報が正しく設定されていることを確認してください。
次のコマンドを実行してください：
gem push hello_rubymine-0.1.0.gemコマンドが完了すると、gem が RubyGems に公開されます。