HarmonyOS鸿蒙Next上架检测FAQ：元服务仅支持免安装

HarmonyOS鸿蒙Next上架检测FAQ：元服务仅支持免安装

概述

元服务仅支持免安装，是指无需用户显式安装，由系统程序框架后台安装即可使用。元服务是HarmonyOS提供的一种轻量级服务形态，其核心特征之一就是支持免安装体验。

设计原则

元服务必须配置免安装，在创建工程时选择Atomic Service类型，APP Pack中所有HAP包和HSP包的module.json5配置文件，installationFree字段标识当前Module是否支持免安装特性值为True。

典型案例

您的元服务存在未标识当前module是否支持免安装特性的问题，不符合审核标准。

{
    "app": {
        "apiReleaseType": "Canary2",
        "bundleName": "com.huawei.compatibilityapp.rule215",
        "bundleType": "atomicService",
        "compileSdkType": "HarmonyOS",
        "compileSdkVersion": "4.0.0.15",
       //...
    },
    "module": {
        //bundleType为bundleType元服务时，所有的installationFree字段必须为true
        "installationFree": false,
        "mainElement": "EntryAbility",
        "name": "app_startFailedRule2.1.5",
        "pages": "$profile:main_pages",
        "type": "entry",
        "virtualMachine": "ark9.0.0.0"
        //...
    }
}

修改指引

module.json5配置文件所在目录为工程名称/模块名称（例如entry）/src/main/module.json5，当bundleType为atomicService元服务时，installationFree字段自动配置为true，表示支持免安装特性，且符合免安装约束。详情见module.json5配置文件。

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

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


更多关于HarmonyOS鸿蒙Next上架检测FAQ：元服务仅支持免安装的实战教程也可以访问 https://www.itying.com/category-93-b0.html

3 回复

学习

更多关于HarmonyOS鸿蒙Next上架检测FAQ：元服务仅支持免安装的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


HarmonyOS Next的元服务仅支持免安装模式，上架检测需确保应用符合免安装规范。开发者需使用Stage模型开发，并正确配置HAP包。应用需通过DevEco Studio的元服务模板创建，且包体积需控制在10MB以内。上架前需完成签名和调试，确保功能在真机上正常运行。

这是一个非常典型且关键的审核问题。核心原因在于：在HarmonyOS Next中，元服务（Atomic Service）的本质就是免安装的轻量级服务，因此其所有模块都必须明确声明支持免安装特性。

您提供的代码片段清晰地指出了问题所在： 在 module.json5 配置文件中，当 "bundleType": "atomicService" 时，该模块下的 "installationFree" 字段被错误地设置为了 false。这与元服务的设计原则直接冲突。

问题根因与解决方案：

  1. 设计约束：元服务作为HarmonyOS特有的轻量化应用形态，其核心理念是“即点即用”，无需用户进行传统的安装操作。因此，系统强制要求其所有HAP/HSP模块的 installationFree 字段必须为 true。
  2. 配置检查：请逐一检查您工程中 所有 模块（entry、feature等）的 module.json5 文件。确保每个模块的 "installationFree" 字段值均为 true。
  3. 工程创建：通常，在DevEco Studio中创建“Atomic Service”类型的工程时，IDE会自动将各模块的此字段配置为 true。您遇到的情况可能是手动修改或项目迁移过程中产生的配置不一致。
  4. 修改方法：打开每个模块的 src/main/module.json5 文件，找到 "module" 对象下的 "installationFree" 字段，将其值修正为 true 并保存。

验证与预防：

在提交上架前，务必使用 DevEco Testing的本地预检 或 云测试的云端预检 功能进行扫描。这些工具能够准确识别此类配置合规性问题，避免因基础配置错误导致的审核驳回，从而有效提升上架效率。

总结：元服务上架被拒，若原因为“仅支持免安装”，请立即全局检查并修正所有模块的 installationFree 配置，这是HarmonyOS Next元服务开发的强制性规范。

回到顶部