# 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。
- Ruby on Rails 教程
- 致中國讀者
- 序
- 致謝
- 作者譯者簡介
- 版權和代碼授權協議
- 第 1 章 從零開始,完成一次部署
- 1.1 簡介
- 1.2 搭建環境
- 1.3 第一個應用
- 1.4 使用 Git 做版本控制
- 1.5 部署
- 1.6 小結
- 1.7 練習
- 第 2 章 玩具應用
- 2.1 規劃應用
- 2.2 用戶資源
- 2.3 微博資源
- 2.4 小結
- 2.5 練習
- 第 3 章 基本靜態的頁面
- 3.1 創建演示應用
- 3.2 靜態頁面
- 3.3 開始測試
- 3.4 有點動態內容的頁面
- 3.5 小結
- 3.6 練習
- 3.7 高級測試技術
- 第 4 章 Rails 背后的 Ruby
- 4.1 導言
- 4.2 字符串和方法
- 4.3 其他數據類型
- 4.4 Ruby 類
- 4.5 小結
- 4.6 練習
- 第 5 章 完善布局
- 5.1 添加一些結構
- 5.2 Sass 和 Asset Pipeline
- 5.3 布局中的鏈接
- 5.4 用戶注冊:第一步
- 5.5 小結
- 5.6 練習
- 第 6 章 用戶模型
- 6.1 用戶模型
- 6.2 用戶數據驗證
- 6.3 添加安全密碼
- 6.4 小結
- 6.5 練習
- 第 7 章 注冊
- 7.1 顯示用戶的信息
- 7.2 注冊表單
- 7.3 注冊失敗
- 7.4 注冊成功
- 7.5 專業部署方案
- 7.6 小結
- 7.7 練習
- 第 8 章 登錄和退出
- 8.1 會話
- 8.2 登錄
- 8.3 退出
- 8.4 記住我
- 8.5 小結
- 8.6 練習
- 第 9 章 更新,顯示和刪除用戶
- 9.1 更新用戶
- 9.2 權限系統
- 9.3 列出所有用戶
- 9.4 刪除用戶
- 9.5 小結
- 9.6 練習
- 第 10 章 賬戶激活和密碼重設
- 10.1 賬戶激活
- 10.2 密碼重設
- 10.3 在生產環境中發送郵件
- 10.4 小結
- 10.5 練習
- 10.6 證明超時失效的比較算式
- 第 11 章 用戶的微博
- 11.1 微博模型
- 11.2 顯示微博
- 11.3 微博相關的操作
- 11.4 微博中的圖片
- 11.5 小結
- 11.6 練習
- 第 12 章 關注用戶
- 12.1 “關系”模型
- 12.2 關注用戶的網頁界面
- 12.3 動態流
- 12.4 小結
- 12.5 練習