应用在不同API版本的设备上能否正常运行直接关系到用户体验和用户覆盖范围。一、API版本环节说明开发态开发者通过HarmonyOS SDK调用API实现业务功能运行态设备ROM搭载的API版本决定应用能否正常运行影响兼容性的字段说明字段编译应用的SDK版本开发时使用的SDK版本应用运行的目标SDK版本targetSdkVersion应用运行的最低SDK版本compatibleSdkVersion版本查看方式在HarmonyOS设备上查看API版本设置 → 点击设备名称 → 关于本机 → API版本二、API版本号说明26.0.0之前的格式格式X.Y.Z(N)字段说明取值范围X主版本号API大版本更新1-99Y次版本号API小版本更新0-99Z修订版本号微小更新0-99NOpenHarmony底座API level1-9926.0.0及之后的格式语义化版本SemVer从API版本26.0.0开始采用语义化版本SemVer格式X.Y.Z字段说明X主版本号包含大量新功能和重要变更可能不兼容需开发者适配修改Y次版本号包含新功能原则上向后兼容重大安全隐患或关键体验问题可能引入不兼容变更Z修订版本号问题修复和小改进保持向后兼容API版本大小关系26.0.0 6.1.1(24) 6.1.0(23) 6.0.2(22) 6.0.1(21) 6.0.0(20) 5.1.1(19) 5.1.0(18) 5.0.5(17)三、系统兼容性原则原则说明向下兼容基于老版本SDK开发的应用默认可在新版本设备上正常运行向上兼容需判断基于新版本SDK开发的应用使用了新API需进行兼容性判断保护后才能在老设备上正常运行备注API在演进迭代过程中因体验优化或安全等因素可能会发生行为变更并对已上架应用产生影响。这部分变更会专门在版本说明中体现升级API版本时需关注版本说明。四、示例代码// 条件判断保护 import { deviceInfo } from kit.BasicServicesKit; // 获取设备API版本 const apiVersion deviceInfo.apiVersion; // 示例API D 在 5.0.3(15) 及以上才支持 if (apiVersion 15) { // 5.0.3(15) 的API level // 使用API D useApiD(); } else { // 降级处理 useFallbackD(); } // 示例API E 在 5.0.4(16) 及以上才支持 if (apiVersion 16) { // 5.0.4(16) 的API level // 使用API E useApiE(); } else { // 降级处理 useFallbackE(); }六、开发建议建议说明关注版本说明API版本升级时关注行为变更说明合理设置最低版本参考存量设备API版本数据新API加保护使用条件判断保护新API调用测试覆盖在不同API版本的设备上进行测试应用的兼容性由SDK版本和设备API版本共同决定遵循向下兼容原则老应用默认可在新设备运行新API在老设备运行需进行条件判断保护。
应用在不同API版本的设备上能否正常运行直接关系到用户体验和用户覆盖范围。一、API版本环节说明开发态开发者通过HarmonyOS SDK调用API实现业务功能运行态设备ROM搭载的API版本决定应用能否正常运行影响兼容性的字段说明字段编译应用的SDK版本开发时使用的SDK版本应用运行的目标SDK版本targetSdkVersion应用运行的最低SDK版本compatibleSdkVersion版本查看方式在HarmonyOS设备上查看API版本设置 → 点击设备名称 → 关于本机 → API版本二、API版本号说明26.0.0之前的格式格式X.Y.Z(N)字段说明取值范围X主版本号API大版本更新1-99Y次版本号API小版本更新0-99Z修订版本号微小更新0-99NOpenHarmony底座API level1-9926.0.0及之后的格式语义化版本SemVer从API版本26.0.0开始采用语义化版本SemVer格式X.Y.Z字段说明X主版本号包含大量新功能和重要变更可能不兼容需开发者适配修改Y次版本号包含新功能原则上向后兼容重大安全隐患或关键体验问题可能引入不兼容变更Z修订版本号问题修复和小改进保持向后兼容API版本大小关系26.0.0 6.1.1(24) 6.1.0(23) 6.0.2(22) 6.0.1(21) 6.0.0(20) 5.1.1(19) 5.1.0(18) 5.0.5(17)三、系统兼容性原则原则说明向下兼容基于老版本SDK开发的应用默认可在新版本设备上正常运行向上兼容需判断基于新版本SDK开发的应用使用了新API需进行兼容性判断保护后才能在老设备上正常运行备注API在演进迭代过程中因体验优化或安全等因素可能会发生行为变更并对已上架应用产生影响。这部分变更会专门在版本说明中体现升级API版本时需关注版本说明。四、示例代码// 条件判断保护 import { deviceInfo } from kit.BasicServicesKit; // 获取设备API版本 const apiVersion deviceInfo.apiVersion; // 示例API D 在 5.0.3(15) 及以上才支持 if (apiVersion 15) { // 5.0.3(15) 的API level // 使用API D useApiD(); } else { // 降级处理 useFallbackD(); } // 示例API E 在 5.0.4(16) 及以上才支持 if (apiVersion 16) { // 5.0.4(16) 的API level // 使用API E useApiE(); } else { // 降级处理 useFallbackE(); }六、开发建议建议说明关注版本说明API版本升级时关注行为变更说明合理设置最低版本参考存量设备API版本数据新API加保护使用条件判断保护新API调用测试覆盖在不同API版本的设备上进行测试应用的兼容性由SDK版本和设备API版本共同决定遵循向下兼容原则老应用默认可在新设备运行新API在老设备运行需进行条件判断保护。
