Upgrade an Existing Project#

Objective#

Upgrade an existing project to use a newer version of the Simplicity Software Development Kit (SDK).

Step 1. Install the New SDK Version or Update the Packages#

slt update
slt installslt update
slt install

Install a Specific New SDK Version#

slt install simplicity-sdk/2025.12.3 --non-interactiveslt install simplicity-sdk/2025.12.3 --non-interactive

Verify Installation#

slt where simplicity-sdk/2025.12.3slt where simplicity-sdk/2025.12.3

Step 2. Upgrade the Project .slcp#

Use slc upgrade to update the project metadata to the new SDK version:

slc upgrade -p project.slcp \
  --sdk-package-path <new_sdk_location>,<extension_location>slc upgrade -p project.slcp \
  --sdk-package-path <new_sdk_location>,<extension_location>

Note: The slc upgrade command updates project metadata only. It does not regenerate the files in the autogen/ directory.

Step 3. Regenerate the Project#

Regenerate the project files to synchronize them with the new SDK version.

slc generate -p project.slcp \
  --sdk-package-path <new_sdk_location>,<extension_location>slc generate -p project.slcp \
  --sdk-package-path <new_sdk_location>,<extension_location>

Note: Running slc upgrade followed by slc generate performs an in-place project upgrade.

Step 4. Build the Project#

Build the upgraded project.

cmake --build buildcmake --build build

Summary: Upgrade Process#

1. Run slt install <new-sdk-version>.

2. Run slc upgrade -p project.slcp --sdk-package-path <new_sdk>,<extensions>.

3. Run slc generate -p project.slcp --sdk-package-path <new_sdk>,<extensions>.

Note:

1. Always run slc upgrade before slc generate when migrating to a new SDK version.

2. If the upgrade is canceled because manual steps are required, use --force-upgrade and follow the manual steps listed in the output.

3. The upgrade automatically creates .bak backup files for affected project files.