HarmonyOS鸿蒙Next卡片开发-基础信息概述与配置

HarmonyOS鸿蒙Next卡片开发-基础信息概述与配置 一． 基本概念

原子化服务中每个便捷服务应有独立的图标、名称、描述、快照，这些称为便捷服务基础信息。

基础信息应能够准确反映便捷服务提供方的特征及便捷服务的核心体验。

便捷服务基础信息将展示在服务中心、搜索等界面。

当前支持配置基础信息的设备类型有：手机、平板、智能穿戴和智慧屏。

二． 基础配置

配置便捷服务的图标、名称、描述信息

在作为该便捷服务入口的HAP包的“config.json”配置文件中，为mainAbility配置图标（“icon”）、名称（“label”）、描述（“description”）。

其中，mainAbility的“label”标签是便捷服务对用户显示的名称，必须配置，且应以资源索引的方式配置，以支持多语言。不同HAP包的mainAbility的“label”要唯一，以免造成用户看到多个同名服务而无法区分。此外，“label”的命名应与服务内容强关联，能够通过显而易见的语义看出服务关键内容。

以下示例中：

• “label”：在entry\src\main\resources\base\element\string.json中，定义便捷服务对用户显示的名称，然后config.json中以索引方式引用"label"。

• “icon” ：开发者将便捷服务的图标png文件放至entry\src\main\resources\base\media目录，然后config.json中以索引方式引用"icon"。

• “description”：在entry\src\main\resources\base\element\string.json中，定义便捷服务简要描述，然后config.json中以索引方式引用"description"，卡片与快照中定义便捷描述与其一致。

• “服务卡片名”可以查看config.json文件的forms数组中的“name”字段。

配置便捷服务的快照

如前文所述，mainAbility中至少配置2*2（小尺寸）规格的默认服务卡片，该卡片对应的快照图，需要配置为便捷服务的快照入口，用于在服务中心显示。

配置方式：通过DevEco Studio工程向导创建Project Type为“Service”的新工程或在已有Project Type为“Service”的工程中添加新模块时，勾选“Show in Service Center”，则会同步创建一个2*2的默认服务卡片模板，同时还会创建该卡片对应的快照图。

工程创建完成后，会在工程目录下生成快照（EntryCard）目录。

在该目录下，每个拥有快照（EntryCard）的模块，都会生成一个和模块名相同的文件夹，同时还会默认生成一张2*2（小尺寸）的快照（一张png格式的图片）。

开发者可以将其替换为事先设计好的2*2快照，样式上应与对应的服务卡片保持一致：将新的快照拷贝到上图目录下，删除默认图片，新图片命名遵循格式“服务卡片名-2x2.png”。

本文主要参考HarmonyOS官方文档材料整理。