API版本号格式变化后，应用中涉及API兼容性判断的代码也需要随之进行优化，详见应用兼容性说明。
HarmonyOS版本
最新版本(26.0.0)
更多版本
应用升级适配与兼容性
文档变更与支持
变更预告
您当前正在浏览新版开发者文档中心，目录分类和层级有所调整。点击左侧当前文档分类名称前的“☰”图标，可切换文档分类。 了解新版目录
HarmonyOS开发套件版本号统一采用API版本进行描述。API版本号可在搭载HarmonyOS的设备的设置中查询。
从API版本26.0.0开始，API版本号统一采用语义化版本（Semantic Versioning，简称SemVer）格式（X.Y.Z），取代原有的格式。这一变更旨在：
- 统一HarmonyOS开发套件版本（API版本）及其底座OpenHarmony的版本号体系。
- 提供更清晰的版本定位，体现主、次版本的概念及升级建议。
- 符合行业标准的语义化版本（SemVer）规范。
注意
从26.0.0起的语义化版本格式说明
API版本号遵循语义化版本（Semantic Versioning，简称SemVer）规范，格式为 X.Y.Z。
格式定义：
收起
自动换行
深色代码主题
复制
- X.Y.Z
字段说明：
展开
| 字段 | 说明 |
|---|---|
| X：主版本号 | 包含大量的新功能以及重要的变更，变更可能包含对API的修改，需要开发者对已开发的应用进行适配修改。 |
| Y：次版本号 | 包含新功能，原则上向后兼容，但重大安全隐患或关键体验问题可能引入不兼容变更，会在版本说明中提供详细的变更说明指导。 |
| Z：修订版本号 | 问题修复和小改进，保持向后兼容。 |
格式示例：
说明
以下版本号仅为示例，不代表后续的版本规划。
- 26.0.0：首次采用完全语义化的版本。
- 26.0.1：26.0.0的修订版本升级，包含问题修复。
- 26.1.0：26.0.0的次版本升级，包含新功能。
- 27.0.0：主版本升级，包含重大变更。
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。
华为开发者联盟 版权所有 ©2026