原生移动开发 / 系统课时

给任务添加执行约束

给任务添加执行约束

本篇解决“任务什么时候才允许执行”的问题。你将用 WorkManager 的 Constraints 限制网络、充电和存储条件,让后台任务避开明显不合适的运行时机,并能验证约束是否按预期生效。

学习目标

  • 能为 WorkManager 任务设置网络、充电和存储约束
  • 能理解多个约束同时存在时的执行条件
  • 能根据任务性质选择合适的约束,而不是无差别限制

用 Constraints 描述执行前提

Constraints 表示任务开始执行前必须满足的系统条件。常见条件包括网络类型、是否正在充电、设备存储空间是否不足等。约束不是触发任务的时间表,而是对“当前能不能开始”的额外限制。

多个约束会同时生效。比如同时要求网络已连接、设备正在充电、存储空间不低,那么这三个条件都满足后,任务才具备执行资格。某个条件后来不满足,并不等于已经运行的 Worker 会立刻被强制终止;约束主要用于控制任务的启动时机。

配置网络、充电和存储条件

下面示例创建一个需要联网、仅在充电时运行,并要求设备存储空间未处于低容量状态的 Worker。CoroutineWorker 依赖具体 AndroidX WorkManager 项目上下文,因此这是可直接放入 Android 项目的完整类示例。

kotlin
import android.content.Context
import androidx.work.Constraints
import androidx.work.CoroutineWorker
import androidx.work.NetworkType
import androidx.work.WorkerParameters
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.withContext

class UploadWorker(
    appContext: Context,
    workerParams: WorkerParameters
) : CoroutineWorker(appContext, workerParams) {

    override suspend fun doWork(): Result = withContext(Dispatchers.IO) {
        // 真正的上传逻辑应放在这里,约束只负责决定何时可以开始。
        Result.success()
    }
}

val constraints = Constraints.Builder()
    .setRequiredNetworkType(NetworkType.CONNECTED)
    .setRequiresCharging(true)
    .setRequiresStorageNotLow(true)
    .build()

预期结果

text
代码可在 AndroidX WorkManager 项目中编译;constraints 表示任务必须同时满足“网络已连接、正在充电、存储空间不低”后才具备启动条件。

实际创建请求时,需要把这个 constraints 交给 WorkRequest,例如:

kotlin
import androidx.work.OneTimeWorkRequestBuilder

val request = OneTimeWorkRequestBuilder<UploadWorker>()
    .setConstraints(constraints)
    .build()

预期结果

text
得到一个带有约束条件的 OneTimeWorkRequest;WorkManager 只有在约束满足时才会尝试启动 UploadWorker。

不同任务选择不同约束

约束应该服务于业务要求,而不是“越多越安全”。需要立即处理但可离线执行的本地整理任务,不应强制要求网络;大型备份通常更适合增加充电和网络条件;对存储空间敏感的任务可以增加 setRequiresStorageNotLow(true)。

任务类型 网络 充电 存储空间不低
上传日志 通常需要 可选 通常可选
大文件备份 通常需要 常见 常见
本地数据清理 通常不需要 可选 可选

约束没有满足时会怎样

当请求已经入队但条件不满足时,WorkManager 可以让任务保持等待,而不是让 Worker 立即执行。例如设备未充电时,设置了 setRequiresCharging(true) 的任务不会因为已经调用 enqueue() 就直接运行。等系统检测到条件满足后,任务才进入实际执行阶段。

排查“任务为什么没有运行”时,应先检查约束本身,再检查任务是否已经入队。可以通过 WorkManager 的任务状态观察接口或 Android Studio 调试环境确认当前请求是否仍处于等待约束的状态。

合理设置约束的核心是把业务要求翻译成明确的系统前提:必须联网、必须充电、必须有足够存储空间分别对应不同条件。这样任务既不会在明显不合适的环境下启动,也不会因为无关限制而长期等待。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

给任务添加执行约束

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通