Updating FSA Spartacus to Version 3.0

Note: Spartacus 4.x is no longer maintained. Please upgrade to the latest version.

Note: Spartacus 4.x was tested with SAP Commerce Cloud versions 1905 to 2205. Spartacus 4.x has not been verified to work with (and is not guaranteed to work with) SAP Commerce Cloud 2211 or later releases.

Prerequisites

Before upgrading your FSA Spartacus libraries to version 3.0, you must address the following prerequisites:

  • Upgrade all of your @spartacus libraries to Spartacus 3.4. Note that Spartacus 3.4 requires Angular version 10. If your Angular version is <10, you must update it before updating Spartacus. For more information, see Updating to Angular version 10.

Updating FSA Spartacus

  1. Go to the package.json at the root of your project and upgrade Spartacus libraries:

     "@spartacus/assets": "^3.4.0",
     "@spartacus/core": "^3.4.0",
     "@spartacus/storefinder": "^3.4.0",
     "@spartacus/styles": "^3.4.0",
    
  2. Add new dependencies from Spartacus:

     "@spartacus/storefront": "3.4.0",
     "@spartacus/organization": "3.4.0",
     "@spartacus/user": "3.4.0",
    
  3. Upgrade FSA Spartacus libraries:

      "@spartacus/fsa-schematics": "^3.0.0",
      "@spartacus/dynamicforms": "^3.0.0",
      "@spartacus/fsa-storefront": "^3.0.0",
      "@spartacus/fsa-styles": "^3.0.0",
    
  4. Add new FSA dependencies:

    "echarts": "^5.0.2",
    "ngx-echarts": "^6.0.1",
    
  5. To complete the update, run the following commands:

     yarn install
     yarn start
    

You have now successfully updated your FSA Spartacus app.