目录

版本号格式调整说明

HarmonyOS开发套件版本号统一采用API版本进行描述。API版本号可在搭载HarmonyOS的设备的设置中查询。

从API版本26.0.0开始，API版本号统一采用语义化版本（Semantic Versioning，简称SemVer）格式（X.Y.Z），取代原有的格式。这一变更旨在：

API版本号格式变化后，应用中涉及API兼容性判断的代码也需要随之进行优化，详见应用兼容性说明。

从26.0.0起的语义化版本格式说明

API版本号遵循语义化版本（Semantic Versioning，简称SemVer）规范，格式为 X.Y.Z。

格式定义：

X.Y.Z

字段说明：

字段

说明

X：主版本号

包含大量的新功能以及重要的变更，变更可能包含对API的修改，需要开发者对已开发的应用进行适配修改。

Y：次版本号

包含新功能，原则上向后兼容，但重大安全隐患或关键体验问题可能引入不兼容变更，会在版本说明中提供详细的变更说明指导。

Z：修订版本号

问题修复和小改进，保持向后兼容。

格式示例：

以下版本号仅为示例，不代表后续的版本规划。

26.0.0之前的版本格式说明

在26.0.0之前，API版本号采用X.Y.Z(N)格式，其中：
  • X：主版本号，取值1-99，表示API大版本更新。
  • Y：次版本号，取值0-99，表示API小版本更新。
  • Z：修订版本号，取值0-99，表示API微小更新。
  • N：OpenHarmony底座API level，取值1-99。