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

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

概述

卡片支持尺寸规格是鸿蒙应用开发中的重要规范要求，确保卡片在不同设备上的兼容性和一致性。

设计原则

卡片在不同产品上支持的外观规格应符合规范：

1、手机/平板/PC设备卡片支持的外观规格为：11、12、22、24、44、64（根据卡片能力迭代刷新）；

2、智慧屏设备卡片支持的外观规格为：12、22、24、44。

典型案例

您的手机卡片存在尺寸规格不符合规范问题，检测值为3*3，不满足卡片支持的外观规格。

{
  "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,
      "defaultDimension": "3*3",
      "supportDimensions": [
        "3*3"
      ],
      "formConfigAbility": "ability://EntryAbility",
      "isDynamic": true,
      "metadata": []
    }
  ]
}

修改建议

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

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

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

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


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

2 回复

鸿蒙Next上架检测中，FAQ卡片支持尺寸规格需严格遵循官方设计规范。具体尺寸参数请查阅华为开发者联盟官网发布的《HarmonyOS应用上架规范》或《HarmonyOS设计指南》文档，其中对卡片组件的尺寸系列（如2x2、2x4、4x4等）有明确数值规定。

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


根据您提供的FAQ内容和代码片段，您遇到的问题是卡片尺寸规格不符合HarmonyOS Next的规范要求。

核心问题分析： 您的卡片配置文件（form_config.json）中定义的 "supportDimensions" 和 "defaultDimension" 为 "3*3"。该尺寸不在官方支持的规格列表中，因此无法通过上架检测。

规范的尺寸规格如下：

  1. 手机、平板、PC设备：支持 1*1、1*2、2*2、2*4、4*4、6*4。
  2. 智慧屏设备：支持 1*2、2*2、2*4、4*4。

修改方法： 您需要将配置文件中的尺寸修改为上述列表中的合规尺寸。例如，将卡片修改为标准的 2*2 尺寸：

{
  "forms": [
    {
      ...
      "defaultDimension": "2*2",
      "supportDimensions": [
        "2*2"
      ],
      ...
    }
  ]
}

关键点：

  • defaultDimension（默认尺寸）必须包含在 supportDimensions（支持的尺寸）数组中。
  • 您可以根据应用卡片的实际功能需求，在 supportDimensions 数组中声明多个支持的规格（如 ["2*2", "4*4"]），以提供更好的用户体验。

请根据您的卡片UI设计，从规范列表中选择最合适的尺寸组合进行替换，然后重新编译打包进行上架检测即可。

回到顶部