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)
@Component
struct 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)}`);
    });
}