Get SpatialOS

Sites

Menu

Upgrading to a new patch or minor version

SpatialOS only introduces breaking changes between major versions (for example, 11 to 12). There should be no breaking changes between patch versions (for example, 11.0.0 to 11.0.3) or minor versions (for example, 11.0 to 11.2).

The exception is experimental features and SDKs, which can have breaking changes more often.

How to upgrade

To upgrade your project to a new patch version:

  1. Open a terminal in the root directory of your project.
  2. Run spatial update.

    (This might not always be necessary, but it’s a good time to do it.)

  3. Run spatial worker clean.

  4. Open the spatialos.json file (in the root directory of your project).

  5. Replace the sdk_version value with the new version number (for example, 12.0.0).

  6. Replace all other instances of the version number in the file.

  7. Run spatial worker build.

  8. When it asks: You don't appear to have the SDK CLI downloaded for your current SDK version (x.x.x), would you like to download? [y/N], say y.

You’ve now upgraded to the new version. You may want to read the release notes to find out what is new.

Was this page helpful?

Thanks for letting us know!

Thanks for your feedback

Need more help? Ask on the forums