HarmonyOS鸿蒙Next上架检测FAQ：应用/元服务/游戏需配置其支持运行的系统版本信息

HarmonyOS鸿蒙Next上架检测FAQ：应用/元服务/游戏需配置其支持运行的系统版本信息

概述

应用/元服务/游戏的App Pack包中，必须声明其所运行的最小和目标OS版本对应的SDK版本号。

设计原则

静态检查，每个Hap包中module.json文件里，compileSdkVersion和targetAPIVersion字段不可以缺省。

典型案例

您的应用未配置其支持运行的系统版本信息，不符合华为应用市场审核标准。

{
    "app": {
        // ...
        "minAPIVersion": 50005017,
        // ...
        "compileSdkType": "HarmonyOS",
        // ...
        // compileSdkVersion和targetAPIVersion字段不可以缺省
        "compileSdkVersion": null,
        "targetAPIVersion": null,
        "vendor": "example",
        "bundleName": "com.example.app",
        "apiReleaseType": "Release"
    },
    // ...
}

修改指引

应用/元服务/游戏静态检查每个Hap包中module.json文件里，compileSdkVersion和targetAPIVersion字段不可以缺省，详情见app.json5配置文件和工程级build-profile.json5文件。

我们在开发者学堂也提供了相关视频课程帮助您更好的学习，详情见应用程序包基础知识。

应用上架前迭代版本测试可使用DevEco Testing应用上架预检功能在本地设备/虚拟机提供黑盒专业测试能力，提前发现上架基础体验类问题，提升上架审核效率。

应用上架提审前可使用云测试应用上架预检功能在云端提供远程黑盒专业测试，包含多品类，多设备，多OS的兼容测试能力，提前发现上架基础体验类问题，提升上架审核效率。

上架预检生成检测报告后，导入到AppAnalyzer工具进行诊断和分析，获得可能的故障原因并生成体检报告。


更多关于HarmonyOS鸿蒙Next上架检测FAQ：应用/元服务/游戏需配置其支持运行的系统版本信息的实战教程也可以访问 https://www.itying.com/category-93-b0.html

2 回复

鸿蒙Next应用上架需在AppGallery Connect中配置支持的系统版本。开发者需在项目配置文件app.json5的"app"字段内明确声明"minAPIVersion"，该值对应HarmonyOS API版本，用于标识应用兼容的最低系统版本。未正确配置将无法通过上架审核。具体API版本与HarmonyOS版本的映射关系需查阅官方文档。

更多关于HarmonyOS鸿蒙Next上架检测FAQ：应用/元服务/游戏需配置其支持运行的系统版本信息的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


这是一个非常关键的上架检测点。根据您提供的FAQ内容，核心问题在于 module.json5 配置文件中的 compileSdkVersion 和 targetAPIVersion 字段被设置为 null 或缺失，导致静态检查失败。

根本原因与解决方案：

这两个字段是HarmonyOS Next应用/元服务声明其编译环境和目标API级别的基础，不能为空。您需要在项目的 module.json5 文件中进行正确配置。

正确的配置示例（在 module.json5 的 "app" 对象内）：

{
  "app": {
    "bundleName": "com.example.app",
    "vendor": "example",
    "versionCode": 1000000,
    "versionName": "1.0.0",
    "icon": "$media:app_icon",
    "label": "$string:app_name",
    "distributedNotificationEnabled": true,
    "minAPIVersion": 50005017, // 应用运行所需的最小API版本
    "targetAPIVersion": 50005017, // 【关键】必须明确声明，通常与compileSdkVersion一致或为兼容版本
    "apiReleaseType": "Release",
    "compileSdkType": "HarmonyOS",
    "compileSdkVersion": "5.0.0.17" // 【关键】必须明确声明，格式为“x.x.x.y”
  },
  // ... 其他模块配置
}

配置要点：

  1. compileSdkVersion：指明应用是使用哪个HarmonyOS SDK版本编译的。其值来源于您项目 hvigorfile.ts 或 build-profile.json5 中配置的 compileSdkVersion。格式为字符串，例如 "5.0.0.17"。
  2. targetAPIVersion：指明应用的目标运行API版本。它通常与 compileSdkVersion 对应的数字版本号一致（如示例中的 50005017），或设置为一个您希望兼容的、更早的API版本。这是一个整数。
  3. minAPIVersion：应用可以安装和运行的最低系统API版本，必须小于等于 targetAPIVersion。

修改步骤：

  1. 在DevEco Studio中打开您的工程。
  2. 找到对应模块下的 src/main/module.json5 文件。
  3. 检查并确保 "app" 对象内的 compileSdkVersion 和 targetAPIVersion 字段均有有效值，且不为 null。
  4. 重新构建App Pack（.app文件），并再次提交上架检测。

确保这些字段正确配置后，即可通过此项静态检查。

回到顶部