HarmonyOS 鸿蒙Next上架检测FAQ卡片默认尺寸规格应符合规范

HarmonyOS 鸿蒙Next上架检测FAQ卡片默认尺寸规格应符合规范

概述

卡片默认尺寸规格应符合规范，该规则要求卡片的默认外观规格（defaultDimension）必须合理配置且符合技术规范要求，是兼容性测试中的一项重要标准项。

设计原则

1、默认尺寸必填：卡片的默认外观规格defaultDimension字段不可缺省；

2、取值范围约束：defaultDimension字段的取值必须在该卡片支持的外观规格supportDimensions配置的列表中，不能超出支持尺寸范围。

典型案例

您的卡片存在默认外观规格defaultDimension缺省的问题，forms.defaultDimension字段值不在forms.supportDimensions字段定义范围内，不符合审核标准。

{
  "forms": [
    {
      "name": "widget",
      "displayName": "$string:widget_display_name",
      "description": "$string:widget_desc",
      "src": "./ets/widget/pages/WidgetCard.ets",
      "uiSyntax": "arkts",
      "window": {
        "designWidth": 720,
        "autoDesignWidth": true
      },
      "renderingMode": "fullColor",
      "isDefault": true,
      "updateEnabled": true,
      "scheduledUpdateTime": "10:30",
      "updateDuration": 1,
      // forms.defaultDimension字段值不在forms.supportDimensions字段定义范围内
      "defaultDimension": "1*2",
      "supportDimensions": [
        "1*1","2*2","4*4"
      ],
      "formConfigAbility": "ability://EntryAbility",
      "isDynamic": true,
      "metadata": []
    }
  ]
}

修改指引

当resource指定为$profile:form_config时，会使用开发视图的resources/base/profile/目录下的form_config.json作为卡片profile配置文件，其中，supportDimensions值需要满足卡片支持的外观规格，卡片的默认尺寸defaultDimension取值必须在卡片支持的外观规格supportDimensions配置的列表中。详情见配置ArkTS卡片的配置文件。

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

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


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

2 回复

鸿蒙Next上架检测中，FAQ卡片的默认尺寸规格需严格遵循官方设计规范。具体尺寸由华为官方定义，开发者需查阅最新的《HarmonyOS应用上架规范》或设计指南文档获取精确数值。在开发过程中，应使用官方提供的组件或严格按照指定尺寸进行UI布局，以确保通过上架审核。

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


这是一个在HarmonyOS Next应用上架审核中常见且关键的配置问题。核心问题在于卡片配置文件（通常是form_config.json）中的 defaultDimension 字段配置错误。

问题根因： 提供的JSON配置片段清晰地展示了问题所在："defaultDimension": "1*2" 并未包含在 "supportDimensions": ["1*1","2*2","4*4"] 这个支持的尺寸列表中。这违反了defaultDimension必须是supportDimensions子集的基本规范。

解决方案： 修改卡片配置文件，确保defaultDimension的值是supportDimensions数组中的一个有效项。

正确配置示例： 根据你当前支持的尺寸，可以将默认尺寸修改为列表中的任一值，例如：

{
  "forms": [
    {
      // ... 其他配置保持不变 ...
      "defaultDimension": "2*2", // 修改为 supportDimensions 中存在的值
      "supportDimensions": [
        "1*1","2*2","4*4"
      ],
      // ... 其他配置保持不变 ...
    }
  ]
}

关键检查点：

  1. 必填：defaultDimension字段不能缺失。
  2. 有效值：defaultDimension的值必须与supportDimensions中定义的某个字符串完全匹配。
  3. 配置文件路径：确保修改的是正确的配置文件，通常位于 resources/base/profile/form_config.json。

在修复后，建议使用DevEco Testing的本地预检或云测试服务进行验证，确认此兼容性检测项已通过，以避免上架审核失败。

回到顶部