3.1 創建演示應用 · Ruby on Rails 教程

# 3.1 創建演示應用和[第 2 章](chapter2.html#a-toy-app)一樣，我們要先創建一個新 Rails 項目，名為 `sample_app`，如[代碼清單 3.1](#listing-rails-new-sample-app) 所示：[[1](#fn-1)] ##### 代碼清單 3.1：創建一個新應用 ``` $ cd ~/workspace $ rails _4.2.2_ new sample_app $ cd sample_app/ ``` （和 [2.1 節](chapter2.html#planning-the-application)一樣，如果使用云端 IDE，可以在同一個工作空間中創建這個應用，沒必要再新建一個工作空間。）類似 [2.1 節](chapter2.html#planning-the-application)，接下來我們要用文本編輯器打開并編輯 `Gemfile`，寫入應用所需的 gem。[代碼清單 3.2](#listing-gemfile-sample-app) 與[代碼清單 1.5](chapter1.html#listing-gemfile-sqlite-version) 和[代碼清單 2.1](chapter2.html#listing-demo-gemfile-sqlite-version-redux) 一樣，不過 `test` 組中的 gem 有所不同，稍后會做進一步設置（[3.7 節](#advanced-testing-setup)）。注意，如果現在你想安裝這個應用使用的所有 gem，要寫入[代碼清單 11.66](chapter11.html#listing-final-gemfile) 中的內容。 ##### 代碼清單 3.2：演示應用的 `Gemfile` ``` source 'https://rubygems.org' gem 'rails', '4.2.2' gem 'sass-rails', '5.0.2' gem 'uglifier', '2.5.3' gem 'coffee-rails', '4.1.0' gem 'jquery-rails', '4.0.3' gem 'turbolinks', '2.3.0' gem 'jbuilder', '2.2.3' gem 'sdoc', '0.4.0', group: :doc group :development, :test do gem 'sqlite3', '1.3.9' gem 'byebug', '3.4.0' gem 'web-console', '2.0.0.beta3' gem 'spring', '1.1.3' end group :test do gem 'minitest-reporters', '1.0.5' gem 'mini_backtrace', '0.1.3' gem 'guard-minitest', '2.3.1' end group :production do gem 'pg', '0.17.1' gem 'rails_12factor', '0.0.2' end ``` 和前兩章一樣，我們要執行 `bundle install` 命令安裝并導入 `Gemfile` 中指定的 gem，而且指定 `--without production` 選項，[[2](#fn-2)]不安裝生產環境使用的 gem： ``` $ bundle install --without production ``` 運行這個命令后不會在開發環境中安裝 PostgreSQL 所需的 `pg` gem，在生產環境和測試環境中我們使用 SQLite。Heroku 極力不建議在開發環境和生產環境中使用不同的數據庫，但是對這個演示應用來說這兩種數據庫沒什么差別，而且在本地安裝配置 SQLite 比 PostgreSQL 容易得多。[[3](#fn-3)]如果你之前安裝了某個 gem（例如 Rails 本身）的其他版本，和 `Gemfile` 中指定的版本號不同，最好再執行 `bundle update` 命令，更新 gem，確保安裝的版本和指定的一致： ``` $ bundle update ``` 最后，我們還要初始化 Git 倉庫： ``` $ git init $ git add -A $ git commit -m "Initialize repository" ``` 和第一個應用一樣，我建議你更新一下 `README` 文件（在應用的根目錄中），更好的描述這個應用。我們先把這個文件的格式從 RDoc 改為 Markdown： ``` $ git mv README.rdoc README.md ``` 然后寫入[代碼清單 3.3](#listing-sample-app-readme) 中的內容。 ##### 代碼清單 3.3：修改演示應用的 `README` 文件 ``` # Ruby on Rails Tutorial: sample application This is the sample application for the [*Ruby on Rails Tutorial: Learn Web Development with Rails*](http://www.railstutorial.org/) by [Michael Hartl](http://www.michaelhartl.com/). ``` 最后，提交這次改動： ``` $ git commit -am "Improve the README" ``` 你可能還記得，在 [1.4.4 節](chapter1.html#branch-edit-commit-merge)，我們使用 `git commit -a -m "Message"` 命令，指定了“全部變化”的旗標 `-a` 和提交信息旗標 `-m`。如上面這個命令所示，我們可以把兩個旗標合在一起，變成 `git commit -am "Message"`。既然本書后續內容會一直使用這個演示應用，那么最好[在 Bitbucket 中新建一個倉庫](https://bitbucket.org/repo/create)，把這個應用推送上去： ``` $ git remote add origin git@bitbucket.org:<username>/sample_app.git $ git push -u origin --all # 首次推送這個應用 ``` 為了避免以后遇到焦頭爛額的問題，在這個早期階段也可以把應用部署到 Heroku 中。參照[第 1 章](chapter1.html#from-zero-to-deploy)和[第 2 章](chapter2.html#a-toy-app)，我建議使用[代碼清單 1.8](chapter1.html#listing-hello-action) 和[代碼清單 1.9](chapter1.html#listing-default-root-route) 中的代碼，創建一個顯示“hello, world!”的首頁。然后提交改動，再推送到 Heroku 中： ``` $ git commit -am "Add hello" $ heroku create $ git push heroku master ``` （和 [1.5 節](chapter1.html#deploying)一樣，你可能會看到一些警告消息，現在暫且不管，[7.5 節](chapter7.html#professional-grade-deployment)會解決。）除了 Heroku 為應用分配的地址之外，看到的頁面應該和[圖 1.18](chapter1.html#fig-heroku-app) 一樣。注意：有些讀者反饋說，遇到了與 spring gem 有關的問題，你可以在命令行中執行 `spring binstub` 命令，看能不能解決。在閱讀本書的過程中，我建議你定期推送和部署，這樣不僅能在遠程倉庫中備份，而且還能盡早發現在生產環境中可能出現的問題。如果遇到和 Heroku 有關的問題，可以查看生產環境中的日志，試著找出問題所在： ``` $ heroku logs ``` 注意，如果你決定把真實的應用放到 Heroku 中，一定要按照 [7.5 節](chapter7.html#professional-grade-deployment)介紹的方法配置 Unicorn。