卡片管理

简介

卡片是一种界面展示形式，可以将应用的重要信息或操作前置到卡片，以达到服务直达的目的。

卡片常用于嵌入到其他应用（当前只支持系统应用）中作为其界面的一部分显示，并支持拉起页面，发送消息等基础的交互功能。

卡片的基本概念：

• 卡片提供方 提供卡片显示内容原子化服务，定义卡片的显示内容、控件布局以及控件点击事件。
• 卡片使用方 显示卡片内容的应用，可自由配置应用中卡片展示的位置。
• 卡片管理服务 用于管理系统中所添加卡片的常驻代理服务，包括卡片对象的管理与使用，以及卡片周期性刷新等。

开发者仅需作为卡片提供方进行卡片内容的开发，卡片使用方和卡片管理服务由系统自动处理。

说明： 卡片使用方和提供方不要求常驻运行，在需要添加/删除/请求更新卡片时，卡片管理服务会拉起卡片提供方获取卡片信息。

部件内子模块职责

子模块名称	职责
卡片JS_Napikit模块	提供外部接口，与卡片管理服务交互，负责事件通知的调度，通过ArkUI更新卡片视图。
卡片管理服务模块	管理系统中所添加卡片的常驻代理服务，管理卡片的生命周期，并维护卡片信息以及卡片事件的调度。

目录

foundation/ability/form_fwk
├── frameworks
│   └── js
│       └── napi                    # form_fwk的napi代码实现
├── interfaces
│   ├── inner_api                   # form_fwk的系统内部件间接口 
│   └── kits
│       └── native                  # form_fwk的对外接口  
├── services                        # form管理服务框架代码
│   ├── config                      # form 管理服务配置文件及解析实现
│   ├── form_render_service         # form_render_service.hap(FRS)实现
│   ├── include                     # form 管理服务依赖头文件
│   └── src                         # form 管理服务业务实现
└── test                            # 测试目录

使用说明

​ 卡片框架模型具有两种形态：

• 第一种形态为FA模型。API 8及其更早版本的应用程序只能使用FA模型进行开发，卡片使用FormAbility开发。
• 第二种形态为Stage模型。从API 9开始，Ability框架引入了Stage模型作为第二种应用框架形态，卡片使用FormExtensionAbility开发。

FA卡片开发 基于FA模型的卡片提供方开发，主要涉及如下功能逻辑：

• 开发卡片生命周期回调函数LifecycleForm。
• 创建卡片数据FormBindingData对象。
• 通过FormProvider更新卡片。
• 开发卡片页面。

开发步骤可参考开发指南

Stage卡片开发 基于Stage模型的卡片提供方开发，主要涉及如下功能逻辑：

• 卡片生命周期回调函数FormExtension开发。
• 创建卡片数据FormBindingData对象。
• 通过FormProvider更新卡片。
• 卡片页面开发。

开发步骤可参考开发指南

相关仓

ArkTS API 接口

interface_sdk-js

元能力子系统

ability_base

ability_runtime

dmsfwk

form_fwk

idl_tool

ArkUI框架

arkui_ace_engine