• 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-ability-kit/js-apis-inner-application-uiAbilityContext.md#startability)方法启动一个UIAbility时，就是创建了一个任务。
32
331. 桌面应用调用[missionManager](../reference/apis-ability-kit/js-apis-application-missionManager-sys.md)的接口管理任务，需要申请`ohos.permission.MANAGE_MISSIONS`权限，配置方式请参见[申请应用权限](../security/AccessToken/determine-application-mode.md#system_basic等级应用申请权限的方式)。
34
352. 利用missionManager进行任务管理（监听任务变化、获取任务信息、获取任务快照、清理任务、任务加锁/解锁等）。
36
37    ```ts
38    import { missionManager } from '@kit.AbilityKit';
39    import { BusinessError } from '@kit.BasicServicesKit';
40    import { image } from '@kit.ImageKit';
41    import { promptAction } from '@kit.ArkUI';
42    import { hilog } from '@kit.PerformanceAnalysisKit';
43
44    const TAG: string = 'TaskManager';
45    const DOMAIN_NUMBER: number = 0xFF00;
46    ```
47    ```ts
48    private listenerId: number = 0;
49    private missionId: number = 0;
50    private listener: missionManager.MissionListener = {
51      // 任务创建
52      onMissionCreated: (mission: number) => {
53        hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionCreated-------');
54      },
55      // 任务销毁
56      onMissionDestroyed: (mission: number) => {
57        hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionDestroyed-------');
58      },
59      // 任务快照变化
60      onMissionSnapshotChanged: (mission: number) => {
61        hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionSnapshotChanged-------');
62      },
63      // 任务被移动到前台
64      onMissionMovedToFront: (mission: number) => {
65        hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionMovedToFront-------');
66      },
67      // 任务图标变化
68      onMissionIconUpdated: (mission: number, icon: image.PixelMap) => {
69        hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionIconUpdated-------');
70      },
71      // 任务名称变化
72      onMissionLabelUpdated: (mission: number) => {
73        hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionLabelUpdated-------');
74      },
75      // 任务实例被关闭
76      onMissionClosed: (mission: number) => {
77        hilog.info(DOMAIN_NUMBER, TAG, '--------onMissionClosed-------');
78      }
79    };
80    ```
81    ```ts
82    // 1.注册任务变化通知
83    this.listenerId = missionManager.on('mission', this.listener);
84    this.getUIContext().getPromptAction().showToast({
85      message: 'register_success_toast'
86    });
87    hilog.info(DOMAIN_NUMBER, TAG, `missionManager.on success, listenerId = ${this.listenerId}`);
88    ```
89    ```ts
90    // 2.获取系统最近20个任务
91    missionManager.getMissionInfos('', 20,
92      (error: BusinessError, missions: Array<missionManager.MissionInfo>) => {
93        if (error.code) {
94          hilog.error(DOMAIN_NUMBER, TAG,
95            `getMissionInfos is called, error code: ${error.code}, err msg: ${error.message}.`);
96          return;
97        }
98        hilog.info(DOMAIN_NUMBER, TAG, `size = ${missions.length}.`);
99        hilog.info(DOMAIN_NUMBER, TAG, `missions = ${JSON.stringify(missions)}.`);
100
101        // 判断系统最近任务中是否包含etsclock
102        for (let i = 0; i < missions.length; i++) {
103          if (missions[i].want.bundleName === 'ohos.samples.etsclock') {
104            this.getUIContext().getPromptAction().showToast({
105              message: 'obtain_success_toast'
106            });
107            hilog.info(DOMAIN_NUMBER, TAG,
108              `getMissionInfos.find etsclock, missionId  = ${missions[i].missionId}`);
109            this.missionId = missions[i].missionId;
110            return;
111          }
112        }
113        this.getUIContext().getPromptAction().showToast({
114          message: 'obtain_failed_toast'
115        });
116      });
117    ```
118    ```ts
119    // 3.获取单个任务的详细信息()
120    missionManager.getMissionInfo('', this.missionId).then((data: missionManager.MissionInfo) => {
121      this.getUIContext().getPromptAction().showToast({
122        message: JSON.stringify(data.want.bundleName)
123      });
124      hilog.info(DOMAIN_NUMBER, TAG, `getMissionInfo successfully. Data: ${JSON.stringify(data)}`);
125    }).catch((error: BusinessError) => {
126      hilog.error(DOMAIN_NUMBER, TAG, `getMissionInfo failed. Cause: ${error.message}`);
127    });
128    ```
129    ```ts
130    // 4.获取任务快照
131    missionManager.getMissionSnapShot('', this.missionId,
132      (error: BusinessError, snapshot: missionManager.MissionSnapshot) => {
133        if (error === null) {
134          hilog.info(DOMAIN_NUMBER, TAG, `bundleName = ${snapshot.ability.bundleName}.`);
135          this.getUIContext().getPromptAction().showToast({
136            message: 'obtain_snapshot_success_toast'
137          });
138        } else {
139          hilog.error(DOMAIN_NUMBER, TAG,
140              `getMissionSnapShot is called, error code: ${error.code}, error msg: ${error.message}.`);
141        }
142      });
143    ```
144    ```ts
145    // 5.获取低分辨任务快照
146    missionManager.getLowResolutionMissionSnapShot('', this.missionId,
147      (error: BusinessError, snapshot: missionManager.MissionSnapshot) => {
148        if (error === null) {
149          hilog.info(DOMAIN_NUMBER, TAG, `bundleName = ${snapshot.ability.bundleName}.`);
150          this.getUIContext().getPromptAction().showToast({
151            message: 'obtain_low_snapshot_success_toast'
152          });
153        } else {
154          hilog.error(DOMAIN_NUMBER, TAG,
155              `getLowResolutionMissionSnapShot is called, error code: ${error.code}, error msg: ${error.message}.`);
156        }
157      });
158    ```
159    ```ts
160    // 6-1 加锁任务
161    missionManager.lockMission(this.missionId).then(() => {
162      this.getUIContext().getPromptAction().showToast({
163        message: 'lock_success_toast'
164      });
165      hilog.info(DOMAIN_NUMBER, TAG, 'lockMission is called ');
166    });
167    ```
168    ```ts
169    // 6-2 解锁任务
170    missionManager.unlockMission(this.missionId).then(() => {
171      this.getUIContext().getPromptAction().showToast({
172        message: 'unlock_success_toast'
173      });
174      hilog.info(DOMAIN_NUMBER, TAG, 'unlockMission is called ');
175    });
176    ```
177    ```ts
178    // 7.把任务切到前台
179    missionManager.moveMissionToFront(this.missionId).then(() => {
180      hilog.info(DOMAIN_NUMBER, TAG, 'moveMissionToFront is called ');
181    });
182    ```
183    ```ts
184    // 8.删除单个任务
185    missionManager.clearMission(this.missionId).then(() => {
186      this.getUIContext().getPromptAction().showToast({
187        message: 'delete_success_toast'
188      });
189      hilog.info(DOMAIN_NUMBER, TAG, 'clearMission is called ');
190    });
191    ```
192    ```ts
193    // 9.删除全部任务
194    missionManager.clearAllMissions().catch((err: BusinessError) => {
195      hilog.error(DOMAIN_NUMBER, TAG, `${err.code}`);
196    });
197    ```
198    ```ts
199    // 10.解注册任务变化通知
200    missionManager.off('mission', this.listenerId, (error: BusinessError) => {
201      if (error === null) {
202        this.getUIContext().getPromptAction().showToast({
203          message: 'unregister_success_toast'
204        });
205      }
206      hilog.info(DOMAIN_NUMBER, TAG, 'unregisterMissionListener');
207    });
208    ```
209
210## 相关实例
211
212针对任务管理开发，有以下相关实例可供参考：
213
214- [任务管理（ArkTS）（Full SDK）（API9）](https://gitcode.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/ApplicationModels/MissionManager)
215