Versioning and Maintenance of SAPUI5

Versioning and Maintenance of SAPUI5

Versioning and maintenance strategy for SAPUI5.

Version Designation

SAPUI5 uses a three-number version identifier, for example, 1.71.22. The numbers have the following meaning:

  • The first part (1) specifies the release number (major version).
  • The second part (71) specifies the version number (minor version).
  • The third part (22) specifies the patch number.

To view the documentation for a specific version, check at https://ui5.sap.com/versionoverview.html which versions are available. You can view the version-specific Demo Kit by adding the version number to the URL, for example, https://ui5.sap.com/1.71.22/ .

To get an overview of the new features of each version, see What's New in SAPUI5. To see the fixes contained in each patch, check the Change Log.

Maintenance Strategy

SAP Business Technology Platform (SAP BTP) is the primary channel for the consumption of SAPUI5. It provides multiple SAPUI5 versions via the Akamai content delivery network.

The general maintenance strategy for SAPUI5 when used on SAP BTP is outlined in this document. It represents the standard approach for managing SAPUI5 on SAP BTP and serves as the primary guideline for customers utilizing this deployment method.

Note

SAPUI5 is also included in various other SAP products (such as SAP S/4HANA Cloud Private Edition and ABAP platform). Customers who utilize SAPUI5 as part of these products may encounter maintenance strategies that differ from the one described for SAP BTP. For information on the applicable maintenance approach, see the specific documentation and guidelines provided within the respective SAP product.

Availability of Multiple Versions on the Akamai Content Delivery Network

SAPUI5 resources are available on the Akamai content delivery network. There, you can also find multiple SAPUI5 versions, and you can use them in your code as described in Variant for Bootstrapping from Content Delivery Network.

Check the available versions with respective maintenance status at https://ui5.sap.com/versionoverview.html.

Caution

Keep in mind that SAPUI5 versions are removed from the Akamai content delivery network at the latest one year after their release. Therefore, make sure to keep your SAPUI5 version up to date! We recommend using the UI5 Renovate Preset Config tool, which allows you to become aware of version changes and upgrade SAPUI5 in a controlled manner.

SAPUI5 Version

You can find which framework versions you use in your app in the Technical Information Dialog ( Ctrl Shift Left Alt / Left Option P .

To access the SAPUI5 version at runtime, you can use the following code:

Hidden
sap.ui.require([
    "sap/ui/VersionInfo",
    "sap/base/util/Version"
], (VersionInfo, VersionUtil) => {
    VersionInfo.load().then(oCurrentVersionInfo => {
    const oSAPUI5Version = new VersionUtil(oCurrentVersionInfo.version);
        // ...
    });
});

The patch version number of the OpenUI5 version (contained in the SAPUI5 distribution) may be different, as OpenUI5 includes mainly the core runtime libraries. For more information, see SAPUI5 vs. OpenUI5.

To access specifically the OpenUI5 version within an SAPUI5 application at runtime, simply use the sap/ui/VersionInfo.load API as in the sample above, but with "sap.ui.core" as a library argument.

Note

Standalone apps, e.g. apps using the self-contained build of UI5 CLI, will report the version of the app itself. Only if the framework resources are provided by a content delivery network (CDN) or a similar shared installation will the main version of the framework be retrieved as shown above.

Related information