Version: 8.3

App versioning

Level: beginner

Release apps in sequential versions incremented when you develop new functionality or fix bugs to ensure maximum compatibility. We recommend using the following three-digit version structure:

Patch (X.X.1). Use it for backward-compatible bug fixes. A bug fix is an internal change that corrects incorrect behavior.
Minor (X.1.X). Use it for introducing new backward-compatible functionality or substantial improvements. Patch-level changes can also be included.
Major (1.X.X). Use it for any backward-incompatible changes applied. Minor and patch-level changes can also be included.

You can also specify the Creatio versions with which the app version is compatible. Learn more: Set up the app properties. Creatio checks for app compatibility as part of the installation flow and blocks the installation if the app is considered incompatible. Make sure to specify the correct compatible Creatio version as part of development.

We recommend versioning apps only on development environment.

Before you update an app, make sure you are set as the publisher of the app and the app package is unlocked. If it is locked, turn on the "Allow to edit your own apps from an archive" (CanEditOwnAppsFromArchive code) system setting. Learn more: Manage system settings.

To set an app version:

Click to open the System Designer.
Go to the Application management block → Application Hub.
Open the relevant app.
Open the app properties. To do this, click .
Set the new app version in the Version field, for example, "1.1.0."
Update the app and save the changes.

As a result, the app will be updated and the new version will be set. You will be able to transfer the new version between environments. If an environment already has an older app version, delete it and install the new version.

See also​

See also