• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 任务（Mission）管理场景介绍
2
3
4任务（Mission）管理相关的基本概念如下：
5
6
7- AbilityRecord：系统服务侧管理一个UIAbility实例的最小单元，对应一个应用侧的UIAbility组件实例。系统服务侧管理UIAbility实例数量上限为512个。
8
9- MissionRecord：任务管理的最小单元。一个MissionRecord中仅有一个AbilityRecord，即一个UIAbility组件实例对应一个单独的任务。
10
11- MissionList：一个从桌面开始启动的任务列表，记录了任务之间的启动关系，下一个任务由上一个任务启动，最底部的任务由桌面启动，这里称之为任务链。
12
13- MissionListManager：系统任务管理模块，内部维护了当前所有的任务链，与最近任务列表保持一致。
14
15  **图1** 任务管理示意图
16  ![mission-list-manager](figures/mission-list-manager.png)
17
18
19任务的管理由系统应用（如桌面应用）负责，三方应用无法管理任务。用户通过最近任务列表进行任务的相关交互。当创建任务后，用户可以对最近任务列表进行如下操作：
20
21
22- 删除一个指定的任务。
23
24- 加锁或解锁一个指定的任务（加锁后的任务在清理所有任务时不会被清理）。
25
26- 清理最近任务列表中的所有任务。
27
28- 将一个指定的任务切换到前台。
29
30
31一个UIAbility实例对应一个单独的任务，因此应用调用[`startAbility()`](../reference/apis/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextstartability)方法启动一个UIAbility时，就是创建了一个任务。
32
331. 桌面应用调用[missionManager](../reference/apis/js-apis-application-missionManager.md)的接口管理任务，需要申请`ohos.permission.MANAGE_MISSIONS`权限，配置方式请参见[配置文件权限声明](../security/accesstoken-guidelines.md#配置文件权限声明)。
34
352. 利用missionManager进行任务管理（监听任务变化、获取任务信息、获取任务快照、清理任务、任务加锁/解锁等）。
36
37   ```ts
38   import missionManager from '@ohos.app.ability.missionManager'
39   import { BusinessError } from '@ohos.base';
40
41   let listener: missionManager.MissionListener = {
42     // 任务创建
43     onMissionCreated: (mission) => {
44       console.info("--------onMissionCreated-------")
45     },
46     // 任务销毁
47     onMissionDestroyed: (mission) => {
48       console.info("--------onMissionDestroyed-------")
49     },
50     // 任务快照变化
51     onMissionSnapshotChanged: (mission) => {
52       console.info("--------onMissionSnapshotChanged-------")
53     },
54     // 任务被移动到前台
55     onMissionMovedToFront: (mission) => {
56       console.info("--------onMissionMovedToFront-------")
57     },
58     // 任务图标变化
59     onMissionIconUpdated: (mission, icon) => {
60       console.info("--------onMissionIconUpdated-------")
61     },
62     // 任务名称变化
63     onMissionLabelUpdated: (mission) => {
64       console.info("--------onMissionLabelUpdated-------")
65     },
66     // 任务实例被关闭
67     onMissionClosed: (mission) => {
68       console.info("--------onMissionClosed-------")
69     }
70   };
71
72   // 1.注册任务变化通知
73   let listenerId = missionManager.on('mission', listener);
74
75   // 2.获取系统最近20个任务
76   missionManager.getMissionInfos("", 20, (error, missions) => {
77     console.info("getMissionInfos is called, error.code = " + error.code);
78     console.info("size = " + missions.length);
79     console.info("missions = " + JSON.stringify(missions));
80   });
81
82   // 3.获取单个任务的详细信息()
83   let missionId = 11; // 11只是示例，实际是从系统中获取的任务id，下面类似
84   let mission = missionManager.getMissionInfo("", missionId).catch((err: BusinessError) => {
85     console.info('${err.code}');
86   });
87
88   // 4.获取任务快照
89   missionManager.getMissionSnapShot("", missionId, (error, snapshot) => {
90     console.info("getMissionSnapShot is called, error.code = " + error.code);
91     console.info("bundleName = " + snapshot.ability.bundleName);
92   })
93
94   // 5.获取低分辨任务快照
95   missionManager.getLowResolutionMissionSnapShot("", missionId, (error, snapshot) => {
96     console.info("getLowResolutionMissionSnapShot is called, error.code = " + error.code);
97     console.info("bundleName = " + snapshot.ability.bundleName);
98   })
99
100   // 6.加锁/解锁任务
101   missionManager.lockMission(missionId).then(() => {
102     console.info("lockMission is called ");
103   });
104
105   missionManager.unlockMission(missionId).then(() => {
106     console.info("unlockMission is called ");
107   });
108
109   // 7.把任务切到前台
110   missionManager.moveMissionToFront(missionId).then(() => {
111     console.info("moveMissionToFront is called ");
112   });
113
114   // 8.删除单个任务
115   missionManager.clearMission(missionId).then(() => {
116     console.info("clearMission is called ");
117   });
118
119   // 9.删除全部任务
120   missionManager.clearAllMissions().catch((err: BusinessError) => {
121     console.info('${err.code}');
122   });
123
124   // 10.解注册任务变化通知
125   missionManager.off('mission', listenerId, (error) => {
126     console.info("unregisterMissionListener");
127   })
128   ```
129
130## 相关实例
131
132针对任务管理开发，有以下相关实例可供参考：
133
134- [任务管理（ArkTS）（Full SDK）（API9）](https://gitee.com/openharmony/applications_app_samples/tree/OpenHarmony-4.0-Release/code/SystemFeature/ApplicationModels/MissionManager)
135