4.3 to 4.4

1. upgrade 4.0 to 4.1
2. upgrade 4.1 to 4.2
3. upgrade 4.2 to 4.3 </Note>

Update Gems

Run the following command to update your gems to 4.4:

bundle update

to install the new gems.

Remove gems merged into Spree Core

These gems were merged into Spree Core in version 4.4. All of their functionality is now included in the spree gem so you can remove them.

(Optional) Remove Spree Digital

If you used that gem in the past you need to remove it. Digital products are now incorporated into Spree core and you cannot use that gem anymore.

1. Remove spree_digital from your Gemfile

(Optional) Remove Spree Wishlist

If you used that gem in the past you need to remove it. Wishlists are now incorporated into Spree core and you cannot use that gem anymore.

1. Remove spree_wishlist from your Gemfile
2. (Optional) Remove //= require spree/frontend/spree_wishlist from vendor/assets/javascripts/spree/frontend/all.js
3. (Optional) Remove *= require spree/frontend/spree_wishlist from vendor/assets/stylesheets/spree/frontend/all.css

Update gems

bundle update

Install missing migrations

bin/rake spree:install:migrations

Run migrations

bin/rails db:migrate

Run install generators

This will copy some files from spree_backend to your application.

bin/rails g spree:backend:install

If you're using spree_frontend you need to run the frontend install generator as well:

bin/rails g spree:frontend:install

Additional fixes and hints

Make sure that Node is available in your cloud environment

On Heroku, you need to add the node buildpack - https://devcenter.heroku.com/articles/buildpacks#using-multiple-buildpacks

Add Spree ActiveJob queues to your Sidekiq config

Spree uses ActiveJob for processing long running operations to not interrupt your web server performance.

If you're using Sidekiq you need to update your config/sidekiq.yml file and 2 new queues:

• spree_stock_location_stock_items
• spree_webhooks

Disabling webhooks

Spree 4.4 introduces webhook events for most of the Spree resources (Products, Orders, Customers, etc). If you wish to disable this globally you can set the environment variable:

DISABLE_SPREE_WEBHOOKS=true

If you would like to disable firing webhooks for certain elements of your application you can wrap these methods in a block:

Spree::Webhooks.disable_webhooks do
  ... run your code here ...
end

Webhooks do not fire on touch events. Webhooks also do not do anything until there is a first webhook subscriber created which can be done in the Admin Dashboard or via Platform API.

Update Spree Dependencies that was renamed

Please change in your codebase:

Spree::Dependencies.account_update_address_service

to

Spree::Dependencies.address_update_service

Read the release notes

For information about changes contained within this release, please read the CHANGELOG.

More info

If you have any questions or suggestions feel free join our Discord