HarmonyOS鸿蒙Next上架检测FAQ卡片刷新方式应符合规范

HarmonyOS鸿蒙Next上架检测FAQ卡片刷新方式应符合规范

概述

卡片刷新方式应符合规范，要求卡片配置中的刷新方式设置必须符合技术要求，确保卡片数据更新的合理性。

设计原则

1、卡片的配置文件中updateEnabled字段不可缺省；

2、当updateEnabled为True时，可以再定时刷新（updateDuration）和定点刷新（scheduledUpdateTime）两种方式中任选其一。当两者同时配置时，定时刷新优先生效。

典型案例

您的卡片存在updateEnabled字段缺省的问题，不符合审核标准。

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

修改指引

当resource指定为$profile:form_config时，会使用开发视图的resources/base/profile/目录下的form_config.json作为卡片profile配置文件。在创建卡片时会自动生成form_config.json配置文件。其中，updateEnabled字段不可缺省，当updateEnabled为True时，可以选择定时刷新（updateDuration）或定点刷新（scheduledUpdateTime），当两者同时配置时，定时刷新优先生效。详情见配置ArkTS卡片的配置文件。

服务卡片通常用于展示最新的信息或数据。通过卡片更新机制，开发者可以确保卡片上展示的内容是最新的，从而满足用户对实时信息的需求。各种卡片更新场景和开发流程详情见卡片更新与数据交互。

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

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


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

2 回复

鸿蒙Next上架检测中，FAQ卡片的刷新方式需遵循特定规范。刷新操作应使用ArkTS声明式UI开发，通过状态管理驱动视图更新。推荐使用@State或@Observed装饰器管理数据，当数据变更时，系统自动刷新关联的FAQ卡片内容。禁止使用强制刷新或非声明式方法。需确保刷新过程流畅，符合鸿蒙应用UX设计规范。

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


根据您提供的FAQ内容和错误案例，问题核心在于卡片配置文件（form_config.json）中 updateEnabled 字段的配置不符合规范。

具体问题分析： 在您提供的JSON配置代码片段中，"updateEnabled": , 这一行存在语法错误。该字段被声明但未赋予有效的布尔值（true 或 false），这导致了字段“缺省”——即虽然存在字段名，但其值未正确定义，不符合审核要求。

正确的修改方式： 您必须为 updateEnabled 字段指定一个明确的布尔值。

  1. 如果您的卡片需要自动刷新，应将其设置为 true，并至少配置 updateDuration（定时刷新，单位为分钟）或 scheduledUpdateTime（定点刷新，格式如"10:30"）中的一种刷新策略。

    "updateEnabled": true,
"scheduledUpdateTime": "10:30",
// 或 "updateDuration": 30,

    注意：若两者同时配置，updateDuration（定时刷新）会优先生效。

  2. 如果您的卡片不需要自动刷新（例如，完全由用户手动触发或应用内事件触发更新），则必须将其显式设置为 false。

    "updateEnabled": false

总结： 上架检测要求 updateEnabled 字段必须存在且被正确赋值（true/false）。请根据卡片的实际刷新需求，在配置文件中为其赋予正确的布尔值，即可解决此审核问题。

回到顶部