HarmonyOS 鸿蒙Next上架检测FAQ应用/元服务/游戏包结构应符合规范

HarmonyOS 鸿蒙Next上架检测FAQ应用/元服务/游戏包结构应符合规范

概述

鸿蒙应用AppPack包中，同一个设备上必须有且仅有一个EntryHap；可以包含一个或多个Feature类型的Hap，也可以不包含。鸿蒙元服务AppPack包中，同一个设备上必须有且仅有一个EntryHap；不允许包含任何Feature类型的Hap包，可以包含一个或者多个Shared类型的Hsp包，也可以不包含。

设计原则

应用/元服务/游戏静态检查每个App包中有且只有1个Entry Hap，有1个或多个或0个Feature Hap/Hsp。

1、静态检查，打开鸿蒙应用/游戏App包，检查每个HAP/HSP包配置文件(module.json5)中的moduletype字段，可选值：entry/feature/shared。在所有配置文件中，有且只有一个entry，可以有0个或1个或多个feature/shared。

2、静态检查，打开鸿蒙元服务App包，检查每个HAP/HSP包配置文件(module.json5)中的moduletype字段，可选值：entry/feature/shared。在所有配置文件中，有且只有一个entry，不可以有feature，可以有0个或1个或多个shared。

典型案例

您的应用包结构不符合规范，不符合审核标准。

// entry模块的module.json5

{
  "module": {
    "name": "entry",
    "type": "entry",
    "description": "$string:module_desc",
    "mainElement": "EntryAbility",
    "deviceTypes": [
      "tv",
      "tablet"
    ],
    // ...
  }
}



// feature模块的module.json5

{
  "module": {
    "name": "feature",
    "type": "entry",
    "description": "$string:module_desc",
    "mainElement": "EntryAbility",
    "deviceTypes": [
      "tv",
      "tablet"
    ],
    // ...
  }
}

修改指引

应用/元服务/游戏静态检查每个App包中有且只有1个Entry Hap，有0个或1个或多个Feature Hap/Hsp。请参考《应用程序包概述》和module.json5配置文件进行修改。

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

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

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


更多关于HarmonyOS 鸿蒙Next上架检测FAQ应用/元服务/游戏包结构应符合规范的实战教程也可以访问 https://www.itying.com/category-93-b0.html

2 回复

鸿蒙Next上架检测中，应用、元服务、游戏包结构需符合官方规范。包结构应严格遵循HAP（Harmony Ability Package）格式，包含AppScope、模块等目录。元服务需使用Stage模型，配置正确的abilities和extensionAbilities。游戏包需适配鸿蒙图形框架。确保所有资源文件、配置文件（如module.json5）正确无误，避免使用非公开API。

更多关于HarmonyOS 鸿蒙Next上架检测FAQ应用/元服务/游戏包结构应符合规范的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


根据您提供的FAQ内容，核心问题在于AppPack包中模块类型（moduletype）的配置不符合HarmonyOS Next的上架规范。

问题根因： 在您提供的典型案例代码中，feature模块的module.json5文件里，错误地将"type"字段设置为了"entry"。这导致一个AppPack包中包含了多个Entry类型的HAP，违反了“必须有且仅有一个Entry Hap”的基本原则。

规范对比与修正：

  1. 对于鸿蒙应用/游戏：

    • 规范：1个Entry Hap + (0个、1个或多个) Feature Hap。
    • 您的错误配置：出现了2个Entry Hap（entry模块和feature模块）。
    • 修正方法：将feature模块module.json5中的"type": "entry" 修改为 "type": "feature"。

  2. 对于鸿蒙元服务：

    • 规范：1个Entry Hap + (0个、1个或多个) Shared Hsp + 0个Feature Hap。
    • 关键区别：元服务不允许包含任何type为"feature"的Hap包。如果您的元服务包中包含了Feature Hap，需要将其移除或重构为Shared Hsp。

快速检查与验证： 在提交上架前，请务必检查项目内所有module.json5配置文件，确保所有module.type字段的统计结果符合上述规范。使用DevEco Testing的“应用上架预检”功能或云端测试服务，可以自动化检测此类包结构问题，提前发现并修复，能有效避免审核驳回。

回到顶部