原生移动开发 / 系统课时
串联存在依赖的后台任务
串联存在依赖的后台任务
当后台工作不是“各跑各的”,而是必须先完成上传、再处理结果、最后清理本地数据时,需要明确表达阶段依赖。本篇使用 WorkContinuation 串联多个 Worker,并通过 Data 把前一阶段的结果安全传给下一阶段。
学习目标
- 理解
WorkContinuation如何表达顺序、分支与汇合关系 - 使用
then串联有依赖的OneTimeWorkRequest - 使用
Data在 Worker 之间传递有限、可序列化的结果
用 WorkContinuation 表达任务依赖
WorkContinuation 可以把多个一次性任务组织成一条执行链。最常见的方式是先用 beginWith() 创建起点,再用 then() 添加后续任务。这样定义的不是简单的代码调用顺序,而是 WorkManager 保存下来的任务依赖关系。
例如,一个离线同步流程可以拆成“上传文件 → 处理服务端结果 → 删除本地临时文件”三个阶段。只有前一步成功,后一步才应继续执行。

串联 Worker 并传递结果
下面的示例使用三个 Worker。第一个生成一个任务标识,第二个读取该标识并处理,第三个根据处理状态执行清理。为了让示例可直接运行,三个 Worker 均采用 CoroutineWorker。
import android.content.Context
import androidx.work.CoroutineWorker
import androidx.work.Data
import androidx.work.OneTimeWorkRequestBuilder
import androidx.work.WorkManager
import androidx.work.WorkerParameters
class UploadWorker(
appContext: Context,
params: WorkerParameters
) : CoroutineWorker(appContext, params) {
override suspend fun doWork(): Result {
val uploadId = "upload-<ID>"
return Result.success(
Data.Builder()
.putString("uploadId", uploadId)
.build()
)
}
}
class ProcessWorker(
appContext: Context,
params: WorkerParameters
) : CoroutineWorker(appContext, params) {
override suspend fun doWork(): Result {
val uploadId = inputData.getString("uploadId")
?: return Result.failure()
val status = "processed:$uploadId"
return Result.success(
Data.Builder()
.putString("status", status)
.build()
)
}
}
class CleanupWorker(
appContext: Context,
params: WorkerParameters
) : CoroutineWorker(appContext, params) {
override suspend fun doWork(): Result {
val status = inputData.getString("status")
?: return Result.failure()
println("cleanup status=$status")
return Result.success()
}
}
fun enqueueChain(context: Context) {
val upload = OneTimeWorkRequestBuilder<UploadWorker>().build()
val process = OneTimeWorkRequestBuilder<ProcessWorker>().build()
val cleanup = OneTimeWorkRequestBuilder<CleanupWorker>().build()
WorkManager.getInstance(context)
.beginWith(upload)
.then(process)
.then(cleanup)
.enqueue()
}预期结果:
cleanup status=processed:upload-<ID>这里需要注意一个关键点:Result.success(Data) 会把输出数据写入前一个 Worker 的 outputData,但后续 Worker 不会因为使用 then() 就自动拥有这些字段。要把前置输出合并为后续输入,应使用 WorkContinuation 的输入合并能力,例如在链开始时指定 InputMerger,或者显式设计任务之间的数据衔接方式。
在简单的一对一依赖中,也可以直接让后续任务读取经过输入合并后的字段。对于并行任务汇合,则更值得关注 ArrayCreatingInputMerger 等输入合并策略,因为多个前置 Worker 可能同时产生同名或同类型数据。
多个前置任务如何汇合
当任务存在“并行完成后再继续”的关系时,可以先分别创建两个 WorkContinuation,再使用 WorkContinuation.combine() 汇合,之后通过 then() 继续执行。这个模型适合例如“上传元数据”和“上传文件”都完成后再提交最终确认。
import android.content.Context
import androidx.work.OneTimeWorkRequestBuilder
import androidx.work.WorkManager
fun enqueueCombined(context: Context) {
val metadata = OneTimeWorkRequestBuilder<UploadMetadataWorker>().build()
val file = OneTimeWorkRequestBuilder<UploadFileWorker>().build()
val finalize = OneTimeWorkRequestBuilder<FinalizeWorker>().build()
val workManager = WorkManager.getInstance(context)
val metadataChain = workManager.beginWith(metadata)
val fileChain = workManager.beginWith(file)
WorkContinuation
.combine(metadataChain, fileChain)
.then(finalize)
.enqueue()
}片段示例:上述代码依赖项目中已经定义 UploadMetadataWorker、UploadFileWorker 和 FinalizeWorker,这里只演示组合关系,不单独提供这些 Worker 的实现。
预期结果:
UploadMetadataWorker ─┐
├─> FinalizeWorker
UploadFileWorker ────┘combine() 表达的是依赖汇合,而不是保证两个 Worker 按固定先后运行。只要业务允许并行,使用这种结构可以避免人为把没有依赖关系的任务串行化。
数据传递的边界
Data 适合传递少量、结构简单的任务元数据,例如字符串、整数、布尔值和有限大小的数组。不要把大文件、数据库记录集或完整二进制内容塞进 Data;后台任务之间应传递文件路径、数据库主键或远端任务 ID,再由下一阶段重新读取真实数据。
还要区分“任务依赖”和“业务成功”。then() 保证后续 Worker 等待前置 Worker 的状态,但你的 Worker 仍需要判断输入是否存在、是否有效,并在临时失败时返回 Result.retry()。这样才能把“依赖已满足”和“业务已经完成”分开处理。
实际项目中,能画成清晰依赖链的后台流程通常更适合拆成多个 Worker;如果几个步骤必须共享复杂的内存状态,则不应强行把所有对象都通过 Data 搬运,而应把共享状态落到持久化存储中。