任務（Mission）管理場景介紹

任務（Mission）管理相關的基本概念如下：

• AbilityRecord：系統服務側管理一個UIAbility實例的最小單元，對應一個應用側的UIAbility組件實例。系統服務側管理UIAbility實例數量上限為512個。
• MissionRecord：任務管理的最小單元。一個MissionRecord中僅有一個AbilityRecord，即一個UIAbility組件實例對應一個單獨的任務。
• MissionList：一個從桌面開始啟動的任務列表，記錄了任務之間的啟動關系，下一個任務由上一個任務啟動，最底部的任務由桌面啟動，這里稱之為任務鏈。
• MissionListManager：系統任務管理模塊，內部維護了當前所有的任務鏈，與最近任務列表保持一致。
  圖1 任務管理示意圖
  

任務的管理由系統應用（如桌面應用）負責，三方應用無法管理任務。用戶通過最近任務列表進行任務的相關交互。當創建任務后，用戶可以對最近任務列表進行如下操作：

• 刪除一個指定的任務。
• 加鎖或解鎖一個指定的任務（加鎖后的任務在清理所有任務時不會被清理）。
• 清理最近任務列表中的所有任務。
• 將一個指定的任務切換到前臺。

一個UIAbility實例對應一個單獨的任務，因此應用調用[startAbility()]方法啟動一個UIAbility時，就是創建了一個任務。

1. 桌面應用調用[missionManager]的接口管理任務，需要申請ohos.permission.MANAGE_MISSIONS權限，配置方式請參見[申請應用權限]。

2. 利用missionManager進行任務管理（監聽任務變化、獲取任務信息、獲取任務快照、清理任務、任務加鎖/解鎖等）。

   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 = {
     // 任務創建
     onMissionCreated: (mission: number) = > {
       hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionCreated-------');
     },
     // 任務銷毀
     onMissionDestroyed: (mission: number) = > {
       hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionDestroyed-------');
     },
     // 任務快照變化
     onMissionSnapshotChanged: (mission: number) = > {
       hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionMovedToFront-------');
     },
     // 任務被移動到前臺
     onMissionMovedToFront: (mission: number) = > {
       hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionClosed-------');
     },
     // 任務圖標變化
     onMissionIconUpdated: (mission: number, icon: image.PixelMap) = > {
       hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionIconUpdated-------');
     },
     // 任務名稱變化
     onMissionLabelUpdated: (mission: number) = > {
       hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionLabelUpdated-------');
     },
     // 任務實例被關閉
     onMissionClosed: (mission: number) = > {
       hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionClosed-------');
     }
   };
   

   // 1.注冊任務變化通知
   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.獲取系統最近20個任務
   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));
   
     // 判斷系統最近任務中是否包含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.獲取單個任務的詳細信息()
   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.獲取任務快照
   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.獲取低分辨任務快照
   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 加鎖任務
   missionManager.lockMission(this.missionId).then(() = > {
     promptAction.showToast({
       message: $r('app.string.lock_success_toast')
     });
     hilog.info(DOMAIN_NUMBER, TAG, 'lockMission is called ');
   });
   

   // 6-2 解鎖任務
   missionManager.unlockMission(this.missionId).then(() = > {
     promptAction.showToast({
       message: $r('app.string.unlock_success_toast')
     });
     hilog.info(DOMAIN_NUMBER, TAG, 'unlockMission is called ');
   });
   

   // 7.把任務切到前臺
   missionManager.moveMissionToFront(this.missionId).then(() = > {
     hilog.info(DOMAIN_NUMBER, TAG, 'moveMissionToFront is called ');
   });
   

   // 8.刪除單個任務
   missionManager.clearMission(this.missionId).then(() = > {
     promptAction.showToast({
       message: $r('app.string.delete_success_toast')
     });
     hilog.info(DOMAIN_NUMBER, TAG, 'clearMission is called ');
   });
   

   // 9.刪除全部任務
   missionManager.clearAllMissions().catch((err: BusinessError) = > {
     hilog.info(DOMAIN_NUMBER, TAG, `${err.code}`);
   });
   

   // 10.解注冊任務變化通知
   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');
   })
   

審核編輯 黃宇