3.1 创建演示应用

和第 2 章一样，我们要先创建一个新 Rails 项目，名为 sample_app，如代码清单 3.1 所示：[1]

代码清单 3.1：创建一个新应用

$ cd ~/workspace
$ rails _4.2.2_ new sample_app
$ cd sample_app/

（和 2.1 节一样，如果使用云端 IDE，可以在同一个工作空间中创建这个应用，没必要再新建一个工作空间。）

类似 2.1 节，接下来我们要用文本编辑器打开并编辑 Gemfile，写入应用所需的 gem。代码清单 3.2 与代码清单 1.5 和代码清单 2.1 一样，不过 test 组中的 gem 有所不同，稍后会做进一步设置（3.7 节）。注意，如果现在你想安装这个应用使用的所有 gem，要写入代码清单 11.66 中的内容。

代码清单 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]不安装生产环境使用的 gem：

$ bundle install --without production

运行这个命令后不会在开发环境中安装 PostgreSQL 所需的 pg gem，在生产环境和测试环境中我们使用 SQLite。Heroku 极力不建议在开发环境和生产环境中使用不同的数据库，但是对这个演示应用来说这两种数据库没什么差别，而且在本地安装配置 SQLite 比 PostgreSQL 容易得多。[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 中的内容。

代码清单 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 节，我们使用 git commit -a -m "Message" 命令，指定了“全部变化”的旗标 -a 和提交信息旗标 -m。如上面这个命令所示，我们可以把两个旗标合在一起，变成 git commit -am "Message"。

既然本书后续内容会一直使用这个演示应用，那么最好在 Bitbucket 中新建一个仓库，把这个应用推送上去：

$ git remote add origin [email protected]:<username>/sample_app.git
$ git push -u origin --all # 首次推送这个应用

为了避免以后遇到焦头烂额的问题，在这个早期阶段也可以把应用部署到 Heroku 中。参照第 1 章和第 2 章，我建议使用代码清单 1.8 和代码清单 1.9 中的代码，创建一个显示“hello, world!”的首页。然后提交改动，再推送到 Heroku 中：

$ git commit -am "Add hello"
$ heroku create
$ git push heroku master

（和 1.5 节一样，你可能会看到一些警告消息，现在暂且不管，7.5 节会解决。）除了 Heroku 为应用分配的地址之外，看到的页面应该和图 1.18 一样。注意：有些读者反馈说，遇到了与 spring gem 有关的问题，你可以在命令行中执行 spring binstub 命令，看能不能解决。

在阅读本书的过程中，我建议你定期推送和部署，这样不仅能在远程仓库中备份，而且还能尽早发现在生产环境中可能出现的问题。如果遇到和 Heroku 有关的问题，可以查看生产环境中的日志，试着找出问题所在：

$ heroku logs

注意，如果你决定把真实的应用放到 Heroku 中，一定要按照 7.5 节介绍的方法配置 Unicorn。