創(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中可以通過FormParam取出卡片的相關(guān)信息。文章來源:http://www.zghlxwxcb.cn/news/detail-618456.html
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)求更新功能,則提供方需要重寫該方法以支持?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ā)事件,則需要重寫該方法并實(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;
}
}
說明:FormExtensionAbility進(jìn)程不能常駐后臺(tái),即在卡片生命周期回調(diào)函數(shù)中無法處理長時(shí)間的任務(wù),在生命周期調(diào)度完成后會(huì)繼續(xù)存在5秒,如5秒內(nèi)沒有新的生命周期回調(diào)觸發(fā)則進(jìn)程自動(dòng)退出。針對(duì)可能需要5秒以上才能完成的業(yè)務(wù)邏輯,建議拉起主應(yīng)用進(jìn)行處理,處理完成后使用updateForm通知卡片進(jìn)行刷新。文章來源地址http://www.zghlxwxcb.cn/news/detail-618456.html
到了這里,關(guān)于HarmonyOS/OpenHarmony元服務(wù)開發(fā)-卡片生命周期管理的文章就介紹完了。如果您還想了解更多內(nèi)容,請(qǐng)?jiān)谟疑辖撬阉鱐OY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章,希望大家以后多多支持TOY模板網(wǎng)!