HarmonyOS实战开发：卡片生命周期管理

最新推荐文章于 2024-11-24 20:31:20 发布

蜀道衫QAQ

最新推荐文章于 2024-11-24 20:31:20 发布

阅读量1.1k

点赞数 27

分类专栏：鸿蒙文章标签： harmonyos 华为鸿蒙鸿蒙系统 android

本文链接：https://blog.csdn.net/2401_84194030/article/details/138189975

版权

鸿蒙专栏收录该内容

448 篇文章

订阅专栏

本文详细介绍了如何在HarmonyOS中使用ArkTS创建卡片，并重点阐述了如何实现`FormExtensionAbility`的生命周期接口，包括onAddForm、onCastToNormalForm、onUpdateForm等方法，以及如何处理卡片数据绑定和系统事件。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

创建ArkTS卡片，需实现FormExtensionAbility生命周期接口。

在EntryFormAbility.ets中，导入相关模块。

import formInfo from '@ohos.app.form.formInfo';
import formBindingData from '@ohos.app.form.formBindingData';
import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility';
import formProvider from '@ohos.app.form.formProvider';

在EntryFormAbility.ets中，实现FormExtensionAbility生命周期接口，其中在onAddForm的入参want中可以通过FormParam取出卡片的相关信息。

import formInfo from '@ohos.app.form.formInfo';
import formBindingData from '@ohos.app.form.formBindingData';
import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility';
import formProvider from '@ohos.app.form.formProvider';
import { Configuration } from '@ohos.app.ability.Configuration';
import Want from '@ohos.app.ability.Want';
import Base from '@ohos.base';

export default class EntryFormAbility extends FormExtensionAbility {
 onAddForm(want: Want) {
   console.info('[EntryFormAbility] onAddForm');
   // 使用方创建卡片时触发，提供方需要返回卡片数据绑定类
   let obj: Record<string, string> = {
     'title': 'titleOnAddForm',
     'detail': 'detailOnAddForm'
   };
   let formData = formBindingData.createFormBindingData(obj);
   return formData;
 }

 onCastToNormalForm(formId: string) {
   // Called when the form provider is notified that a temporary form is successfully
   // converted to a normal form.
   // 使用方将临时卡片转换为常态卡片触发，提供方需要做相应的处理
   console.info(`[EntryFormAbility] onCastToNormalForm, formId: ${formId}`);
 }

 onUpdateForm(formId: string) {
   // 若卡片支持定时更新/定点更新/卡片使用方主动请求更新功能，则提供方需要重写该方法以支持数据更新
   console.info('[EntryFormAbility] onUpdateForm');
   let obj: Record<string, string> = {
     'title': 'titleOnUpdateForm',
     'detail': 'detailOnUpdateForm'
   };
   let formData = formBindingData.createFormBindingData(obj);
   formProvider.updateForm(formId, formData).catch((err: Base.BusinessError) => {
     console.error(`[EntryFormAbility] Failed to updateForm. Code: ${err.code}, message: ${err.message}`);
   });
 }

 onChangeFormVisibility(newStatus: Record<string, number>) {
   // Called when the form provider receives form events from the system.
   // 需要配置formVisibleNotify为true，且为系统应用才会回调
   console.info('[EntryFormAbility] onChangeFormVisibility');
 }

 onFormEvent(formId: string, message: string) {
   // Called when a specified message event defined by the form provider is triggered.
   // 若卡片支持触发事件，则需要重写该方法并实现对事件的触发
   console.info('[EntryFormAbility] onFormEvent');
 }

 onRemoveForm(formId: string) {
   // Called to notify the form provider that a specified form has been destroyed.
   // 当对应的卡片删除时触发的回调，入参是被删除的卡片ID
   console.info('[EntryFormAbility] onRemoveForm');
 }

 onConfigurationUpdate(config: Configuration) {
   // 当前formExtensionAbility存活时更新系统配置信息时触发的回调。
   // 需要注意，formExtensionAbility创建后5秒内无操作将会被清理。
   console.info('[EntryFormAbility] onConfigurationUpdate:' + JSON.stringify(config));
 }

 onAcquireFormState(want: Want) {
   // Called to return a {@link FormState} object.
   // 卡片提供方接收查询卡片状态通知接口，默认返回卡片初始状态。
   return formInfo.FormState.READY;
 }
}

说明：

FormExtensionAbility进程不能常驻后台，即在卡片生命周期回调函数中无法处理长时间的任务，在生命周期调度完成后会继续存在5秒，如5秒内没有新的生命周期回调触发则进程自动退出。针对可能需要5秒以上才能完成的业务逻辑，建议拉起主应用进行处理，处理完成后使用updateForm()通知卡片进行刷新。

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙（HarmonyOS NEXT）最新学习路线

HarmonOS基础技能

HarmonOS就业必备技能
HarmonOS多媒体技术

鸿蒙NaPi组件进阶

HarmonOS高级技能

初识HarmonOS内核
实战就业级设备开发

有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料