Rails 雑感

Ruby on Rails 3.2 を Mac OS X にインストールする手順をかなり丁寧に説明してみました

先日掲載したRuby on Rails 3.1 を Windows にインストールする手順をかなり丁寧に説明してみましたのMac OS Xバージョンです。

Mac OS Xで初めてRubyやRailsに挑戦する方のために、最新の Ruby 1.9.3 と Ruby on Rails 3.2 のインストール手順をやや詳しく説明します。

なお、本稿ではRubyのインストールにHomebrewとrbenvを利用しています。MacPortsによるインストール手順を知りたい方は http://ref.xaio.jp/ruby/install/macosx を参照してください。

本稿が対象とする OS は Mac OS X 10.7 (Lion) と Mac OS X 10.6 (Snow Leopard) です。「手順通りやったけどうまく行かなかった！」という方は、Mac OS の種類を明記の上、hermes_at_oiax_dot_jp までメールでお問い合わせください。また、「いちおうインストールできたけど、微妙に説明通りではなかった」という経験をした方も同アドレスまで情報をお寄せいただけると助かります。

この文章の内容は、随時更新しています。最終更新日: 2012/05/08

Xcode のインストール

  • Mac OS X 10.7 (Lion) の場合
    • メニューバー左端の「アップルメニュー」から「App Store」を選択します。
    • App Store ウィンドウの右上にある検索ボックスを使って「xcode」を検索します。
    • 「Xcode」をクリックし、次のページで「無料」ボタンをクリックして Xcode をインストールします。
  • Mac OS X 10.6 (Snow Leopard) の場合
    • ブラウザで http://developer.apple.com/jp/ を開きます。
    • 「Mac Dev Center」をクリックします。ここから先は英語です。
    • Apple IDを持っている場合は、「Log in」ボタンをクリックしてログインします。ヒント: Apple IDは多分、あなたのメールアドレスです。
    • Apple IDを持っていない場合は、画面右上の「Register」をクリックします。次のページで「Get Started」をクリックしてラジオボタン「Create an Apple ID」を選択して、「Continue」ボタンをクリックします。以下、氏名、住所、電話番号など様々な質問項目に答えて、Apple IDの登録を完了します。
    • Mac Dev Centerにログインし、「Xcode 3.2.6 and iOS SDK 4.3」リンクをクリックしてインストールします。注意: インストールファイルは4GB以上あります。時間に余裕のあるときに行いましょう。

Homebrew のインストール

  • Finderで「アプリケーション」→「ユーティリティ」と進んで、「ターミナル」を開きます。
  • ターミナルで次のコマンドを実行します。
> /usr/bin/ruby -e "$(/usr/bin/curl -fksSL https://raw.github.com/mxcl/homebrew/master/Library/Contributions/install_homebrew.rb)"

コマンドの先頭にある > の文字は入力しないでください。これ以降の手順でも同じです。

RVM の除去

あなたのMacにRVMがインストールされている場合は、除去します。

> rvm implode

本稿ではRuby環境の管理にrbenvを使用します。RVMとは共存できません。

rbenv と ruby-build のインストール

  • Finderで「アプリケーション」→「ユーティリティ」と進んで、「ターミナル」を開きます。
  • ターミナルで以下のコマンドを順に実行します。
> brew install rbenv
> brew install ruby-build
> echo 'eval "$(rbenv init -)"' >> ~/.bashrc
> source ~/.bashrc

brew の前に sudo を付ける必要はありません。ZSHをお使いの方は、最終行の .bashrc を .zshrc で置き換えてください。

readline のインストール

  • ターミナルで以下のコマンドを順に実行します。
> brew install readline
> brew link readline

ruby のインストール

  • ターミナルで次のコマンドを実行します。
> CONFIGURE_OPTS="--with-readline-dir=/usr/local" rbenv install 1.9.3-p194
> rbenv rehash
> rbenv global 1.9.3-p194

2012年5月9日におけるRubyの最新版1.9.3p194をインストールしています。

  • rbenvの設定を確認します。
> rbenv version

1.9.3-p194 に始まる文字列が表示されることを確認してください。

  • ターミナルでrubyのバージョンを確認します。
> ruby -v

ruby 1.9.3p194 に始まる文字が現れることを確認してください。

.gemrc の作成

  • エディタで ~/.gemrc を次のような内容で作成します。
install: --no-ri --no-rdoc
update: --no-ri --no-rdoc

Ruby on Rails 3.2 のインストール

  • ターミナルで、次のコマンドを実行します。
> gem install rails
> rbenv rehash

作業フォルダの作成

  • ターミナルで、以下のコマンドを順に実行します。途中で現れる work は作業フォルダの名前です。好きな名前で置き換えてください。
> cd
> mkdir work

動作確認用の新規アプリケーションの作成

  • ターミナルで、以下のコマンドを順に実行します。途中で現れる foo は動作確認用に作成するアプリケーションの名前です。好きな名前で置き換えてください。
> cd work
> rails new foo --skip-bundle
> cd foo

依存パッケージのインストール

  • ターミナルで、以下のコマンドを順に実行します。
> bundle install

かなり時間がかかるかもしれません。気長に待ちましょう。

簡単なユーザー管理機能の作成

  • ターミナルで、以下のコマンドを順に実行します。
> rails g scaffold user name:string email:string
> rake db:migrate

アプリケーションの起動

  • ターミナルで、次のコマンドを実行します。
> rails s

動作確認

  • ブラウザで http://localhost:3000/users を開きます。
  • 「Listing users」という見出しを持つページが表示されます。
  • 「New User」リンクをクリックします。
  • 「Name」欄にあなたの名前、「Email」欄にあなたのメールアドレスを入力し、「Create User」ボタンをクリックします。
  • ページの上部に「User was successfully created.」と表示されれば OK です。

[更新] OS X のパッケージ管理システムを MacPorts から Homebrew に変更しました。(2011/08/07)

[更新] Xcode のインストール手順をLionとSnow Leopardで分けました。また、分かりにくい表現をいくつか改めました。(2011/08/28)

[更新] Rails 3.1.0の正式リリースに合わせて、微修正しました。また、「Rakeの更新」を追加し、uninitialized constant Rake::DSL というエラーへの対処法を削除しました。(2011/09/01)

[更新] https://github.com/mxcl/homebrew/wiki/installationを参考にHomebrewをインストールするためのコマンドを更新しました。またタイトルおよび本文中の「Rails 3.1」を「Rails 3.2」と改めました。(2012/03/29)

[更新] MacPortsによるRubyのインストール手順を説明している http://ref.xaio.jp/ruby/install/macosx へのリンクを追加しました。(2012/04/02)

[更新] Rubyのバージョン番号を確認する手順と環境変数PATHに関する囲み記事を追加しました。また、Mac OS X 10.7 (Lion) の場合でもHomebrewで最新版のRubyをインストールするように手順を変更しました。(2012/04/13)

[更新] Rubyのインストールにrbenvを使用するため、大幅に書き換えました。How to setup Mac OS X Lion for ruby and rails development と Mac OS X(Lion)にRuby on Rails 3.2の開発環境を構築する を参考にしています。(2012/04/22)

[更新] .bash_profile を .bashrc に、.zsh_env を .zshrc に変更しました。(2012/05/02)

[更新] Railsをインストールした直後にrbenv rehashコマンドを実行する手順を追加しました。(2012/05/09)

[更新] Rubyをインストールした直後にrbenv versionコマンドで設定を確認する手順を追加しました。(2012/05/09)

（2011/08/07）

記事に関するご質問は、 hermes@oiax.jp までメールでお送りください。

ウェブサイト構築の発注先を検討されているお客様は、ご相談フォームをご利用ください。