1# 任务管理场景介绍 2 3 4任务管理相关的基本概念如下： 5 6 7- AbilityRecord：系统服务侧管理一个UIAbility实例的最小单元，对应一个应用侧的UIAbility组件实例。系统服务侧管理UIAbility实例数量上限为512个。 8 9- MissionRecord：任务管理的最小单元。一个MissionRecord中仅有一个AbilityRecord，即一个UIAbility组件实例对应一个单独的任务。 10 11- MissionList：一个从桌面开始启动的任务列表，记录了任务之间的启动关系，上一个任务由下一个任务启动，最底部的任务由桌面启动，这里称之为任务链。 12 13- MissionListManager：系统任务管理模块，内部维护了当前所有的任务链，与最近任务列表保持一致。 14 15 **图1** 任务管理示意图 16  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 40 let listener = { 41 // 任务创建 42 onMissionCreated: function (mission) { 43 console.info("--------onMissionCreated-------") 44 }, 45 // 任务销毁 46 onMissionDestroyed: function (mission) { 47 console.info("--------onMissionDestroyed-------") 48 }, 49 // 任务快照变化 50 onMissionSnapshotChanged: function (mission) { 51 console.info("--------onMissionSnapshotChanged-------") 52 }, 53 // 任务被移动到前台 54 onMissionMovedToFront: function (mission) { 55 console.info("--------onMissionMovedToFront-------") 56 }, 57 // 任务图标变化 58 onMissionIconUpdated: function (mission, icon) { 59 console.info("--------onMissionIconUpdated-------") 60 }, 61 // 任务名称变化 62 onMissionLabelUpdated: function (mission) { 63 console.info("--------onMissionLabelUpdated-------") 64 }, 65 // 任务实例被关闭 66 onMissionClosed: function (mission) { 67 console.info("--------onMissionClosed-------") 68 } 69 }; 70 71 // 1.注册任务变化通知 72 let listenerId = missionManager.on('mission', listener); 73 74 // 2.获取系统最近20个任务 75 missionManager.getMissionInfos("", 20, (error, missions) => { 76 console.info("getMissionInfos is called, error.code = " + error.code); 77 console.info("size = " + missions.length); 78 console.info("missions = " + JSON.stringify(missions)); 79 }); 80 81 // 3.获取单个任务的详细信息() 82 let missionId = 11; // 11只是示例，实际是从系统中获取的任务id，下面类似 83 let mission = missionManager.getMissionInfo("", missionId).catch(function (err) { 84 console.info(err); 85 }); 86 87 // 4.获取任务快照 88 missionManager.getMissionSnapShot("", missionId, (error, snapshot) => { 89 console.info("getMissionSnapShot is called, error.code = " + error.code); 90 console.info("bundleName = " + snapshot.ability.bundleName); 91 }) 92 93 // 5.获取低分辨任务快照 94 missionManager.getLowResolutionMissionSnapShot("", missionId, (error, snapshot) => { 95 console.info("getLowResolutionMissionSnapShot is called, error.code = " + error.code); 96 console.info("bundleName = " + snapshot.ability.bundleName); 97 }) 98 99 // 6.加锁/解锁任务 100 missionManager.lockMission(missionId).then(() => { 101 console.info("lockMission is called "); 102 }); 103 104 missionManager.unlockMission(missionId).then(() => { 105 console.info("unlockMission is called "); 106 }); 107 108 // 7.把任务切到前台 109 missionManager.moveMissionToFront(missionId).then(() => { 110 console.info("moveMissionToFront is called "); 111 }); 112 113 // 8.删除单个任务 114 missionManager.clearMission(missionId).then(() => { 115 console.info("clearMission is called "); 116 }); 117 118 // 9.删除全部任务 119 missionManager.clearAllMissions().catch(function (err) { 120 console.info(err); 121 }); 122 123 // 10.解注册任务变化通知 124 missionManager.off('mission', listenerId, (error) => { 125 console.info("unregisterMissionListener"); 126 }) 127 ``` 128 129 130
