1# 合理运行后台任务 2 3<!--Kit: Common--> 4<!--Subsystem: Demo&Sample--> 5<!--Owner: @mgy917--> 6<!--Designer: @jiangwensai--> 7<!--Tester: @Lyuxin--> 8<!--Adviser: @huipeizi--> 9 10## 简介 11 12设备返回主界面、锁屏、应用切换等操作会使应用退至后台。为了降低设备耗电速度、保障用户使用流畅度，系统会对退至后台的应用进行管控，包括进程挂起和进程终止。为了保障后台音乐播放、日历提醒等功能的正常使用，系统提供了受规范约束的后台任务，扩展应用在后台的运行时间。 13本文将介绍各类后台任务的基本概念和适用场景，并且通过对短时任务和长时任务两个场景的性能分析说明合理运行后台任务的必要性。 14 15## 短时任务 16 17应用退至后台一小段时间后，应用进程会被挂起，无法执行对应的任务。如果应用在后台仍需要执行耗时不长的任务，可以申请短时任务，扩展应用在后台的运行时间。 18 19短时任务适用于小文件下载、缓存、信息发送等实时性高、需要临时占用资源执行的任务。详细的开发指导可参考[短时任务](../task-management/transient-task.md)。 20 21### 场景示例 22 23下面代码在申请短时任务后执行了一个耗时计算任务。源代码可访问[短时任务示例程序](https://gitcode.com/openharmony/applications_app_samples/blob/master/code/Performance/PerformanceLibrary/feature/backgroundTask/src/main/ets/view/TransientTaskView.ets)获取。 24 25```typescript 26import { backgroundTaskManager } from '@kit.BackgroundTasksKit'; 27import { hiTraceMeter } from '@kit.PerformanceAnalysisKit'; 28import { util } from '@kit.ArkTS'; 29import { BusinessError } from '@kit.BasicServicesKit'; 30 31const totalTimes: number = 50000000; // 循环次数 32const calculateResult: string = 'Total time costed = %s ms.'; // 文本格式 33 34@Entry 35@Component 36struct Index { 37 @State message: string = 'Click button to calculate.'; 38 private requestId: number = 0; 39 40 // 申请短时任务 41 requestSuspendDelay() { 42 try { 43 let delayInfo = backgroundTaskManager.requestSuspendDelay('compute', () => { 44 console.info('Request suspension delay will time out.'); 45 // 任务即将超时，取消短时任务 46 this.cancelSuspendDelay(); 47 }) 48 this.requestId = delayInfo.requestId; 49 } catch (error) { 50 console.error(`requestSuspendDelay failed. code is ${(error as BusinessError).code} message is ${(error as BusinessError).message}`); 51 } 52 } 53 54 // 取消短时任务 55 cancelSuspendDelay() { 56 backgroundTaskManager.cancelSuspendDelay(this.requestId); 57 console.info('Request suspension delay cancel.'); 58 } 59 60 // 计算任务 61 computeTask(times: number): number { 62 let start: number = new Date().getTime(); 63 let a: number = 1; 64 let b: number = 1; 65 let c: number = 1; 66 for (let i: number = 0; i < times; i++) { 67 a = a * Math.random() + b * Math.random() + c * Math.random(); 68 b = a * Math.random() + b * Math.random() + c * Math.random(); 69 c = a * Math.random() + b * Math.random() + c * Math.random(); 70 } 71 let end: number = new Date().getTime(); 72 return end - start; 73 } 74 75 // 点击回调 76 clickCallback = () => { 77 this.requestSuspendDelay(); 78 hiTraceMeter.startTrace('computeTask', 0); // 开启性能打点 79 let timeCost = this.computeTask(totalTimes); 80 this.message = util.format(calculateResult, timeCost.toString()); 81 hiTraceMeter.finishTrace('computeTask', 0); // 结束性能打点 82 this.cancelSuspendDelay(); 83 } 84 85 build() { 86 Column() { 87 Row(){ 88 Text(this.message) 89 } 90 Row() { 91 Button('开始计算') 92 .onClick(this.clickCallback) 93 } 94 .width('100%') 95 .justifyContent(FlexAlign.Center) 96 } 97 .width('100%') 98 .height('100%') 99 .justifyContent(FlexAlign.Center) 100 } 101} 102``` 103 104使用 IDE 中的 Time Profiler 获取示例应用从开始计算任务并退到后台执行一分钟内的性能数据。获取到的数据如下图。 105 106图1 短时任务 Time Profiler 泳道图 107 108 109 110- ArkTS Callstack：基于时间轴展示 CPU 占用率和状态的变化。 111- User Trace：基于时间轴展示当前时段内触发用户自定义打点任务的具体情况。H:computeTask 表示短时任务执行用时。 112- Native Callstack：基于时间轴展示 CPU 占用率变化和进程/线程的活动状态以及函数调用栈。 113 114从上图中可以看出，Native Callstack 泳道与 H:computeTask 相对应的时间段内应用进程处于活跃状态，CPU 占用率在较高范围内变化。任务取消后，应用仍然处于运行状态，但是进程的活跃程度和 CPU 占用率都明显下降，直到在几秒后系统将应用挂起，不再占用 CPU。 115 116分别框选任务执行阶段和任务取消后未被挂起阶段对应的 Native Callstack 如下图，查看应用主线程在两个阶段的平均 CPU 占用率和最高 CPU 占用率情况。 117 118图2 任务执行阶段的 CPU 占用率 119 120 121 122图3 任务取消后未被挂起阶段的 CPU 占用率 123 124 125 126可以看到应用主线程在任务执行阶段的平均 CPU 占用率为 12.6%，最高 CPU 占用率为 40.0%，在任务取消后未被挂起阶段的平均 CPU 占用率为 2.2%，最高 CPU 占用率为 28.6%。 127 128在后台运行短时任务，会占用系统 CPU，在后台执行过多的短时任务就有可能会导致前台的应用卡顿，因此建议非必要情况不使用短时任务，使用时也避免同时申请过多的短时任务。 129 130更多短时任务的使用限制和注意事项可以参考[短时任务约束与限制](../task-management/transient-task.md#约束与限制)。 131 132## 长时任务 133 134应用退至后台后，在后台需要长时间运行用户可感知的任务，如播放音乐、导航等。为防止应用进程被挂起，导致对应功能异常，可以申请长时任务，使应用在后台长时间运行。申请长时任务后，系统会做相应的校验，确保应用在执行相应的长时任务。详细的开发指导可参考[长时任务](../task-management/continuous-task.md)。 135 136长时任务支持的类型包括数据传输、音视频播放、录音、定位导航、蓝牙相关、多设备互联、WLAN 相关、音视频通话、计算任务。可以根据下表的场景举例选择相应的长时任务类型。 137 138| 描述 | 场景举例 | 139| ------------------------------ |--------------------| 140| 数据传输 | 后台下载大文件，如浏览器后台下载等。 | 141| 音视频播放 | 音乐类应用在后台播放音乐。 | 142| 录音 | 录音机在后台录音。 | 143| 定位导航 | 导航类应用后台导航。 | 144| 蓝牙相关 | 通过蓝牙传输分享的文件。 | 145| 多设备互联 | 分布式业务连接。 | 146| WLAN 相关（仅对系统应用开放） | 通过 WLAN 传输分享的文件。 | 147| 音视频通话（仅对系统应用开放） | 系统聊天类应用后台音频电话。 | 148| 计算任务（仅对特定设备开放） | 杀毒软件。 | 149 150- 申请了数据传输的长时任务，系统仅会提升应用进程的优先级，降低系统终止应用进程的概率，但仍然会挂起对应的应用进程。对于上传下载对应的功能，需要调用系统[上传下载代理接口](../reference/apis-basic-services-kit/js-apis-request.md)托管给系统执行，可以参考[文件上传下载性能提升指导](./improve-file-upload-and-download-performance.md)。 151- 申请音视频播放长时任务必须使用[媒体会话服务](../media/avsession/avsession-overview.md)，否则无法在后台播放。 152- 申请录音类型长时任务，需要有显著的用户提示，必须通过动态授权弹框来提供用户授权界面，请求用户授权麦克风权限。 153 154### 场景示例 155 156下面模拟一个后台定位的场景。应用订阅设备位置变化，每隔一秒获取位置信息，为了保证应用在退到后台后仍然可以使用定位服务，申请了定位类型的长时任务。源代码可访问[长时任务示例程序](https://gitcode.com/openharmony/applications_app_samples/blob/master/code/Performance/PerformanceLibrary/feature/backgroundTask/src/main/ets/view/LongTermTaskView.ets)获取。 157 158首先需要在 [module.json5](https://gitcode.com/openharmony/applications_app_samples/blob/master/code/Performance/PerformanceLibrary/product/phone/entry/src/main/module.json5) 配置文件中为需要使用长时任务的 EntryAbility 声明任务类型。 159 160```javascript 161{ 162 "module": { 163 // ... 164 "abilities": [ 165 { 166 "name": "EntryAbility", 167 // 后台模式类型 168 "backgroundModes": [ 169 "location" 170 ] 171 } 172 ] 173 } 174} 175``` 176 177需要使用到的相关权限如下： 178 179- ohos.permission.INTERNET 180- ohos.permission.LOCATION_IN_BACKGROUND 181- ohos.permission.APPROXIMATELY_LOCATION 182- ohos.permission.LOCATION 183- ohos.permission.KEEP_BACKGROUND_RUNNING 184 185权限申请方式参考[配置文件权限申明](../security/AccessToken/declare-permissions.md#在配置文件中声明权限)，在 [module.json5](https://gitcode.com/openharmony/applications_app_samples/blob/master/code/Performance/PerformanceLibrary/product/phone/entry/src/main/module.json5) 中进行配置。其中部分权限申请以及打开使能通知开关需要用户手动确认。系统为申请的长时任务发布通知栏消息时，应用的使能通知开关必须处于开启状态，否则用户无法感知后台正在运行的长时任务。 186 187后台定位的实现代码如下： 188 189```javascript 190import { notificationManager } from "@kit.NotificationKit"; 191import { abilityAccessCtrl, common, WantAgent, wantAgent } from "@kit.AbilityKit"; 192import { geoLocationManager } from "@kit.LocationKit"; 193import { backgroundTaskManager } from "@kit.BackgroundTasksKit"; 194import { BusinessError } from '@kit.BasicServicesKit'; 195 196const TAG: string = 'BackgroundLocation'; 197 198@Entry 199@Component 200export struct LongTermTaskView { 201 @State latitude: number = 0; 202 @State longitude: number = 0; 203 204 aboutToAppear() { 205 // 请求发送通知的许可 206 notificationManager.requestEnableNotification(this.getUIContext().getHostContext() as common.UIAbilityContext).then(() => { 207 console.info(`[EntryAbility] requestEnableNotification success`); 208 // 申请定位相关权限 209 let atManager = abilityAccessCtrl.createAtManager(); 210 try { 211 atManager.requestPermissionsFromUser(this.getUIContext().getHostContext(), ['ohos.permission.INTERNET', 212 'ohos.permission.LOCATION', 213 'ohos.permission.LOCATION_IN_BACKGROUND', 214 'ohos.permission.APPROXIMATELY_LOCATION']) 215 .then((data) => { 216 console.info(`[EntryAbility], data: ${JSON.stringify(data)}`); 217 }) 218 .catch((err: BusinessError) => { 219 console.error(`[EntryAbility], err: ${JSON.stringify(err)}`); 220 }) 221 } catch (err) { 222 console.error(`[EntryAbility], catch err->${JSON.stringify(err)}`); 223 } 224 }).catch((err: BusinessError) => { 225 console.error(`[EntryAbility] requestEnableNotification failed, code is ${err.code}, message is ${err.message}`); 226 }); 227 } 228 229 // 位置变化回调 230 locationChange = async (location: geoLocationManager.Location) => { 231 console.info(TAG, `locationChange location =${JSON.stringify(location)}`); 232 this.latitude = location.latitude; 233 this.longitude = location.longitude; 234 } 235 236 // 获取定位 237 async getLocation() { 238 console.info(TAG, `enter getLocation`); 239 let requestInfo: geoLocationManager.LocationRequest = { 240 priority: geoLocationManager.LocationRequestPriority.FIRST_FIX, // 快速获取位置优先 241 scenario: geoLocationManager.LocationRequestScenario.UNSET, // 未设置场景信息 242 timeInterval: 1, // 上报位置信息的时间间隔 243 distanceInterval: 0, // 上报位置信息的距离间隔 244 maxAccuracy: 100 // 精度信息 245 }; 246 console.info(TAG, `on locationChange before`); 247 geoLocationManager.on('locationChange', requestInfo, this.locationChange); 248 console.info(TAG, `on locationChange end`); 249 } 250 251 // 开始长时任务 252 startContinuousTask() { 253 let context: common.UIAbilityContext = this.getUIContext().getHostContext() as common.UIAbilityContext; 254 // 通知参数，指定点击长时任务通知后跳转的应用 255 let wantAgentInfo: wantAgent.WantAgentInfo = { 256 wants: [ 257 { 258 bundleName: context.abilityInfo.bundleName, 259 abilityName: context.abilityInfo.name 260 } 261 ], 262 actionType: wantAgent.OperationType.START_ABILITY, 263 requestCode: 0, 264 wantAgentFlags: [wantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] 265 }; 266 wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj: WantAgent) => { 267 backgroundTaskManager.startBackgroundRunning(context, 268 backgroundTaskManager.BackgroundMode.LOCATION, wantAgentObj).then(() => { 269 console.info(`Succeeded in operationing startBackgroundRunning.`); 270 }).catch((err: BusinessError) => { 271 console.error(`Failed to operation startBackgroundRunning. Code is ${err.code}, message is ${err.message}`); 272 }); 273 }); 274 } 275 276 // 停止长时任务 277 stopContinuousTask() { 278 backgroundTaskManager.stopBackgroundRunning(this.getUIContext().getHostContext()).then(() => { 279 console.info(`Succeeded in operationing stopBackgroundRunning.`); 280 }).catch((err: BusinessError) => { 281 console.error(`Failed to operation stopBackgroundRunning. Code is ${err.code}, message is ${err.message}`); 282 }); 283 } 284 285 build() { 286 Column() { 287 Column() { 288 Text(this.latitude.toString()) 289 Text(this.longitude.toString()) 290 } 291 .width('100%') 292 293 Column() { 294 Button('开启定位服务') 295 .onClick(() => { 296 this.startContinuousTask(); 297 this.getLocation(); 298 }) 299 Button('关闭定位服务') 300 .onClick(async () => { 301 await geoLocationManager.off('locationChange'); 302 this.stopContinuousTask(); 303 }) 304 .margin({ top: 10 }) 305 } 306 .width('100%') 307 } 308 .width('100%') 309 .height('100%') 310 .justifyContent(FlexAlign.Center) 311 } 312} 313``` 314 315基于上述场景，使用功耗测试工具获取 30min 设备功耗，得到的数据如下表。 316 317| 测试任务 | 测试时长(s) | 归一电流(mA) | 最大电流(mA) | 归一耗电(mAH) | 318| -------------------- | ----------- | ------------ | ------------ | ------------- | 319| 后台存在定位长时任务 | 1836.4 | 15.52 | 995.72 | 7.92 | 320| 后台无任务 | 1839.9 | 0.85 | 404.03 | 0.44 | 321 322- 归一电流：电压处于 3.8V 时的电流平均值。 323- 归一耗电的计算方式为：归一电流\*测试时长/3600。3600 表示一小时的秒数。 324 325对比后台存在长时定位任务和不存在长时任务时的功耗数据，当后台存在定位任务持续运行时，设备在 30 分钟内的功耗明显增加。 326 327从功耗角度考虑，应用应该避免过多使用长时任务，针对必须使用长时任务的场景，也可以优化任务执行过程，减少设备功耗。以下是一些优化建议： 328 329- 对定位要求不太高的场景可以适当调整上报时间间隔和上报距离间隔，减少更新频率。 330 331- 尽可能的减少网络请求次数和减小网络请求时间间隔。 332 333- 数据传输中使用高效率的数据格式和解析方法，减少任务执行时间。 334 335更多长时任务的使用限制和注意事项可以参考[长时任务约束与限制](../task-management/continuous-task.md#约束与限制)。 336 337## 延迟任务 338 339应用退至后台后，如果需要执行实时性要求不高的任务，可以使用延迟任务。当应用满足设定条件（包括网络类型、充电类型、存储状态、电池状态、定时状态等）时，将任务添加到执行队列，系统会根据内存、功耗、设备温度、用户使用习惯等统一调度拉起应用。 340 341延迟任务适用于软件更新、信息收集、数据处理等场景。详细的开发指导可参考[延迟任务](../task-management/work-scheduler.md)。 342 343## 代理提醒 344 345应用退到后台或进程终止后，仍然有一些提醒用户的定时类任务，例如购物类应用抢购提醒等，为满足此类功能场景，系统提供了代理提醒（reminderAgentManager）的能力。当应用退至后台或进程终止后，系统会代理应用做相应的提醒。详细的开发指导可参考[代理提醒](../task-management/agent-powered-reminder.md)。 346 347当前支持的提醒类型包括： 348 349- 倒计时：基于倒计时的提醒功能，适用于短时的计时提醒场景，例如抢购倒计时。 350- 日历：基于日历的提醒功能，适用于较长时间的日程提醒场景，例如生日提醒。 351- 闹钟：基于时钟的提醒功能，适用于闹钟相关场景，例如起床闹钟。 352 353## 总结 354 355合理的选择和使用后台任务对于优化用户体验，减少性能消耗非常重要。以下表格对比总结了各类后台任务的概念、适用场景以及任务执行过程中的应用状态。 356 357| 任务类型 | 概念 | 应用退至后台状态 | 适用场景 | 358| -------- |-----------------------------------------------|-------------------------------------------------------------------------------------------------|------------------------------------------------| 359| 无后台 | 不执行任何任务，直接退到后台。 | 一小段时间后应用挂起（几秒内）。 | 通用。 | 360| 短时任务 | 实时性要求高、耗时不长的任务。 | 在单次配额内，应用不会被挂起直到取消任务；单次配额超时不取消，应用进程会被终止。 | 小文件下载、缓存、信息发送等时效性高、需要临时占用资源执行的任务。 | 361| 长时任务 | 长时间运行在后台、用户可感知的任务。 | 应用不会被挂起直到取消任务，任务结束不取消应用进程会被终止。 | 数据传输、音频播放、录音、定位导航、蓝牙、WLAN 相关、多设备互联、音视频通话、计算任务。 | 362| 延迟任务 | 实时性要求不高、可延迟执行的任务，满足条件后放入执行队列，系统会根据内存、功耗等统一调度。 | 应用退到后台时挂起，满足任务设定条件时由系统统一调度拉起应用，创建 Extension 进程执行任务；单次回调最长运行 2 分钟，如果超时不取消，系统会终止对应的 Extension 进程。 | 软件更新、信息收集、数据处理等。 | 363| 代理提醒 | 系统代理应用做出相应提醒。 | 应用挂起或进程终止，满足条件后系统会代理应用做相应的提醒。 | 闹钟、倒计时、日历。 | 364
