3.1 创建演示应用
最后更新于：2022-04-01 22:28:10
# 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:/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。
';