目录

Version Format Update Notes

The version number of the HarmonyOS development suite is described using the API version. You can query the API version in Settings of a device running HarmonyOS.

Since API version 26.0.0, the API version number has been unified to the Semantic Versioning (SemVer) format (X.Y.Z), replacing the previous format. This change aims to:

After the API version number format is changed, the code related to API compatibility determination in the application also needs to be optimized. For details, see Application Compatibility.

Semantic Versioning Format for 26.0.0 and Later

The API version number complies with the Semantic Versioning (SemVer) specifications and is in the format of X.Y.Z.

Format definition:

X.Y.Z

Field description:

Field

Description

X: major version number

Contains a large number of new features and important changes. The changes may include API modifications, and you need to modify your developed apps for adaptation.

Y: minor version number

Contains new features. In principle, backward compatibility is maintained. However, incompatible changes may be introduced due to major security risks or key experience issues. Detailed change descriptions will be provided in the version description.

Z: release version number

Fixes bugs and makes minor improvements to ensure backward compatibility.

Format example:

The following version numbers are only examples and do not represent the subsequent version plan.

Format Description for Versions Earlier Than 26.0.0

In versions earlier than 26.0.0, the API version number is in the X.Y.Z(N) format, where:
  • X: Major version number, which ranges from 1 to 99 and indicates a major API version update.
  • Y: Minor version number, which ranges from 0 to 99 and indicates a minor API version update.
  • Z: Release version number, which ranges from 0 to 99 and indicates a minor API update.
  • N: OpenHarmony base API level, which ranges from 1 to 99.