3.1 to 3.2
This guide covers upgrading a 3.1.x Spree store, to a 3.2.x store.

Update your Rails version to 5.0

Please follow the official Rails guide to upgrade your store.

Update Gemfile

1
gem 'spree', '~> 3.2.0'
2
gem 'spree_auth_devise', '~> 3.2.0'
3
gem 'spree_gateway', '~> 3.2.0'
Copied!

Update your extensions

We're changing how extensions dependencies work. Previously you had to match the extension branch to the Spree branch. Starting from now master branch of all spree-contrib extensions should work with Spree >= 3.1 and < 4.0. Please change your extensions in Gemfile eg.:
from:
1
gem 'spree_braintree_vzero', github: 'spree-contrib/spree_braintree_vzero', branch: '3-1-stable'
Copied!
to:
1
gem 'spree_braintree_vzero', github: 'spree-contrib/spree_braintree_vzero'
Copied!

Run bundle update

Install missing migrations

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

Run migrations

1
rails db:migrate
Copied!

Read the release notes

For information about changes contained within this release, please read the 3.2.0 Release Notes.

Verify that everything is OK

Run your test suite, click around in your store and make sure it's performing as normal. Fix any deprecation warnings you see.
Last modified 2mo ago