HarmonyOS Next开发学习手册——Form Kit（卡片开发服务）

Form Kit（卡片开发服务）提供一种界面展示形式，可以将应用的重要信息或操作前置到服务卡片（以下简称“卡片”），以达到服务直达、减少跳转层级的体验效果。卡片常用于嵌入到其他应用（当前被嵌入方即卡片使用方只支持系统应用，例如桌面）中作为其界面显示的一部分，并支持拉起页面、发送消息等基础的交互能力。

服务卡片架构

图1 服务卡片架构

卡片的基本概念：

• 卡片使用方：如上图中的桌面，显示卡片内容的宿主应用，控制卡片在宿主中展示的位置。
  • 应用图标：应用入口图标，点击后可拉起应用进程，图标内容不支持交互
  • 卡片：具备不同规格大小的界面展示，卡片的内容可以进行交互，如实现按钮进行 界面的刷新 、 应用的跳转 等。
• 卡片提供方：包含卡片的应用，提供卡片的显示内容、控件布局以及控件点击处理逻辑。
  • FormExtensionAbility：卡片业务逻辑模块，提供卡片创建、销毁、刷新等生命周期回调。
  • 卡片页面：卡片UI模块，包含页面控件、布局、事件等显示和交互信息。

卡片的常见使用步骤如下：

图2 卡片常见使用步骤

1. 长按“桌面图标”，弹出操作菜单。
2. 点击“服务卡片”选项，进入卡片预览界面。
3. 点击“添加到桌面”按钮，即可在桌面上看到新添加的卡片。

亮点/特征

• 服务直达：将元服务/应用的重要信息以卡片形式展示在桌面，用户可以通过快捷手势使用卡片，通过轻量交互行为实现服务直达、减少层级跳转的目的。
• 永久在线：提供定时、代理等多种卡片刷新机制，实现卡片永久在线。
• 受限管控：卡片支持的组件、事件、动效、数据管理、状态管理和API能力均进行了一定限制，保障性能、功耗及安全可靠。

开发模式

Form Kit支持Stage开发模型（推荐）和FA开发模型。

• Stage模型支持两种卡片开发方式，可以基于声明式范式ArkTS语言开发ArkTS卡片、也可以基于类Web范式JS语言开发JS卡片。
• FA模型仅支持基于类Web范式JS语言开发JS卡片。

ArkTS卡片与JS卡片