HarmonyOS鸿蒙Next中有没有Api兼容性保护的指导？

您好，官方文档是有API兼容性保护的指导，详见：https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/app-compatibility-api-compatibility

以下为基于ArkTS语言的API接口兼容性保护，实例请参考以上链接的参考文档。

1.针对HarmonyOS设备独有特性接口，即接口标记为since M.S.F(N)（文档中标记“起始版本：M.S.F(N)”, SDK物理包中hms路径下所包含的接口），使用distributionOSApiVersion接口进行兼容性判断保护。

import { deviceInfo } from '@kit.BasicServicesKit';
//针对HarmonyOS专有接口，即接口标记为since M.S.F(N)的接口
getTestData(): void {
    // 兼容性判断，50001是由新接口的since字段M*10000+S*100+F转换而来
    if (deviceInfo.distributionOSApiVersion >= 50001) {
        // 调用5.0.1(13)的API新接口
    } else {
        // 降级方案
    }
}

2.针对OpenHarmony底座接口，即接口标记为since N（文档中标记“起始版本：N”，SDK物理包中openharmony路径下所包含的接口），使用sdkApiVersion接口进行兼容性判断保护。

import { deviceInfo } from '@kit.BasicServicesKit';
//针对OpenHarmony底座公共接口，即接口标记为since N
getTestData(): void {
    // 增加兼容性判断
    if (deviceInfo.sdkApiVersion >= 13) {
        // 调用5.0.1(13)的API新接口
    } else {
        // 降级方案
    }
}

最后，对于应用能力的兼容性判断，建议使用面向开发者相关的API版本接口（例如：sdkApiVersion或distributionOSApiVersion接口）;

1.HarmonyOS设备中“设置 > 点击设备名称 > 关于本机”中显示的各种版本号信息中，开发者只应该关注API版本信息。

2.开发者不应该使用面向消费者的HarmonyOS版本信息去进行应用能力兼容性判断（例如distributionOSVersion或displayVersion等字段返回的版本号实际为设备ROM版本号，与开发者严格使用的API版本号并无严格的关联关系，无法保证与API版本号一一对应）。

1. 应注意，deviceInfo.sdkApiVersion仅能用于OpenHarmony底座接口的兼容性保护。

有的，可以参考 应用使用API兼容性保护判断的指导-应用开发中的兼容性场景开发指导-应用兼容性说明

针对HarmonyOS设备独有特性接口，使用distributionOSApiVersion接口进行兼容性判断保护。

import { deviceInfo } from '@kit.BasicServicesKit';
//针对HarmonyOS专有接口，即接口标记为since M.S.F(N)的接口
getTestData(): void {
    // 兼容性判断，50001是由新接口的since字段M*10000+S*100+F转换而来
    if (deviceInfo.distributionOSApiVersion >= 50001) {
        // 调用5.0.1(13)的API新接口
    } else {
        // 降级方案
    }
}

针对OpenHarmony底座接口，使用sdkApiVersion接口进行兼容性判断保护。

import { deviceInfo } from '@kit.BasicServicesKit';
//针对OpenHarmony底座公共接口，即接口标记为since N
getTestData(): void {
    // 增加兼容性判断
    if (deviceInfo.sdkApiVersion >= 13) {
        // 调用5.0.1(13)的API新接口
    } else {
        // 降级方案
    }
}