任務(wù)（Mission）管理場景介紹

任務(wù)（Mission）管理相關(guān)的基本概念如下：

• AbilityRecord：系統(tǒng)服務(wù)側(cè)管理一個(gè)UIAbility實(shí)例的最小單元，對(duì)應(yīng)一個(gè)應(yīng)用側(cè)的UIAbility組件實(shí)例。系統(tǒng)服務(wù)側(cè)管理UIAbility實(shí)例數(shù)量上限為512個(gè)。
• MissionRecord：任務(wù)管理的最小單元。一個(gè)MissionRecord中僅有一個(gè)AbilityRecord，即一個(gè)UIAbility組件實(shí)例對(duì)應(yīng)一個(gè)單獨(dú)的任務(wù)。
• MissionList：一個(gè)從桌面開始啟動(dòng)的任務(wù)列表，記錄了任務(wù)之間的啟動(dòng)關(guān)系，下一個(gè)任務(wù)由上一個(gè)任務(wù)啟動(dòng)，最底部的任務(wù)由桌面啟動(dòng)，這里稱之為任務(wù)鏈。
• MissionListManager：系統(tǒng)任務(wù)管理模塊，內(nèi)部維護(hù)了當(dāng)前所有的任務(wù)鏈，與最近任務(wù)列表保持一致。
• 開發(fā)前請(qǐng)熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
  圖1 任務(wù)管理示意圖
  

任務(wù)的管理由系統(tǒng)應(yīng)用（如桌面應(yīng)用）負(fù)責(zé)，三方應(yīng)用無法管理任務(wù)。用戶通過最近任務(wù)列表進(jìn)行任務(wù)的相關(guān)交互。當(dāng)創(chuàng)建任務(wù)后，用戶可以對(duì)最近任務(wù)列表進(jìn)行如下操作：

• 刪除一個(gè)指定的任務(wù)。
• 加鎖或解鎖一個(gè)指定的任務(wù)（加鎖后的任務(wù)在清理所有任務(wù)時(shí)不會(huì)被清理）。
• 清理最近任務(wù)列表中的所有任務(wù)。
• 將一個(gè)指定的任務(wù)切換到前臺(tái)。

一個(gè)UIAbility實(shí)例對(duì)應(yīng)一個(gè)單獨(dú)的任務(wù)，因此應(yīng)用調(diào)用[startAbility()]方法啟動(dòng)一個(gè)UIAbility時(shí)，就是創(chuàng)建了一個(gè)任務(wù)。

1. 桌面應(yīng)用調(diào)用[missionManager]的接口管理任務(wù)，需要申請(qǐng)ohos.permission.MANAGE_MISSIONS權(quán)限，配置方式請(qǐng)參見[申請(qǐng)應(yīng)用權(quán)限]。
2. 利用missionManager進(jìn)行任務(wù)管理（監(jiān)聽任務(wù)變化、獲取任務(wù)信息、獲取任務(wù)快照、清理任務(wù)、任務(wù)加鎖/解鎖等）。
   

import { missionManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { image } from '@kit.ImageKit';
import { promptAction } from '@kit.ArkUI';
import { hilog } from '@kit.PerformanceAnalysisKit';

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ù)被移動(dòng)到前臺(tái)
  onMissionMovedToFront: (mission: number) = > {
    hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionClosed-------');
  },
  // 任務(wù)圖標(biāo)變化
  onMissionIconUpdated: (mission: number, icon: image.PixelMap) = > {
    hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionIconUpdated-------');
  },
  // 任務(wù)名稱變化
  onMissionLabelUpdated: (mission: number) = > {
    hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionLabelUpdated-------');
  },
  // 任務(wù)實(shí)例被關(guān)閉
  onMissionClosed: (mission: number) = > {
    hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionClosed-------');
  }
};

// 1.注冊(cè)任務(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個(gè)任務(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.獲取單個(gè)任務(wù)的詳細(xì)信息()
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ù)切到前臺(tái)
missionManager.moveMissionToFront(this.missionId).then(() = > {
  hilog.info(DOMAIN_NUMBER, TAG, 'moveMissionToFront is called ');
});

// 8.刪除單個(gè)任務(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.解注冊(cè)任務(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');
})

審核編輯 黃宇