HarmonyOS 应用开发之任务（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 Logger from '../utils/Logger';

const TAG: string = 'TaskManager';

---

private listenerId: number = 0;
private missionId: number = 0;
private listener: missionManager.MissionListener = {
  // 任务创建
  onMissionCreated: (mission: number) => {
    Logger.info(TAG, '--------onMissionCreated-------');
  },
  // 任务销毁
  onMissionDestroyed: (mission: number) => {
    Logger.info(TAG, '--------onMissionDestroyed-------');
  },
  // 任务快照变化
  onMissionSnapshotChanged: (mission: number) => {
    Logger.info(TAG, '--------onMissionSnapshotChanged-------');
  },
  // 任务被移动到前台
  onMissionMovedToFront: (mission: number) => {
    Logger.info(TAG, '--------onMissionMovedToFront-------');
  },
  // 任务图标变化
  onMissionIconUpdated: (mission: number, icon: image.PixelMap) => {
    Logger.info(TAG, '--------onMissionIconUpdated-------');
  },
  // 任务名称变化
  onMissionLabelUpdated: (mission: number) => {
    Logger.info(TAG, '--------onMissionLabelUpdated-------');
  },
  // 任务实例被关闭
  onMissionClosed: (mission: number) => {
    Logger.info(TAG, '--------onMissionClosed-------');
  }
};

---

// 1.注册任务变化通知
this.listenerId = missionManager.on('mission', this.listener);
promptAction.showToast({
  message: $r('app.string.register_success_toast')
});
Logger.info(TAG, `missionManager.on success, listenerId = ${this.listenerId}`);

---

// 2.获取系统最近20个任务
missionManager.getMissionInfos('', 20, (error: BusinessError, missions: Array<missionManager.MissionInfo>) => {
  Logger.info(TAG, 'getMissionInfos is called, error = ' + JSON.stringify(error));
  Logger.info(TAG, 'size = ' + missions.length);
  Logger.info(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')
      });
      Logger.info(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)
  });
  Logger.info(TAG, `getMissionInfo successfully. Data: ${JSON.stringify(data)}`);
}).catch((error: BusinessError) => {
  Logger.error(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')
    });
  }
  Logger.info(TAG, 'getMissionSnapShot is called, error = ' + JSON.stringify(error));
  Logger.info(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')
    });
  }
  Logger.info(TAG, 'getLowResolutionMissionSnapShot is called, error = ' + JSON.stringify(error));
  Logger.info(TAG, 'bundleName = ' + snapshot.ability.bundleName);
})

---

// 6-1 加锁任务
missionManager.lockMission(this.missionId).then(() => {
  promptAction.showToast({
    message: $r('app.string.lock_success_toast')
  });
  Logger.info(TAG, 'lockMission is called ');
});

---

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

---

// 7.把任务切到前台
missionManager.moveMissionToFront(this.missionId).then(() => {
  Logger.info(TAG, 'moveMissionToFront is called ');
});

---

// 8.删除单个任务
missionManager.clearMission(this.missionId).then(() => {
  promptAction.showToast({
    message: $r('app.string.delete_success_toast')
  });
  Logger.info(TAG, 'clearMission is called ');
});

---

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数HarmonyOS鸿蒙开发工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则几千的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年HarmonyOS鸿蒙开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上HarmonyOS鸿蒙开发知识点，真正体系化！

由于文件比较大，这里只是将部分目录大纲截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新

如果你觉得这些内容对你有帮助，可以添加VX：vip204888 （备注鸿蒙获取）

一个人可以走的很快，但一群人才能走的更远。不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎扫码加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

知识点，真正体系化！**

由于文件比较大，这里只是将部分目录大纲截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新

如果你觉得这些内容对你有帮助，可以添加VX：vip204888 （备注鸿蒙获取）
[外链图片转存中…(img-DCGj0jcF-1712844322921)]

一个人可以走的很快，但一群人才能走的更远。不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎扫码加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！