编辑“Spree Commerce/安装”

== 安装之前 ==
在安装'''Spree Commerce'''之前，我们需要稍微了解一下[[Ruby]]语言、[[RoR]],以及用于对 Rails 组件进行打包的 Ruby 打包系统[[RubyGems]]，并且需要安装Rails。
== 安装 ==
*'''安装Rails'''
在大多数情况下，安装Rails最容易的方法便是借助于RubyGems：

 $ gem install rails

*'''安装Bundler'''
Bundler是目前标准的用于管理维护Rails依赖的RubyGems，所以在安装spree之前，也需要了解它的用法：

 $ gem install bundler

*'''安装Spree'''
Spree作为一个RubyGem的分布式，本身是非常轻巧的，因此经常被称为“core gems”，如果你已经按上述步骤安装了Bundler的话，此时你并不需要做什么，Bundler会为你解决一切的，但是如果你没有，则需要手工键入下面命令：

 $ gem install spree

*'''安装Image Magick'''
Spree需要用到Image Magick Libray工具来处理产品图片，并且利用它来生成产品图片的缩略图。Image Magick的安装可能稍微有点棘手，在安装之前我们可以借助网上提供安装步骤信息。
== 创建一个新的Spree项目 ==
Spree的分布性使得它可以被用在一个新的Rails项目里或者被加入到一个已经存在的Rails项目里，下面的步骤是假设你创建一个全新的的商城：
*'''新建一个Rails程序'''
 命令：rails new mystore

用这个命令新建的程序使用的都是默认选项，包括用的数据库是Sqlite3，如果你想在一个不同的数据库里新建程序的话，例如Mysql，可以使用命令：

 rails new mystore -d mysql

其中你可以选择的数据库有：mysql，oracle，postgreSQL，sqlite3，frontbase，ibm_db
*'''在新建的Rails 程序里添加Spree'''
在你新建好rails程序后，切换到它的文件夹:
 $ cd mystore
编辑Gemfile文件，即添加：gem 'spree'。如果你还想将Spree的具体版本信息也添加进去的话，则添加：gem 'spree','版本信息'
*'''安装相关的服务'''
这些相关的服务应该在一个具体命令里被详细说明，经常详细说明Spree，通过在gemfile后面添加上spree-extensions信息，如下图所示：

[[image:spree1.png]]

上面操作完成后，就可以进行相关服务的安装了，如果你没有合适的spree gem或者是数据库驱动的话，Bundler将会帮你安装,命令是：

 $ bundle install
*'''数据库配置'''
每一个rails程序都会与一个数据库组合使用，将会用到的数据库信息一般都会在config/database.yml里详细说明。文件主要包含三个不同环境的信息，在这三个不同环境里Rails都会默认运行。这三个不同的环境是:

development环境：是在你的电脑上用来让你手工编写调试程序用地

test环境：用来做程序的自动测试的

production环境：让你用来配置你的程序使得它可以被外界访问

下面是sqlite3的默认development环境配置信息，是可以更改的：

[[image:spree2.png]]

一旦你配置完你的数据信息后，请运行命令：
 rake db:create
*'''安装Migrations 和其他的Assets'''
Spree是作为一个Rails引擎出名，因为Rails3.0的Rails引擎不能够自动的复制Migrations和Assets到你的Rails程序里，所以在你已经将Spree gem添加至Gemfile后，你就可以通过下面命令手动复制：

 rails g spree:site

 rake spree:install

Spree会自带一些示例数据（产品、订单之类的），如果你不想将Migrations和assets预期联系在一起的话可以再运行一条命令：

rake spree_sample install
*'''入住数据库'''
在上述步骤都操作成功后，就可以将Spree装入数据库了，运行命令：

 $ rake db:bootstrap

如果你想创建之后登录用的管理员信息的话，请运行下图所示的命令，当然如果你跳过这些命令，那么Spree的管理员角色将自动复制给你之后使用spree时创建的第一个用户：

[[image:spree3.png]]

*'''运行Spree'''
在运行之前，你需要在的开发机器上启动网络服务器，运行命令：

 $ rails server  或者 $ rails s

现在，你可以打开你的浏览器输入地址：http://localhost：3000， 你将会看到Spree的首页：

[[image:spree4.png]]

如果你想登录到后台管理面板，请输入地址：http://localhost:3000/admin， 打开的页面如下，如果之前并没有新建管理员账号的话，则可使用默认账号：spree@example.com,密码是spree123

[[image:spree5.png]]
== 参考来源 ==
http://www.spreecommerce.com/

[[category:Spree Commerce]]