中国总决赛
√
全球总决赛
√
学习进度
完成
省赛
√
能力分类
主要子系统
能力模型
后台任务总体概念,后台任务支持的任务类型
后台任务管理
总体概念
功能介绍
- 应用退至后台一小段时间(由系统定义),应用进程会被挂起。
- 应用退至后台,在后台被访问一小段时间(由系统定义)后,应用进程会被挂起。
- 资源不足时,系统会终止部分应用进程(即回收该进程的所有资源)。
后台任务类型
OpenHarmony标准系统支持规范内受约束的后台任务,包括短时任务、长时任务、延迟任务、代理提醒和能效资源。
- 短时任务:适用于实时性要求高、耗时不长的任务,例如状态保存。
- 长时任务:适用于长时间运行在后台、用户可感知的任务,例如后台播放音乐、导航、设备连接等,使用长时任务避免应用进程被挂起。
- 延迟任务:对于实时性要求不高、可延迟执行的任务,系统提供了延迟任务,即满足条件的应用退至后台后被放入执行队列,系统会根据内存、功耗等统一调度。
- 代理提醒:代理提醒是指应用退后台或进程终止后,系统会代理应用做相应的提醒。适用于定时提醒类业务,当前支持的提醒类型包括倒计时、日历和闹钟三类。
后台任务类型选择

注意:
- 系统仅支持规范内的后台任务。应用退至后台后,若未使用规范内的后台任务或选择的后台任务类型不正确,对应的应用进程会被挂起或终止。
- 应用申请了规范内的后台任务,仅会提升应用进程被回收的优先级。当系统资源严重不足时,即使应用进程申请了规范内的后台任务,系统仍会终止部分进程,用以保障系统稳定性。
短时任务
应用退至后台一小段时间后,应用进程会被挂起,无法执行对应的任务。如果应用在后台仍需要执行耗时不长的任务,如状态保存等,可以通过本文申请短时任务,扩展应用在后台的运行时间。
约束与限制
- 申请时机:应用需要在前台或退至后台5秒内,申请短时任务,否则会申请失败。
- 数量限制:一个应用同一时刻最多申请3个短时任务。以图1为例,在①②③时间段内的任意时刻,应用申请了2个短时任务;在④时间段内的任意时刻,应用申请了1个短时任务。
- 配额机制:一个应用会有一定的短时任务配额(根据系统状态和用户习惯调整),单日(24小时内)配额默认为10分钟,单次配额最大为3分钟,低电量时单次配额默认为1分钟,配额消耗完后不允许再申请短时任务。同时,系统提供获取对应短时任务剩余时间的查询接口,用以查询本次短时任务剩余时间,以确认是否继续运行其他业务。
- 配额计算:仅当应用在后台时,对应用下的短时任务计时;同一个应用下的同一个时间段的短时任务,不重复计时。以下图为例:应用有两个短时任务A和B,在前台时申请短时任务A,应用退至后台后开始计时为①,应用进入前台②后不计时,再次进入后台③后开始计时,短时任务A结束后,由于阶段④仍然有短时任务B,所以该阶段继续计时。因此,在这个过程中,该应用短时任务总耗时为①+③+④。
- 超时:短时任务即将超时时,系统会回调应用,应用需要取消短时任务。如果超时不取消,系统会终止对应的应用进程。
接口和导入模块
- import backgroundTaskManager from '@ohos.resourceschedule.backgroundTaskManager';
- import { BusinessError } from '@ohos.base';
接口名 | 描述 |
requestSuspendDelay(reason: string, callback: Callback<void>): DelaySuspendInfo | 申请短时任务。 |
getRemainingDelayTime(requestId: number): Promise<number> | 获取对应短时任务的剩余时间。 |
cancelSuspendDelay(requestId: number): void | 取消短时任务。 |
长时任务
应用退至后台后,在后台需要长时间运行用户可感知的任务,如播放音乐、导航等。为防止应用进程被挂起,导致对应功能异常,可以申请长时任务,使应用在后台长时间运行。
申请长时任务后,系统会做相应的校验,确保应用在执行相应的长时任务。同时,系统有与长时任务相关联的通知栏消息,用户删除通知栏消息时,系统会自动停止长时任务。
- 申请了DATA_TRANSFER(数据传输)的长时任务,系统仅会提升应用进程的优先级,降低系统终止应用进程的概率,但仍然会挂起对应的应用进程。对于上传下载对应的功能,需要调用系统上传下载代理接口托管给系统执行。
约束与限制
- 申请限制:Stage模型中,长时任务仅支持UIAbility申请;FA模型中,长时任务仅支持ServiceAbility申请。
- 数量限制:一个UIAbility(FA模型则为ServiceAbility)同一时刻仅支持申请一个长时任务,即在一个长时任务结束后才可能继续申请。如果一个应用同时需要申请多个长时任务,需要创建多个UIAbility;一个应用的一个UIAbility申请长时任务后,整个应用下的所有进程均不会被挂起。
- 运行限制:在手机产品上,系统会进行长时任务校验。
场景1:若应用申请了长时任务,但未真正执行申请类型的长时任务或申请类型的任务已结束,系统会对应用进行管控。例如系统检测到应用申请了AUDIO_PLAYBACK(音频播放),但实际未播放音乐,系统则会终止对应的进程。
场景2:若应用没有申请对应的长时任务类型,但执行了相关类型的长时任务,系统会对应用进行管控。例如系统检测到应用只申请了AUDIO_PLAYBACK(音频播放),但实际上除了播放音乐(对应AUDIO_PLAYBACK类型),还在进行录音(对应AUDIO_RECORDING类型),系统会对应用进行管控。
场景3:若运行长时任务的进程后台负载持续高于所申请类型的典型负载,系统会对应用进行管控。
接口和导入模块
- import backgroundTaskManager from '@ohos.resourceschedule.backgroundTaskManager';
- import wantAgent, { WantAgent } from '@ohos.app.ability.wantAgent';
- 需要申请ohos.permission.KEEP_BACKGROUND_RUNNING权限
接口名 | 描述 |
startBackgroundRunning(context: Context, bgMode: BackgroundMode, wantAgent: WantAgent): Promise<void> | 申请长时任务 |
stopBackgroundRunning(context: Context): Promise<void> | 取消长时任务 |
延迟任务
应用退至后台后,需要执行实时性要求不高的任务,例如有网络时不定期主动获取邮件等,可以使用延迟任务。当应用满足设定条件(包括网络类型、充电类型、存储状态、电池状态、定时状态等)时,将任务添加到执行队列,系统会根据内存、功耗、设备温度、用户使用习惯等统一调度拉起应用。
延迟任务实现原理

当满足调度条件或调度结束时,系统会回调应用WorkSchedulerExtensionAbility中 onWorkStart() 或 onWorkStop() 的方法,同时会为应用单独创建一个Extension扩展进程用以承载WorkSchedulerExtensionAbility,并给WorkSchedulerExtensionAbility一定的活动周期,开发者可以在对应回调方法中实现自己的任务逻辑。
约束与限制
- 数量限制:一个应用同一时刻最多申请10个延迟任务。
- 执行频率限制:系统对延迟任务做分级管控,限制延迟任务调度的执行频率。通过能效资源接口申请了WORK_SCHEDULER资源的应用,会被放在能效资源豁免分组中。
- 超时:WorkSchedulerExtensionAbility单次回调最长运行2分钟。如果超时不取消,系统会终止对应的Extension进程。对于系统特权应用,可以通过能效资源接口申请WORK_SCHEDULER资源,扩展单次回调运行时长,扩展后在充电状态下为20分钟,非充电状态下为10分钟。
- 调度延迟:系统会根据内存、功耗、设备温度、用户使用习惯等统一调度,如当系统内存资源不足或温度达到一定挡位时,系统将延迟调度该任务。
- WorkSchedulerExtensionAbility接口调用限制:为实现对WorkSchedulerExtensionAbility能力的管控,在WorkSchedulerExtensionAbility中限制以下接口的调用:
接口和导入模块
开发步骤
- 延迟任务调度扩展能力:实现WorkSchedulerExtensionAbility开始和结束的回调接口。
- 延迟任务调度:调用延迟任务接口,实现延迟任务申请、取消等功能。
延迟任务调度
- import workScheduler from '@ohos.resourceschedule.workScheduler';
- import { BusinessError } from '@ohos.base';
延迟任务主要接口
接口名 | 接口描述 |
startWork(work: WorkInfo): void; | 申请延迟任务 |
stopWork(work: WorkInfo, needCancel?: boolean): void; | 取消延迟任务 |
getWorkStatus(workId: number, callback: AsyncCallback<Array<WorkInfo>>): void; | 获取延迟任务状态(Callback形式) |
getWorkStatus(workId: number): Promise<WorkInfo>; | 获取延迟任务状态(Promise形式) |
obtainAllWorks(callback: AsyncCallback<Array<WorkInfo>>): void; | 获取所有延迟任务(Callback形式) |
obtainAllWorks(): Promise<Array<WorkInfo>>; | 获取所有延迟任务(Promise形式) |
stopAndClearWorks(): void; | 停止并清除任务 |
isLastWorkTimeOut(workId: number, AsyncCallback<boolean>): void; | 获取上次任务是否超时(针对RepeatWork,Callback形式) |
isLastWorkTimeOut(workId: number): Promise<boolean>; | 获取上次任务是否超时(针对RepeatWork,Promise形式) |
WorkInfo参数
- workId、bundleName、abilityName为必填项,bundleName需为本应用包名。
- 携带参数信息仅支持number、string、boolean三种类型。
- 至少设置一个满足的条件,包括网络类型、充电类型、存储状态、电池状态、定时状态等。
- 对于重复任务,任务执行间隔至少20分钟。设置重复任务时间间隔时,须同时设置是否循环或循环次数中的一个。
延迟任务回调
- import WorkSchedulerExtensionAbility from '@ohos.WorkSchedulerExtensionAbility';
- import workScheduler from '@ohos.resourceschedule.workScheduler';
延迟任务回调接口
接口名 | 接口描述 |
onWorkStart(work: workScheduler.WorkInfo): void | 延迟调度任务开始的回调 |
onWorkStop(work: workScheduler.WorkInfo): void | 延迟调度任务结束的回调 |
代理提醒
应用退到后台或进程终止后,仍然有一些提醒用户的定时类任务,例如购物类应用抢购提醒等,为满足此类功能场景,系统提供了代理提醒(reminderAgentManager)的能力。当应用退至后台或进程终止后,系统会代理应用做相应的提醒。当前支持的提醒类型包括:倒计时、日历和闹钟。
- 倒计时类:基于倒计时的提醒功能。
- 日历类:基于日历的提醒功能。
- 闹钟类:基于时钟的提醒功能。
约束与限制
- 个数限制:一个第三方应用支持最多30个有效提醒(有效即发布成功),一个系统应用支持最多10000个有效提醒,整个系统最多支持12000个有效提醒。
- 跳转限制:点击提醒通知后跳转的应用必须是申请代理提醒的本应用。
接口和导入模块
- 申请ohos.permission.PUBLISH_AGENT_REMINDER权限。
- 使能通知开关。获得用户授权后,才能使用代理提醒功能。
- 导入模块
- import reminderAgentManager from '@ohos.reminderAgentManager';
- import notificationManager from '@ohos.notificationManager';
接口名 | 描述 |
publishReminder(reminderReq: ReminderRequest): Promise<number> | 发布一个定时提醒类通知。 |
cancelReminder(reminderId: number): Promise<void> | 取消一个指定的提醒类通知。 |
getValidReminders(): Promise<Array<ReminderRequest>> | 获取当前应用设置的所有有效的提醒。 |
cancelAllReminders(): Promise<void> | 取消当前应用设置的所有提醒。 |
addNotificationSlot(slot: NotificationSlot): Promise<void> | 注册一个提醒类需要使用的通知通道(NotificationSlot)。 |
removeNotificationSlot(slotType: notification.SlotType): Promise<void> | 删除指定的通知通道(NotificationSlot)。 |