Welcome to the SDK reference page. Here you will find the detailed API reference of the VIKTOR SDK which you can use to build your applications.
Semantic versioning is used to denote different versions of the SDK. The convention that is used for the version number has format vX.Y.Z where:
- X is the major: increments when a backwards incompatible change is introduced.
- Y is the minor: increments when a new functionality is added, without breaking compatibility with older versions.
- Z is the patch: increments when the code can drop-in replace the previous code, or when documentation is added/changed.
A list of all notable changes per SDK version can be found in the Changelog.
Currently, we expect to release a major version of the SDK once a year. Support for the previous major version of the SDK will be dropped 12 months after the release of a new version. Minor versions of the SDK are released more frequently and can be expected to be released every month. Patches might be released in between minor versions containing bug fixes or changes to the docstring.
The workspaces with app versions that use an unsupported version of the SDK cannot be accessed anymore after the support period ends. We will notify developers of upcoming end-of-life dates well in advance so there is enough time to upgrade apps to a newer version of the SDK.
Patch version upgrades (
Patch versions of the SDK are backwards compatible and, therefore, these releases can be used without modifying the code of your application.
Minor version upgrades (
Minor versions of the SDK are backwards compatible and, therefore, these releases can be used without modifying the code of your application.
Minor versions include deprecation warnings, that inform the developer on upcoming breaking changes that need to be
addressed in order to use the next major release. Deprecation warnings are logged by the CLI if the code of your
application requires modification. It is not mandatory to fix deprecation warnings when updating to a minor version. To
make addressing deprecations easier we have started shipping automated code fixes. These automated fixes can be applied
using the CLI
Major version upgrades (
A new major release introduces backwards incompatible changes. This means that the code of your application should be
updated in order to use the new major version of the SDK. To make this process as easy as possible we provide you with
upgrade instructions for each change (see Upgrades). To speed up the process of updating
your app we have started shipping automated code fixes. These automated fixes can be applied using the CLI
From experience upgrading your application to the next major version can be done in the order of a day development time. If you are having difficulty updating your application to new version of the SDK please do not hesitate to contact us.