卡片生命周期管理

創(chuàng)建ArkTS卡片，需實(shí)現(xiàn)FormExtensionAbility生命周期接口。

1. 在EntryFormAbility.ts中，導(dǎo)入相關(guān)模塊。

   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';

2. 在EntryFormAbility.ts中，實(shí)現(xiàn)FormExtensionAbility生命周期接口，其中在onAddForm的入?yún)ant中可以通過(guò)FormParam取出卡片的相關(guān)信息。

   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';
   
   export default class EntryFormAbility extends FormExtensionAbility {
     onAddForm(want) {
       console.info('[EntryFormAbility] onAddForm');
       // 在入?yún)ant中可以取出卡片的唯一標(biāo)識(shí)：formId
       let formId: string = want.parameters[formInfo.FormParam.IDENTITY_KEY];
       // 使用方創(chuàng)建卡片時(shí)觸發(fā)，提供方需要返回卡片數(shù)據(jù)綁定類
       let obj = {
         'title': 'titleOnAddForm',
         'detail': 'detailOnAddForm'
       };
       let formData = formBindingData.createFormBindingData(obj);
       return formData;
     }
   
     onCastToNormalForm(formId) {
       // Called when the form provider is notified that a temporary form is successfully
       // converted to a normal form.
       // 使用方將臨時(shí)卡片轉(zhuǎn)換為常態(tài)卡片觸發(fā)，提供方需要做相應(yīng)的處理
       console.info(`[EntryFormAbility] onCastToNormalForm, formId: ${formId}`);
     }
   
     onUpdateForm(formId) {
       // 若卡片支持定時(shí)更新/定點(diǎn)更新/卡片使用方主動(dòng)請(qǐng)求更新功能，則提供方需要重寫(xiě)該方法以支持?jǐn)?shù)據(jù)更新
       console.info('[EntryFormAbility] onUpdateForm');
       let obj = {
         'title': 'titleOnUpdateForm',
         'detail': 'detailOnUpdateForm'
       };
       let formData = formBindingData.createFormBindingData(obj);
       formProvider.updateForm(formId, formData).catch((err) => {
         if (err) {
           // 異常分支打印
           console.error(`[EntryFormAbility] Failed to updateForm. Code: ${err.code}, message: ${err.message}`);
           return;
         }
       });
     }
   
     onChangeFormVisibility(newStatus) {
       // Called when the form provider receives form events from the system.
       // 需要配置formVisibleNotify為true，且為系統(tǒng)應(yīng)用才會(huì)回調(diào)
       console.info('[EntryFormAbility] onChangeFormVisibility');
     }
   
     onFormEvent(formId, message) {
       // Called when a specified message event defined by the form provider is triggered.
       // 若卡片支持觸發(fā)事件，則需要重寫(xiě)該方法并實(shí)現(xiàn)對(duì)事件的觸發(fā)
       console.info('[EntryFormAbility] onFormEvent');
     }
   
     onRemoveForm(formId) {
       // Called to notify the form provider that a specified form has been destroyed.
       // 當(dāng)對(duì)應(yīng)的卡片刪除時(shí)觸發(fā)的回調(diào)，入?yún)⑹潜粍h除的卡片ID
       console.info('[EntryFormAbility] onRemoveForm');
     }
   
     onConfigurationUpdate(config) {
       // 當(dāng)系統(tǒng)配置信息置更新時(shí)觸發(fā)的回調(diào)
       console.info('[EntryFormAbility] configurationUpdate:' + JSON.stringify(config));
     }
   
     onAcquireFormState(want) {
       // Called to return a {@link FormState} object.
       // 卡片提供方接收查詢卡片狀態(tài)通知接口，默認(rèn)返回卡片初始狀態(tài)。
       return formInfo.FormState.READY;
     }
   }