HarmonyOS鸿蒙Next中【上架检测FAQ】卡片isdefault字段不可缺省

HarmonyOS鸿蒙Next中【上架检测FAQ】卡片isdefault字段不可缺省

概述

卡片的配置文件中isDefault字段用于标识该卡片是否为默认卡片，每个应用/元服务最多有一个默认卡片。

设计原则

1、检查所有form_config.json文件中isDefault字段标记值不为空。

2、检查所有form_config.json文件中isDefault字段标记值，整个应用包内，每个设备类型对应isDefault最多有一个为“true”。

典型案例

常见问题一：您的卡片存在isdefault字段为空问题，不符合规范。

{
  "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": ,
      "updateEnabled": true,
      "scheduledUpdateTime": "10:30",
      "updateDuration": 1,
      "defaultDimension": "2*2",
      "supportDimensions": [
        "2*2"
      ],
      "formConfigAbility": "ability://EntryAbility",
      "isDynamic": true,
      "metadata": []
    }
  ]
}

常见问题二：您的卡片存在isdefault字段有2个true问题，不符合规范。

{
    "forms": [{
            "name": "widget",
            "description": "$string:widget_desc",
            "src": "./ets/widget/pages/WidgetCard.ets",
            "uiSyntax": "arkts",
            "window": {
                "designWidth": 720,
                "autoDesignWidth": true
            },
            "colorMode": "auto",
            "isDefault": true,
            "updateEnabled": false,
            "scheduledUpdateTime": "10:30",
            "updateDuration": 1,
            "defaultDimension": "2*2",
            "supportDimensions": ["2*2"]
        }, {
            "name": "widget1",
            "description": "$string:widget1_desc",
            "src": "./ets/widget1/pages/Widget1Card.ets",
            "uiSyntax": "arkts",
            "window": {
                "designWidth": 720,
                "autoDesignWidth": true
            },
            "colorMode": "auto",
            "isDefault": true,
            "updateEnabled": false,
            "scheduledUpdateTime": "10:30",
            "updateDuration": 1,
            "defaultDimension": "2*2",
            "supportDimensions": ["2*2"]
        }
    ]
}

修改建议

当resource指定为$profile:form_config时，会使用开发视图的resources/base/profile/目录下的form_config.json作为卡片profile配置文件，其中，isDefault字段不可缺省，整个应用包内，每个设备类型对应isDefault最多只有一个为“true”。详情见配置ArkTS卡片的配置文件 。

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

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

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