任务管理场景介绍
任务管理场景介绍
任务管理相关的基本概念如下:
AbilityRecord:系统服务侧管理一个UIAbility实例的最小单元,对应一个应用侧的UIAbility组件实例。
MissionRecord:任务管理的最小单元。一个MissionRecord中仅有一个AbilityRecord,即一个UIAbility组件实例对应一个单独的任务。
MissionList:一个从桌面开始启动的任务列表,记录了任务之间的启动关系,上一个任务由下一个任务启动,最底部的任务由桌面启动,这里称之为任务链。
MissionListManager:系统任务管理模块,内部维护了当前所有的任务链,与最近任务列表保持一致。
图1 任务管理示意图
任务的管理由系统应用(如桌面应用)负责,三方应用无法管理任务。用户通过最近任务列表进行任务的相关交互。当创建任务后,用户可以对最近任务列表进行如下操作:
删除一个指定的任务。
加锁或解锁一个指定的任务(加锁后的任务在清理所有任务时不会被清理)。
清理最近任务列表中的所有任务。
将一个指定的任务切换到前台。
一个UIAbility实例对应一个单独的任务,因此应用调用startAbility()方法启动一个UIAbility时,就是创建了一个任务。
桌面应用调用missionManager的接口管理任务,需要申请
ohos.permission.MANAGE_MISSIONS
权限,配置方式请参见配置文件权限声明。利用missionManager进行任务管理(监听任务变化、获取任务信息、获取任务快照、清理任务、任务加锁/解锁等)。
import missionManager from '@ohos.app.ability.missionManager' let listener = { // 任务创建 onMissionCreated: function (mission) { console.info("--------onMissionCreated-------") }, // 任务销毁 onMissionDestroyed: function (mission) { console.info("--------onMissionDestroyed-------") }, // 任务快照变化 onMissionSnapshotChanged: function (mission) { console.info("--------onMissionSnapshotChanged-------") }, // 任务被移动到前台 onMissionMovedToFront: function (mission) { console.info("--------onMissionMovedToFront-------") }, // 任务图标变化 onMissionIconUpdated: function (mission, icon) { console.info("--------onMissionIconUpdated-------") }, // 任务名称变化 onMissionLabelUpdated: function (mission) { console.info("--------onMissionLabelUpdated-------") }, // 任务实例被关闭 onMissionClosed: function (mission) { console.info("--------onMissionClosed-------") } }; // 1.注册任务变化通知 let listenerId = missionManager.on('mission', listener); // 2.获取系统最近20个任务 missionManager.getMissionInfos("", 20, (error, missions) => { console.info("getMissionInfos is called, error.code = " + error.code); console.info("size = " + missions.length); console.info("missions = " + JSON.stringify(missions)); }); // 3.获取单个任务的详细信息() let missionId = 11; // 11只是示例,实际是从系统中获取的任务id,下面类似 let mission = missionManager.getMissionInfo("", missionId).catch(function (err) { console.info(err); }); // 4.获取任务快照 missionManager.getMissionSnapShot("", missionId, (error, snapshot) => { console.info("getMissionSnapShot is called, error.code = " + error.code); console.info("bundleName = " + snapshot.ability.bundleName); }) // 5.获取低分辨任务快照 missionManager.getLowResolutionMissionSnapShot("", missionId, (error, snapshot) => { console.info("getLowResolutionMissionSnapShot is called, error.code = " + error.code); console.info("bundleName = " + snapshot.ability.bundleName); }) // 6.加锁/解锁任务 missionManager.lockMission(missionId).then(() => { console.info("lockMission is called "); }); missionManager.unlockMission(missionId).then(() => { console.info("unlockMission is called "); }); // 7.把任务切到前台 missionManager.moveMissionToFront(missionId).then(() => { console.info("moveMissionToFront is called "); }); // 8.删除单个任务 missionManager.clearMission(missionId).then(() => { console.info("clearMission is called "); }); // 9.删除全部任务 missionManager.clearAllMissions().catch(function (err) { console.info(err); }); // 10.解注册任务变化通知 missionManager.off('mission', listenerId, (error) => { console.info("unregisterMissionListener"); })
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89