Try SpatialOS

Sites

Menu
These are the docs for 12.2, an old version of SpatialOS. 13.2 is the newest →

SpatialOS release policies

SDK releases

Versioning

SDK releases are categorised as major, minor or patch using standard semantic versioning (major.minor.patch):

  • Major releases (for example: 11, 12) include new features and breaking changes for previously warned deprecations.

    For major releases, we provide an upgrade guide as well as release notes.

  • Minor releases (for example: 11.1, 12.1) include new features and no breaking changes.

    Minor releases don’t require an upgrade guide, but we provide release notes.

  • Patch releases (for example: 12.0.1, 12.0.2) contain only bug fixes and no breaking changes.

    Patch releases don’t require an upgrade guide. We typically provide release notes.

Support window

We support the most recent minor version of the most recent two major versions of SpatialOS (for example: 11.2 and 12.2).

This support includes:

  • Runnability

    For projects built using a minor version, we support deploying until the later of:

    • 9 months after the minor version’s release
    • 3 months after the subsequent minor release

    We will support the last minor version of supported major versions indefinitely.

  • Bug fixes

    We release bug fixes in patch releases on the most recent minor version of supported major versions.

  • Documentation

    We maintain and update documentation for the most recent minor version of supported major versions.

    Older versions of the documentation may stay on the documentation website, but are frozen: we do not correct, update or republish them.

Breaking changes and deprecations

Minor versions of SpatialOS are backwards compatible with previous minor versions of the same major version.

This means that: for game code written against Improbable’s public APIs on a given minor version, you’ll be able to update to all subsequent minor versions (of the same major version) without code changes. For example, moving from 12.1 to 12.2, 12.3, 12.4…

Breaking changes (that is, non-backwards-compatible changes) only occur in major versions. We provide any necessary upgrade instructions in the accompanying upgrade guide or in release notes.

To prepare users for these changes, we will (whenever possible) deprecate the API at least one minor or major version before making the breaking change. We’ll announce deprecations in the release notes and/or in compilation warnings.

Exceptions

Though we strive not to, we do reserve the right to make out-of-policy releases, deprecations, or breaking changes due to issues such as security risks, or fixes with exceptional technical burden.

spatial CLI releases

We release the spatial CLI separately from the SDKs. When a new spatial version is available, you’ll see a message in the CLI saying that you can run spatial update to get the latest version.

We deprecate each spatial version 90 days after we release the next version. Once a version is deprecated, it’s possible that commands won’t work, or will behave unexpectedly. We recommend you update your spatial version as soon as you can when a new version is available.

Game engine support

We endeavour to support the latest stable and recommended version of a game engine in either the next minor or major game engine integration release following its launch, or in a release less than 3 months afterwards.

When we introduce support for a new version of a game engine, we always support at least one of the previously supported versions (normally the highest) in parallel, in order to facilitate smooth upgrades.

Exceptions

Though we strive not to, we do reserve the right to make out-of-policy releases, deprecations, or breaking changes due to issues such as security risks, or fixes with exceptional technical burden

Maturity stages

  • Pre-alpha: Something that is feature incomplete. Or, part of an existing product that contains a new experiment for a feature. Not necessarily planned to become stable.

    Does not adhere to our bug fixing or breaking change policies. Only available to specific customers. Not recommended for production.

  • Alpha: Feature incomplete and may have some significant bugs. Planned to become stable.

    Not recommended for production.

  • Stable: A complete feature that meets the needs of a set of users for production games. We plan to continue working on this.

  • Deprecated: Not currently working on or planning to work on features or fixes. Could be removed permanently with notice.

    Not recommended for production.

Search results

Was this page helpful?

Thanks for letting us know!

Thanks for your feedback

Need more help? Ask on the forums