harmony 鸿蒙Form Kit简介

2025-06-12
浏览 (3)

Form Kit简介

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

卡片使用场景

支持设备类型：手机、平板、PC/2in1、智慧屏、智能手表、车机。轻量级智能穿戴设备不支持使用本Kit。
支持开发卡片应用类型：应用和元服务内均支持开发卡片。
支持卡片使用位置：用户可以在桌面、锁屏等系统应用上添加使用，暂不支持在普通应用内嵌入显示卡片。
卡片使用步骤：
长按“桌面图标”，弹出操作菜单。
点击“服务卡片”选项，进入卡片预览界面。
点击“添加到桌面”按钮，即可在桌面上看到并操作新添加的卡片。

图1 卡片常见使用步骤
WidgetUse

服务卡片架构

图2 服务卡片架构
formKit_l0

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

亮点/特征

信息呈现：将应用/元服务的重要信息以卡片形式展示在桌面，同时支持信息定时更新能力，用户可以随时查看关注的信息。
服务直达：通过点击卡片内按钮，就可以实现功能快捷操作，也支持点击后跳转到应用/元服务对应功能页，实现功能服务一步直达的效果。

开发模式

应用运行模式选择

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

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

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

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