鸿蒙应用中api的兼容性（一）

应用在不同API版本的设备上能否正常运行，直接关系到用户体验和用户覆盖范围。

一、API版本

影响兼容性的字段

版本查看方式

在HarmonyOS设备上查看API版本：设置 → 点击设备名称 → 关于本机 → API版本

二、API版本号说明

26.0.0之前的格式

格式：X.Y.Z(N)

26.0.0及之后的格式（语义化版本SemVer）

从API版本26.0.0开始，采用语义化版本（SemVer） 格式：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)

三、系统兼容性原则

备注：

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();
}

六、开发建议

   应用的兼容性由SDK版本和设备API版本共同决定，遵循向下兼容原则（老应用默认可在新设备运行），新API在老设备运行需进行条件判断保护。