HarmonyOS鸿蒙Next中上架检测FAQ卡片配置应符合规范

HarmonyOS鸿蒙Next中上架检测FAQ卡片配置应符合规范

概述

卡片配置应符合规范，主要涉及FormExtensionAbility的配置验证，是应用兼容性测试中的一项重要标准。

设计原则

卡片需要在module.json5配置文件的extensionAbilities标签下，配置FormExtensionAbility相关信息。FormExtensionAbility需要填写metadata元信息标签，其中键名称为固定字符串 “ohos.extension.form”，资源为卡片具体配置信息的资源索引。

典型案例

您的卡片在module.json5配置文件中，type为form且名称为EntryFormAbility的extensionAbilities中，未配置FormExtensionAbility相关信息，metadata元信息标签为空，不符合审核标准。

{
  "module": {
    // ...
    "extensionAbilities": [
      {
        "name": "EntryFormAbility",
        "srcEntry": "./ets/entryformability/EntryFormAbility.ets",
        "label": "$string:EntryFormAbility_label",
        "description": "$string:EntryFormAbility_desc",
        "type": "form",
        // FormExtensionAbility需要填写metadata元信息标签,键名称为固定字符串“ohos.extension.form”
        "metadata": [
          {
            "name": " ",
            "resource": "$profile:form_config"
          }
        ]
      }
    ],
    // 只在独立卡片包形态中会使用，用来关联卡片包模块。
    "formWidgetModule": "library"
  }
}

修改指引

FormExtensionAbility配置，卡片需要在module.json5配置文件的extensionAbilities标签下，配置FormExtensionAbility相关信息。FormExtensionAbility需要填写metadata元信息标签，其中键名称为固定字符串 “ohos.extension.form”，详情见配置ArkTS卡片的配置文件。

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

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


更多关于HarmonyOS鸿蒙Next中上架检测FAQ卡片配置应符合规范的实战教程也可以访问 https://www.itying.com/category-93-b0.html

2 回复

鸿蒙Next上架检测中，FAQ卡片配置需严格遵循规范。卡片内容应准确、完整，能清晰解答用户常见问题。配置时需使用鸿蒙提供的标准组件与接口，确保样式、交互符合设计指南。避免使用非官方或自定义的不合规实现。

更多关于HarmonyOS鸿蒙Next中上架检测FAQ卡片配置应符合规范的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


根据您提供的FAQ内容，您遇到的“卡片配置不符合规范”问题，核心在于 module.json5 文件中 FormExtensionAbility 的 metadata 配置有误。

问题根因： 在您提供的错误配置示例中，metadata 数组内的 "name" 字段值为一个空格 " "。这是不正确的。对于卡片（FormExtensionAbility），此 name 必须为固定字符串 "ohos.extension.form"，系统通过此名称来识别该扩展能力为卡片并提供对应的资源配置。

正确配置如下：

{
  "module": {
    // ...
    "extensionAbilities": [
      {
        "name": "EntryFormAbility",
        "srcEntry": "./ets/entryformability/EntryFormAbility.ets",
        "label": "$string:EntryFormAbility_label",
        "description": "$string:EntryFormAbility_desc",
        "type": "form",
        // 关键修正：metadata 的 name 必须为 "ohos.extension.form"
        "metadata": [
          {
            "name": "ohos.extension.form",
            "resource": "$profile:form_config"
          }
        ]
      }
    ],
    "formWidgetModule": "library"
  }
}

修改步骤：

  1. 打开您项目中对应模块的 module.json5 文件。
  2. 定位到 extensionAbilities 数组中 type 为 "form" 的配置项。
  3. 检查其 metadata 字段，确保其中包含一个 name 为 "ohos.extension.form" 的元数据项，并且 resource 指向您正确的卡片配置文件（如 $profile:form_config）。
  4. 保存文件，重新编译构建您的应用。

完成此修正后，您的卡片配置即可符合 HarmonyOS Next 的上架检测规范。

回到顶部