原生移动开发 / 系统课时
给任务添加执行约束
给任务添加执行约束
本篇解决“任务什么时候才允许执行”的问题。你将用 WorkManager 的 Constraints 限制网络、充电和存储条件,让后台任务避开明显不合适的运行时机,并能验证约束是否按预期生效。
学习目标
- 能为 WorkManager 任务设置网络、充电和存储约束
- 能理解多个约束同时存在时的执行条件
- 能根据任务性质选择合适的约束,而不是无差别限制
用 Constraints 描述执行前提
Constraints 表示任务开始执行前必须满足的系统条件。常见条件包括网络类型、是否正在充电、设备存储空间是否不足等。约束不是触发任务的时间表,而是对“当前能不能开始”的额外限制。
多个约束会同时生效。比如同时要求网络已连接、设备正在充电、存储空间不低,那么这三个条件都满足后,任务才具备执行资格。某个条件后来不满足,并不等于已经运行的 Worker 会立刻被强制终止;约束主要用于控制任务的启动时机。
配置网络、充电和存储条件
下面示例创建一个需要联网、仅在充电时运行,并要求设备存储空间未处于低容量状态的 Worker。CoroutineWorker 依赖具体 AndroidX WorkManager 项目上下文,因此这是可直接放入 Android 项目的完整类示例。
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()预期结果
代码可在 AndroidX WorkManager 项目中编译;constraints 表示任务必须同时满足“网络已连接、正在充电、存储空间不低”后才具备启动条件。实际创建请求时,需要把这个 constraints 交给 WorkRequest,例如:
import androidx.work.OneTimeWorkRequestBuilder
val request = OneTimeWorkRequestBuilder<UploadWorker>()
.setConstraints(constraints)
.build()预期结果
得到一个带有约束条件的 OneTimeWorkRequest;WorkManager 只有在约束满足时才会尝试启动 UploadWorker。不同任务选择不同约束
约束应该服务于业务要求,而不是“越多越安全”。需要立即处理但可离线执行的本地整理任务,不应强制要求网络;大型备份通常更适合增加充电和网络条件;对存储空间敏感的任务可以增加 setRequiresStorageNotLow(true)。
| 任务类型 | 网络 | 充电 | 存储空间不低 |
|---|---|---|---|
| 上传日志 | 通常需要 | 可选 | 通常可选 |
| 大文件备份 | 通常需要 | 常见 | 常见 |
| 本地数据清理 | 通常不需要 | 可选 | 可选 |
约束没有满足时会怎样
当请求已经入队但条件不满足时,WorkManager 可以让任务保持等待,而不是让 Worker 立即执行。例如设备未充电时,设置了 setRequiresCharging(true) 的任务不会因为已经调用 enqueue() 就直接运行。等系统检测到条件满足后,任务才进入实际执行阶段。
排查“任务为什么没有运行”时,应先检查约束本身,再检查任务是否已经入队。可以通过 WorkManager 的任务状态观察接口或 Android Studio 调试环境确认当前请求是否仍处于等待约束的状态。
合理设置约束的核心是把业务要求翻译成明确的系统前提:必须联网、必须充电、必须有足够存储空间分别对应不同条件。这样任务既不会在明显不合适的环境下启动,也不会因为无关限制而长期等待。