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.