HarmonyOS next 之 APP 服务卡片获取 APP 内数据
（1）根据需要创建一个服务卡片，
ArkTS 卡片创建完成后，工程中会新增如下卡片相关文件：卡片生命周期管理文件（EntryFormAbility.ets）、卡片页面文件（WidgetCard.ets）和卡片配置文件（form_config.json）
（2）在 module.json5 文件中配置，对应字段参考文档 https:
//developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/arkts-ui-widget-configuration-V5
"extensionAbilities": [ { "name": "EntryFormAbility", "srcEntry": "./ets/entryformability/EntryFormAbility.ets", "label": "$string:EntryFormAbility_label", "description": "$string:EntryFormAbility_desc", "type": "form", "metadata": [ { "name": "ohos.extension.form", "resource": "$profile:form_config" } ] }]
复制代码
（3）卡片的具体配置信息在开发视图的 resources/base/profile/目录下的 form_config.json，对应字段参考文档 https:
//developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/arkts-ui-widget-configuration-V5
（4）ui 开发卡片的 ui 代码在 ets 目录下的 widget 中，接收参数逻辑
let storageUpdateByMsg = new LocalStorage();
@Entry(storageUpdateByMsg)@Componentstruct WidgetCard { @LocalStorageProp('diffExamDay') diffExamDay: number = -1;}
复制代码
（5）卡片生命周期以及给卡片传递数据
在 EntryFormAbility 中的 onAddForm 写初始化逻辑，如获取卡片 id 传递给 WidgetCard 页面触发卡片更新的时候就会触发 onUpdateForm 钩子函数，一般来说就用到这两个
（6）在卡片初始化时获取 app 的相关数据
1、在 WidgetCard 中调用函数 postCardAction 通知 app 根据 formid 更新卡片数据
postCardAction(this, { action: "call", abilityName: "EntryAbility", params: { method: "upDiffExamDay", formId: this.formId, },});
复制代码
此时会有一个问题，直接在 WidgetCard 页面的 aboutToAppear()直接调用 postCardAction 方法通知 app 时，来不及获取到 formid，就导致 app 不能正确的将卡片数据更新到卡片上。解决方案是给 WidgetCard 页面的 formid 设置一个初始值并监听它的变化，变化了再运行函数 postCardAction 通知 app，示例如下
@LocalStorageProp('formId') @Watch('updataFormId') formId:string = '';updataFormId() { console.log('调试formId变化', this.formId) // 卡片向app传参 postCardAction(this, { action: 'call', abilityName: 'EntryAbility', params: { method: 'upDiffExamDay', formId: this.formId } });}
复制代码
2、在 app 中接收并更新卡片数据
在 EntryAbility 的 onCreate 钩子函数中使用 callee 函数监听卡片动态并作出反应
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void { this.callee.on('upDiffExamDay', upDiffExamDayCall);}
// 在收到call事件后会触发callee监听的方法const upDiffExamDayCall = (data: rpc.MessageSequence): MyParcelable => { // 获取call事件中传递的所有参数 let params: Record<string, string> = JSON.parse(data.readString()); if (params.formId !== undefined) { // 将formId存入本地存储 PreferencesUtil.putSync('formId', params.formId) // 获取考试剩余天数数据 const diffExamDay = UserCacheManager.getDiffExamDay(); if (diffExamDay == -1) { // 没有数据获取数据再更新 getHomePageData(params.formId); } else { // 有数据直接触发更新 Utils.updateDiffExamDay(params.formId); } } return new MyParcelable(CONST_NUMBER_1, 'aaa');};// 更新卡片数据updateDiffExamDay(formId: string) { // 获取考试天数 const diffExamDay = UserCacheManager.getDiffExamDay(); let formMsg: formBindingData.FormBindingData = formBindingData.createFormBindingData({ 'diffExamDay': diffExamDay }); // 引入 import { formBindingData, formProvider } from '@kit.FormKit'; // 通过formId触发更新卡片数据 formProvider.updateForm(formId, formMsg).then((data) => { console.log(`updateForm success. ${JSON.stringify(data)}`) }).catch((error: BusinessError) => { console.log(`updateForm failed: ${JSON.stringify(error)}`); });}
复制代码
评论