3.6 to 3.7
This guide covers upgrading a 3.6 Spree application, to version 3.7.

Update Gemfile

1
gem 'spree', '~> 3.7.0'
2
gem 'spree_auth_devise', '~> 3.5'
3
gem 'spree_gateway', '~> 3.4'
Copied!

Run bundle update

Install missing migrations

1
rails spree:install:migrations
2
rails spree_api:install:migrations
3
rails spree_auth:install:migrations
4
rails spree_gateway:install:migrations
Copied!

Run migrations

1
rails db:migrate
Copied!

Migrate Taxon icons to Spree Assets

We renamed TaxonIcon to TaxonImage to clarify usage of this model. If you were using TaxonIcon please run this to migrate your icons to images:
1
rails db:migrate_taxon_icons_to_images
Copied!

Ensure all Orders associated to Store

Orders needs to be associated to Stores. To ensure all existing Order are associated with Store please run this:
1
rails db:associate_orders_with_store
Copied!
This will associate all Orders without Store to the default Store. This can take some time depending on your volume of data.

Ensure all Orders have currency present

To enhance multi currency capabilities we've made currency presence obligatory in Order model. To ensure all existing Orders have currency present please run this command:
1
rails db:ensure_order_currency_presence
Copied!
This will set currency in Orders without currency set to Spree::Config[:default_currency] value. This can take some time depending on your volume of data.

Replace guest_token with token in your codebase

Order#guest_token was renamed to Order#token in order to unify the experience for guest checkouts and orders placed by signed in users.

Read the release notes

For information about changes contained within this release, please read the 3.7.0 Release Notes.
Last modified 2mo ago