文章目录前言后台任务类型一览长时任务申请延迟任务后台代理提醒后台任务生命周期注意事项写在最后前言做音乐播放器的同学肯定遇到过这个场景用户一切到别的 App你的音乐就停了。用户骂你 App 有 bug你心里苦——不是不想放是系统把你挂起了。HarmonyOS7 的 Background Task Kit 就是来救场的。它给后台任务提供了合法的身份让你的 App 在后台也能名正言顺地干活。移动端系统对后台进程的管控越来越严这是大势所趋。HarmonyOS7 也不例外——应用退到后台一小段时间就会被挂起内存不够还会被直接干掉。但有些场景你确实需要在后台跑音乐播放、导航、倒计时提醒……系统不可能一刀切所以 Background Task Kit 提供了几种规范内的后台任务类型只要你按规矩申请系统就让你跑。后台任务类型一览HarmonyOS7 提供了 5 种后台任务每种针对不同场景类型适用场景执行时长是否用户可感知短时任务状态保存、数据同步等临时操作约 3 分钟可申请延期否长时任务音乐播放、导航、设备连接等无硬性上限但需持续满足条件是状态栏有提示延迟任务数据备份、日志上传等低优先级任务系统统一调度不保证执行时间否代理提醒闹钟、倒计时、日历提醒应用被杀后系统代理执行是系统通知能效资源需要持续使用硬件资源的任务与申请的资源绑定视情况而定划重点选错类型任务会被系统拒绝。比如你拿短时任务去搞后台音乐跑一会儿就被掐了。长时任务申请后台音乐播放是最典型的长时任务场景。来看完整代码import{backgroundTaskManager}fromkit.BackgroundTasksKit;import{wantAgent,WantAgent}fromkit.AbilityKit;import{BusinessError}fromkit.BasicServicesKit;EntryComponentstruct MusicPlayer{StateisPlaying:booleanfalseprivatewantAgentObj:WantAgent|nullnullasyncstartBackgroundTask(){try{letwantAgentInfo:wantAgent.WantAgentInfo{wants:[{bundleName:com.example.musicplayer,abilityName:EntryAbility}],operationType:wantAgent.OperationType.START_ABILITY,requestCode:0,wantAgentFlags:[wantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]}this.wantAgentObjawaitwantAgent.getWantAgent(wantAgentInfo)backgroundTaskManager.startBackgroundRunning(this.context,backgroundTaskManager.BackgroundMode.AUDIO_PLAYBACK,this.wantAgentObj!)this.isPlayingtrueconsole.info(长时任务申请成功后台可以继续播放)}catch(error){leteerrorasBusinessErrorconsole.error(长时任务申请失败:${e.code}-${e.message})}}stopBackgroundTask(){try{backgroundTaskManager.stopBackgroundRunning(this.context)this.isPlayingfalseconsole.info(长时任务已取消)}catch(error){leteerrorasBusinessErrorconsole.error(取消长时任务失败:${e.code}-${e.message})}}build(){Column(){Text(this.isPlaying?正在播放中...:已暂停).fontSize(24)Row(){Button(开始播放).onClick(()this.startBackgroundTask())Button(停止播放).onClick(()this.stopBackgroundTask())}}}}关键代码讲解wantAgent.getWantAgent()—— 创建一个 WantAgent 对象长时任务必须传这个参数。它的作用是当用户点击状态栏的后台任务图标时系统通过 WantAgent 把应用拉起来BackgroundMode.AUDIO_PLAYBACK—— 声明后台模式类型不同场景对应不同的枚举值导航用NAVIGATION蓝牙用BLUETOOTH_INTERACTION等startBackgroundRunning()—— 正式申请长时任务三个参数上下文、后台模式、WantAgentstopBackgroundRunning()—— 任务结束后必须手动取消否则系统会认为你在滥用后台权限敲黑板长时任务申请成功后状态栏会出现一个持久通知告诉用户有 App 在后台运行。用户可以主动点击关闭所以别指望它能无限跑。延迟任务有些操作不着急比如凌晨自动备份数据、闲时上传日志。延迟任务就是干这个的——你把任务扔给系统系统根据内存和功耗情况统一调度。import{workScheduler}fromkit.BackgroundTasksKit;functionrequestDelayedTask(){letworkInfo:workScheduler.WorkInfo{workId:1,batteryStatus:workScheduler.BatteryStatus.BATTERY_STATUS_LOW,isRepeat:true,repeatCycleTime:86400000,isPersisted:true,bundleName:com.example.myapp,abilityName:DelayedWorkAbility}try{workScheduler.startWork(workInfo)console.info(延迟任务已注册)}catch(error){console.error(延迟任务注册失败:${(errorasBusinessError).code})}}关键代码讲解workId—— 任务唯一标识取消任务时要用这个 IDbatteryStatus: BATTERY_STATUS_LOW——约束条件只在低电量时触发当然不是这里只是示例。实际开发中你可以设置网络类型、充电状态、存储空间等条件isRepeat: truerepeatCycleTime: 86400000—— 重复执行间隔 24 小时isPersisted: true—— 设备重启后是否保留这个任务bundleNameabilityName—— 指定处理这个任务的 Ability系统会在条件满足时启动它延迟任务的核心思路是你定规则系统来调度。你不用关心什么时候执行系统会在合适的时候帮你跑。后台代理提醒闹钟、倒计时这类提醒哪怕 App 被杀了也得响。代理提醒就是让系统替你干活import{reminderAgentManager}fromkit.ReminderAgentKit;functionsetAlarmReminder(){letalarm:reminderAgentManager.ReminderRequestAlarm{reminderType:reminderAgentManager.ReminderType.REMINDER_TYPE_ALARM,hour:7,minute:30,title:起床闹钟,content:该起床了别赖床}try{letreminderIdreminderAgentManager.publishReminder(alarm)console.info(代理提醒已发布ID:${reminderId})}catch(error){console.error(代理提醒发布失败:${(errorasBusinessError).code})}}关键代码讲解ReminderType.REMINDER_TYPE_ALARM—— 闹钟类型还有REMINDER_TYPE_TIMER倒计时和REMINDER_TYPE_CALENDAR日历提醒hour: 7, minute: 30—— 每天 7:30 触发titlecontent—— 通知栏显示的标题和内容publishReminder()—— 发布提醒返回一个 ID取消时用cancelReminder(reminderId)代理提醒最牛的地方是即使你的 App 进程已经被杀了系统照样帮你弹通知。这就是代理的含义——系统替你干活。后台任务生命周期搞清楚生命周期才能知道任务什么时候该申请、什么时候该释放应用前台运行 │ ▼ 应用退至后台 ──── 申请后台任务 ──── 任务生效继续运行 │ │ │ ▼ │ 任务结束/用户取消/系统回收 │ │ ▼ ▼ 应用被挂起 ◄───────────────── 任务失效进程挂起几个要点前台不需要申请后台任务只有退到后台才需要长时任务要配合 WantAgent不然用户点状态栏图标没反应任务结束必须释放别占着茅坑不拉屎系统资源不足时后台任务也可能被杀长时任务只是提高优先级不是免死金牌注意事项后台任务这块坑不少列几个关键的权限配置不能忘module.json5里必须声明对应权限长时任务要ohos.permission.KEEP_BACKGROUND_RUNNING延迟任务要ohos.permission.WORK_SCHEDULER短时任务有数量限制同一时间最多 3 个超了申请会失败长时任务类型要匹配你申请了AUDIO_PLAYBACK结果后台没在播放音频系统检测到会给你掐了延迟任务不能保证执行系统调度可能等很久才跑别把实时性要求高的任务放这代理提醒有数量上限一个应用最多发布 30 个提醒别拿后台任务干坏事后台偷偷上传用户数据、挖矿之类的审核直接打回写在最后Background Task Kit 的核心逻辑就一句话后台不是法外之地按规矩申请系统让你跑不按规矩来随时被掐。选对任务类型、配好权限、用完及时释放这三步做到位后台任务就不会出幺蛾子。