鸿蒙APP开发：SDK 兼容版本与目标版本如何选择

compatibleSdkVersion值≤targetSdkVersion值≤compileSdkVersion
存量设备API版本使用数量参考

截止2026.4.12

如果没有用到高api版本的新特性，代码工程中配置的api版本不要追求最新，覆盖尽可能多的HarmonyOS现网设备 。

应用市场分发时主要根据minAPIVersion进行分发范围的控制，该字段表示能够分发到的最小API版本的现网设备。

compatibleSdkVersion就是minAPIVersion

当用户设备的API版本低于应用包中的minAPIVersion时

官方示例：

作为应用开发者，使用并适配了API版本6.0.2(22)，同时希望应用能够运行到尽可能多的HarmonyOS现网设备，那么可以在应用工程的build-profile.json5 文件中进行如下配置：

"products": [
  {
    "name": "default",
    "signingConfig": "default",
    "compileSdkVersion": "6.0.2(22)",
    "targetSdkVersion": "6.0.2(22)",
    "compatibleSdkVersion": "6.0.0(20)",
    "runtimeOS": "HarmonyOS",
    ...
  }
]

参考链接