3.2 to 3.3

Update your Rails version to 5.1

Spree 3.3 requires Rails 5.1 at a minimum. Please follow the official Rails guide to upgrade your application.

Update gems

bundle update

Install missing migrations

rake railties:install:migrations

Run migrations

rails db:migrate

Include UserMethods in your User class

With this release, we're not including this automatically. You need to do it manually if you're not using spree_auth_devise.

You need to include Spree::UserMethods in your user class, eg.

class User
  include UserAddress
  include UserMethods
  include UserPaymentSource
end

Update aws-sdk gem to >= 2.0

Spree 3.3 comes with paperclip 5.1 support so if you're using Amazon S3 storage you need to change in your Gemfile, from:

gem 'aws-sdk', '< 2.0'

to:

gem 'aws-sdk', '>= 2.0'

and run bundle update aws-sdk

In your paperclip configuration, you also need to specify s3_region attribute eg. https://github.com/spree/spree/blame/master/guides/content/developer/customization/s3_storage.md#L27

See also RubyThursday episode walkthrough of upgrading paperclip in your project.

Add jquery.validate to your project if you've used it directly from Spree

If your application.js file includes line //= require jquery.validate/jquery.validate.min you will need to add this file manually to your project because this library was removed from Spree in favor of native HTML5 validation.

Read the release notes

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