# Form Kit简介

Form Kit（卡片开发服务）提供了一种在桌面、锁屏等系统应用上嵌入显示应用信息的开发框架和API，可以将应用内用户关注的重要信息或常用操作抽取到服务卡片（简称"卡片"）上，通过将卡片添加到桌面、锁屏等系统应用上，以达到信息展示、服务直达的便捷体验效果。后续统一使用英文名"Form Kit"进行表述。

## 卡片使用场景

* 支持设备类型：Phone、Tablet、PC/2in1、TV、Wearable、Car。轻量级智能穿戴设备不支持使用本Kit。
* 支持开发卡片应用类型：应用和元服务内均支持开发卡片。
* 支持卡片使用位置：用户可以在桌面、锁屏等系统应用上添加使用，不支持在普通应用内嵌入显示卡片。
* 卡片常见使用步骤：

1. 长按"桌面的应用图标"，弹出操作菜单。
2. 点击"卡片"选项，进入卡片管理页面，可以预览卡片。
3. 点击"添加到桌面"按钮，即可在桌面上看到新添加的卡片。

**图1** 卡片常见使用步骤

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/5f/v3/1pqxND7WTJy0E6Z6H8hlrg/zh-cn_image_0000002779850574.png?HW-CC-KV=V1&HW-CC-Date=20261102T125432Z&HW-CC-Expire=31536000000&HW-CC-Sign=5143F94F3DEE28A16135CA56AC80B9EE3A8750BDD85026232C68210219AAC8B7)

## 服务卡片架构

**图2** 服务卡片架构

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/8b/v3/jeQ_97ZHSmaPsxqCDhDx9w/zh-cn_image_0000002779690606.png?HW-CC-KV=V1&HW-CC-Date=20261102T125432Z&HW-CC-Expire=31536000000&HW-CC-Sign=F21E926F35FDC502EE973C72C2E0347D4A87AEBFFBD3AA8C51867CF1BA57668C)

**卡片场景中涉及到的基本概念**

* 卡片使用方：如上图中的桌面，作为显示卡片内容的宿主应用，用于与用户直接进行交互，完成卡片添加、删除、显示功能，并能控制卡片在宿主中具体展示的位置。
* 卡片提供方：提供卡片的应用或元服务，是卡片功能的具体实现者，需要设计实现卡片UI、数据更新、以及点击交互处理功能。
* 卡片管理服务：操作系统内管理整机卡片信息的系统服务，作为卡片提供方和使用方的桥梁，向使用方提供卡片信息查询、添加、删除等能力，同时向提供方提供卡片被添加、被删除、刷新、点击事件等通知能力。

## 模拟器支持情况

本Kit支持模拟器开发，但与真机存在部分能力差异，具体如下：

* 通用差异：详情请参见[模拟器与真机的差异](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-emulator-specification)。
* 模拟器中不支持 1 * 1卡片预览。
* 模拟器中不支持背板透明卡片预览。
* 模拟器中不支持互动卡片预览。

## 亮点/特征

* 信息呈现：将应用/元服务的重要信息以卡片形式展示在桌面，同时支持信息定时更新能力，用户可以随时查看关注的信息。

* 服务直达：通过点击卡片内按钮，就可以实现功能快捷操作，也支持点击后跳转到应用/元服务对应功能页，实现功能服务一步直达的效果。

## 开发模式

**模型选择**

当前系统中应用支持Stage和FA两种开发模型，所以Form Kit也同时支持开发者使用Stage模型和FA模型来开发卡片应用，但更推荐使用Stage模型。

**UI开发范式选择**

* Stage模型支持两种卡片UI开发方式，可以基于ArkTS声明式开发范式语言开发卡片（简称ArkTS卡片）、也可以基于兼容JS的类Web开发范式语言开发卡片（简称JS卡片）。
* FA模型仅支持基于类Web范式JS语言开发JS卡片。

ArkTS卡片与JS卡片具备不同的实现原理及特征，在场景能力上的差异如下表所示：

|类别|JS卡片|ArkTS卡片|
|:-----|:-----|:------|
|开发范式|类Web范式|声明式范式|
|组件能力|支持|支持|
|布局能力|支持|支持|
|事件能力|支持|支持|
|自定义动效|不支持|支持|
|自定义绘制|不支持|支持|
|逻辑代码执行|不支持|支持|

## 与相关Kit的关系

* Ability Kit: Form Kit内部实现依赖Ability Kit提供的Extension基础能力，与Ability Kit存在生命周期调度交互。
* ArkUI: Form Kit卡片提供方在卡片页面中可以使用ArkUI提供的部分组件、事件、动效、状态管理等能力。