如何将Spree电商平台从3.7平稳升级到4.0：完整操作指南

【免费下载链接】spree An open source eCommerce platform giving you full control and customizability. Modular and API-first. Build any eCommerce solution that your business requires. 项目地址: https://gitcode.com/GitHub_Trending/sp/spree

Spree是一款开源电商平台，提供完全的控制和自定义能力，采用模块化和API优先的设计理念，可满足各种电商业务需求。本文将详细介绍如何将Spree从3.7版本顺利升级到4.0版本，帮助你充分利用新版本带来的强大功能。


升级前的准备工作

在开始升级之前，请确保你的应用已经是Spree 3.7版本。如果不是，请先按照以下顺序逐步升级：

1. 升级3.4到3.5
2. 升级3.5到3.6
3. 升级3.6到3.7

同时，建议在升级前备份你的数据库和代码，以防出现意外情况。

步骤一：更新Ruby版本

Spree 4.0要求Ruby 2.5或更高版本。你需要更新项目中的Gemfile和.ruby-version文件，并安装相应的Ruby版本。如果使用RVM，可以执行以下命令：

rvm install 2.5
rvm use 2.5

步骤二：迁移到ActiveStorage

Spree 4.0已移除对Paperclip的支持，全面转向ActiveStorage。请按照以下步骤进行迁移：

1. 移除代码中所有Rails.application.config.use_paperclip和Configuration::Paperclip的引用。
2. 遵循官方Paperclip到ActiveStorage迁移指南进行数据迁移。

步骤三：移除spree_address_book扩展

Spree 4.0已将地址簿功能整合到核心中，因此需要移除spree_address_book扩展：

1. 从Gemfile中移除相关引用：

   bundle remove spree_address_book
   

2. 从vendor/assets/javascripts/spree/frontend/all.js中移除：

   //= require spree/frontend/spree_address_book
   

3. 从vendor/assets/stylesheets/spree/frontend/all.css中移除：

   //= require spree/frontend/spree_address_book
   

步骤四：更新Gemfile

修改Gemfile中的Spree相关 gems：

gem 'spree', '~> 4.0'
gem 'spree_auth_devise', '~> 4.0'
gem 'spree_gateway', '~> 3.6'

然后运行：

bundle update

步骤五：更新代码装饰器

如果使用Rails 6，需要将class_eval替换为Module.prepend。例如：

旧语法：

Spree::Order.class_eval do
  has_many :new_custom_model

  def some_method
     # ...
  end
end

新语法：

module Spree
  module OrderDecorator
    def self.prepended(base)
      base.has_many :new_custom_model
    end

    def some_method
      # ...
    end
  end

  Order.prepend(OrderDecorator)
end

步骤六：Bootstrap版本选择

Spree 4.0默认使用Bootstrap 4，你有两种选择：

继续使用Bootstrap 3

1. 复制视图文件：

   bundle exec spree:frontend:copy_views
   

2. 在Gemfile中添加：

   gem 'bootstrap-sass', '~> 3.4.1'
   

迁移到Bootstrap 4

请参考官方Bootstrap 3到4迁移指南。

步骤七：运行迁移

安装并运行数据库迁移：

rake railties:install:migrations
rails db:migrate

步骤八：验证升级结果

升级完成后，启动服务器并登录管理面板验证是否正常工作。

登录后，检查仪表盘和各项功能是否正常运行：

了解更多新功能

升级完成后，建议阅读4.0.0发布说明，了解新版本带来的所有新功能和改进。

通过以上步骤，你已经成功将Spree电商平台从3.7升级到4.0版本。如果在升级过程中遇到任何问题，可以查阅官方文档或寻求社区支持。

【免费下载链接】spree An open source eCommerce platform giving you full control and customizability. Modular and API-first. Build any eCommerce solution that your business requires. 项目地址: https://gitcode.com/GitHub_Trending/sp/spree