# 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。