.svg?alt=media&token=513ac089-9c01-4b4a-879b-787e8c4b236a)
4.5 to 4.6
This guide covers upgrading a 4.5 Spree application to Spree 4.6.
If you're on an older version than 4.5 please follow previous upgrade guides and perform those upgrades incrementally, e.g.
This is the safest and recommended method.
gem 'spree', '>= 4.6.0'
Update all other spree gems used in your application to 4.6.0 or version compatible with 4.6:
gem 'spree_sample', '~> 4.6.0'
gem 'spree_emails', '~> 4.6.0'
gem 'spree_frontend', '>= 4.6.0'
gem 'spree_backend', '>= 4.6.0'
gem 'spree_gateway', '~> 3.10'
gem 'spree_auth_devise', '>= 4.5.0'
gem 'spree_i18n', '~> 5.1'
If your application used the spree_globalize extension, you can remove it from your Gemfile, as translations are now supported out-of-the-box with the Mobility gem.
We've configured Mobility to use a strategy that uses a separate table to store translations, just like how spree_globalize did. This means, you won't need to make any changes to the database structure or migrate data.
During the upgrade process, you may need to review your custom queries that rely on translations, as there are minor differences in how Mobility handles them. Spree 4.6 includes a few built-in concerns to make it easier to work with translatable models.
bundle update
bin/rake railties:install:migrations
bin/rails db:migrate
Note: If you didn't use spree_globalize before, this will install migrations that move some columns from spree_products, spree_taxons, to dedicated translation tables -> spree_products_translations, spree_taxons_translations etc.
If you're using raw SQL queries (either in the application code, or running in external tools), you may need to review the new structure and update your queries accordingly.
If using Spree Frontend, run the following additional commands to get everything set up correctly with the updated gems:
bin/rails javascript:install:esbuild
bin/rails turbo:install
bin/rails g spree:frontend:install
yarn build
And that's a wrap!
🎉
For information about changes contained within this release, please read the Spree 4.6.0 Release Notes.
If you have any questions, issues or suggestions feel free to reach out through Spree slack channels.
Last modified 3mo ago