任務(wù)(Mission)管理場景介紹
任務(wù)(Mission)管理相關(guān)的基本概念如下:
- AbilityRecord:系統(tǒng)服務(wù)側(cè)管理一個UIAbility實例的最小單元,對應(yīng)一個應(yīng)用側(cè)的UIAbility組件實例。系統(tǒng)服務(wù)側(cè)管理UIAbility實例數(shù)量上限為512個。
- MissionRecord:任務(wù)管理的最小單元。一個MissionRecord中僅有一個AbilityRecord,即一個UIAbility組件實例對應(yīng)一個單獨的任務(wù)。
- MissionList:一個從桌面開始啟動的任務(wù)列表,記錄了任務(wù)之間的啟動關(guān)系,下一個任務(wù)由上一個任務(wù)啟動,最底部的任務(wù)由桌面啟動,這里稱之為任務(wù)鏈。
- MissionListManager:系統(tǒng)任務(wù)管理模塊,內(nèi)部維護了當前所有的任務(wù)鏈,與最近任務(wù)列表保持一致。
圖1 任務(wù)管理示意圖
任務(wù)的管理由系統(tǒng)應(yīng)用(如桌面應(yīng)用)負責,三方應(yīng)用無法管理任務(wù)。用戶通過最近任務(wù)列表進行任務(wù)的相關(guān)交互。當創(chuàng)建任務(wù)后,用戶可以對最近任務(wù)列表進行如下操作:
- 刪除一個指定的任務(wù)。
- 加鎖或解鎖一個指定的任務(wù)(加鎖后的任務(wù)在清理所有任務(wù)時不會被清理)。
- 清理最近任務(wù)列表中的所有任務(wù)。
- 將一個指定的任務(wù)切換到前臺。
一個UIAbility實例對應(yīng)一個單獨的任務(wù),因此應(yīng)用調(diào)用[startAbility()
]方法啟動一個UIAbility時,就是創(chuàng)建了一個任務(wù)。
桌面應(yīng)用調(diào)用[missionManager]的接口管理任務(wù),需要申請
ohos.permission.MANAGE_MISSIONS
權(quán)限,配置方式請參見[申請應(yīng)用權(quán)限]。利用missionManager進行任務(wù)管理(監(jiān)聽任務(wù)變化、獲取任務(wù)信息、獲取任務(wù)快照、清理任務(wù)、任務(wù)加鎖/解鎖等)。
import missionManager from '@ohos.app.ability.missionManager'; import { BusinessError } from '@ohos.base'; import image from '@ohos.multimedia.image'; import promptAction from '@ohos.promptAction'; import hilog from '@ohos.hilog'; const TAG: string = 'TaskManager'; const DOMAIN_NUMBER: number = 0xFF00;
private listenerId: number = 0; private missionId: number = 0; private listener: missionManager.MissionListener = { // 任務(wù)創(chuàng)建 onMissionCreated: (mission: number) = > { hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionCreated-------'); }, // 任務(wù)銷毀 onMissionDestroyed: (mission: number) = > { hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionDestroyed-------'); }, // 任務(wù)快照變化 onMissionSnapshotChanged: (mission: number) = > { hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionMovedToFront-------'); }, // 任務(wù)被移動到前臺 onMissionMovedToFront: (mission: number) = > { hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionClosed-------'); }, // 任務(wù)圖標變化 onMissionIconUpdated: (mission: number, icon: image.PixelMap) = > { hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionIconUpdated-------'); }, // 任務(wù)名稱變化 onMissionLabelUpdated: (mission: number) = > { hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionLabelUpdated-------'); }, // 任務(wù)實例被關(guān)閉 onMissionClosed: (mission: number) = > { hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionClosed-------'); } };
// 1.注冊任務(wù)變化通知 this.listenerId = missionManager.on('mission', this.listener); promptAction.showToast({ message: $r('app.string.register_success_toast') }); hilog.info(DOMAIN_NUMBER, TAG, `missionManager.on success, listenerId = ${this.listenerId}`);
// 2.獲取系統(tǒng)最近20個任務(wù) missionManager.getMissionInfos('', 20, (error: BusinessError, missions: Array< missionManager.MissionInfo >) = > { hilog.info(DOMAIN_NUMBER, TAG, 'getMissionInfos is called, error = ' + JSON.stringify(error)); hilog.info(DOMAIN_NUMBER, TAG, 'size = ' + missions.length); hilog.info(DOMAIN_NUMBER, TAG, 'missions = ' + JSON.stringify(missions)); // 判斷系統(tǒng)最近任務(wù)中是否包含etsclock for (let i = 0;i < missions.length; i++) { if (missions[i].want.bundleName === 'ohos.samples.etsclock') { promptAction.showToast({ message: $r('app.string.obtain_success_toast') }); hilog.info(DOMAIN_NUMBER, TAG, `getMissionInfos.find etsclock, missionId = ${missions[i].missionId}`); this.missionId = missions[i].missionId; return; } } promptAction.showToast({ message: $r('app.string.obtain_failed_toast') }); });
// 3.獲取單個任務(wù)的詳細信息() missionManager.getMissionInfo('', this.missionId).then((data: missionManager.MissionInfo) = > { promptAction.showToast({ message: JSON.stringify(data.want.bundleName) }); hilog.info(DOMAIN_NUMBER, TAG, `getMissionInfo successfully. Data: ${JSON.stringify(data)}`); }).catch((error: BusinessError) = > { hilog.info(DOMAIN_NUMBER, TAG, `getMissionInfo failed. Cause: ${error.message}`); });
// 4.獲取任務(wù)快照 missionManager.getMissionSnapShot('', this.missionId, (error: BusinessError, snapshot: missionManager.MissionSnapshot) = > { if (error === null) { promptAction.showToast({ message: $r('app.string.obtain_snapshot_success_toast') }); } hilog.info(DOMAIN_NUMBER, TAG, 'getMissionSnapShot is called, error = ' + JSON.stringify(error)); hilog.info(DOMAIN_NUMBER, TAG, 'bundleName = ' + snapshot.ability.bundleName); })
// 5.獲取低分辨任務(wù)快照 missionManager.getLowResolutionMissionSnapShot('', this.missionId, (error: BusinessError, snapshot: missionManager.MissionSnapshot) = > { if (error === null) { promptAction.showToast({ message: $r('app.string.obtain_low_snapshot_success_toast') }); } hilog.info(DOMAIN_NUMBER, TAG, 'getLowResolutionMissionSnapShot is called, error = ' + JSON.stringify(error)); hilog.info(DOMAIN_NUMBER, TAG, 'bundleName = ' + snapshot.ability.bundleName); })
// 6-1 加鎖任務(wù) missionManager.lockMission(this.missionId).then(() = > { promptAction.showToast({ message: $r('app.string.lock_success_toast') }); hilog.info(DOMAIN_NUMBER, TAG, 'lockMission is called '); });
// 6-2 解鎖任務(wù) missionManager.unlockMission(this.missionId).then(() = > { promptAction.showToast({ message: $r('app.string.unlock_success_toast') }); hilog.info(DOMAIN_NUMBER, TAG, 'unlockMission is called '); });
// 7.把任務(wù)切到前臺 missionManager.moveMissionToFront(this.missionId).then(() = > { hilog.info(DOMAIN_NUMBER, TAG, 'moveMissionToFront is called '); });
// 8.刪除單個任務(wù) missionManager.clearMission(this.missionId).then(() = > { promptAction.showToast({ message: $r('app.string.delete_success_toast') }); hilog.info(DOMAIN_NUMBER, TAG, 'clearMission is called '); });
// 9.刪除全部任務(wù) missionManager.clearAllMissions().catch((err: BusinessError) = > { hilog.info(DOMAIN_NUMBER, TAG, `${err.code}`); });
// 10.解注冊任務(wù)變化通知 missionManager.off('mission', this.listenerId, (error: BusinessError) = > { if (error === null) { promptAction.showToast({ message: $r('app.string.unregister_success_toast') }); } hilog.info(DOMAIN_NUMBER, TAG, 'unregisterMissionListener'); })
審核編輯 黃宇
-
鴻蒙
+關(guān)注
關(guān)注
56文章
2267瀏覽量
42492
發(fā)布評論請先 登錄
相關(guān)推薦
評論