Upgrading Spree from 3.1.x to 3.2.x
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
gem 'spree', '~> 3.2.0'
gem 'spree_auth_devise', '~> 3.2.0'
gem 'spree_gateway', '~> 3.2.0'
Update your extensions
We’re changing how extensions dependencies work. Previously you had to match
extension branch to 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:
gem 'spree_braintree_vzero', github: 'spree-contrib/spree_braintree_vzero', branch: '3-1-stable'
to:
gem 'spree_braintree_vzero', github: 'spree-contrib/spree_braintree_vzero'
Run bundle update
Install missing migrations
rails spree:install:migrations
rails spree_auth:install:migrations
rails spree_gateway:install:migrations
Run migrations
rails db:migrate
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 you test suite, click around in your store and make sure it’s performing as normal. Fix any deprecation warnings you see.