HarmonyOS鸿蒙Next中应用仅支持非免安装上架检测FAQ

HarmonyOS鸿蒙Next中应用仅支持非免安装上架检测FAQ

概述

应用仅支持非免安装，是指在华为HarmonyOS生态中，传统应用必须通过完整的下载安装流程才能使用。非免安装意味着用户需要显式下载并安装应用包后才能使用该应用，这与元服务的免安装特性形成鲜明对比。

设计原则

应用必须配置为非免安装，APPPack中所有HAP包和HSP包的module.json5配置文件，所有installationFree字段标识当前Module是否支持免安装特性值均为false。

典型案例

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

{
    "app": {
        "apiReleaseType": "Canary2",
        "bundleName": "com.huawei.compatibilityapp.rule215",
        "bundleType": "app",
        "compileSdkType": "HarmonyOS",
        "compileSdkVersion": "4.0.0.15",
       //...
    },
    "module": {
        //bundleType为app应用时，所有的installationFree字段必须为false
        "installationFree": true,
        "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为app应用时，installationFree字段自动配置为false，表示不支持免安装特性。详情见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


鸿蒙Next应用上架检测仅支持非免安装模式。开发者需在AppGallery Connect提交HAP包进行审核，确保应用符合鸿蒙Next的API和规范要求。审核通过后，用户通过应用市场下载安装。免安装（即开即用）模式在鸿蒙Next中暂不支持上架。

根据您提供的FAQ内容，这是一个在HarmonyOS Next应用上架审核中明确且常见的检测点。核心问题在于应用的module.json5配置文件中的installationFree字段被错误地设置为true。

问题根源与解决方案：

  1. 设计原则：在HarmonyOS Next中，传统的应用（bundleType为"app"）必须且仅支持非免安装模式。这意味着应用的所有HAP/HSP模块的installationFree字段都必须显式地设置为false。

  2. 错误示例：您提供的JSON代码片段中，"installationFree": true 正是导致上架检测失败的直接原因。这与"bundleType": "app"的设定相冲突。

  3. 修改方法：

    • 定位到您工程中每个模块（entry、feature等）下的配置文件：src/main/module.json5。
    • 检查并确保所有模块的module对象内的installationFree字段值均为 false。
    • 通常，当bundleType为app时，DevEco Studio会默认将此字段设为false。请检查是否在开发过程中手动修改过此配置。

总结： 为确保应用通过“仅支持非免安装”的上架检测，请逐一核对项目内所有module.json5文件，将其中installationFree字段的值统一修正为false。修正后，重新构建应用并提交审核即可。

回到顶部