Android Academy · 课时

创建 Worker

Q: 「创建 Worker」这节课中我会学到什么？

在 Worker 中定义后台任务 你通过在浏览器中直接运行的动手代码来练习 Android Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

在 Worker 中定义后台任务

创建 Worker 是 CoddyKit 上的免费 Android Academy 课时。这是第 2 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Android Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Android Academy 课程共包含 4 节课。

创建 Worker

WorkManager 中后台工作的单元是Worker。您可以通过继承 Worker 基类并重写其工作方法来定义任务。

CoroutineWorker

对于 Kotlin，请继承CoroutineWorker。它的 doWork() 是一个 suspend 函数，因此您可以调用其他挂起函数，并自然地在后台调度器上运行。

class UploadWorker(
    context: Context,
    params: WorkerParameters
) : CoroutineWorker(context, params) {
    override suspend fun doWork(): Result {
        // background work here
        return Result.success()
    }
}

构造函数

每个工作者的构造函数都接收 Context 和 WorkerParameters，并将它们传递给超类。WorkManager 会为您实例化工作者；您无需直接调用构造函数。

doWork 返回 Result

doWork() 必须返回一个用于描述结果的 Result。共有三种可能。

Result.success()
Result.retry()
Result.failure()

Result.success

工作完成后返回 Result.success()。该工作会从队列中移除。您可以附加输出数据，将其传递给链式工作。

override suspend fun doWork(): Result {
    uploadLogs()
    return Result.success()
}

Result.retry

遇到暂时性故障时返回 Result.retry()，例如临时网络错误。WorkManager 会根据其退避策略稍后重新运行该工作者。

override suspend fun doWork(): Result {
    return try {
        syncData()
        Result.success()
    } catch (e: IOException) {
        Result.retry()
    }
}

Result.failure

对于重试也无法解决的永久性故障，请返回 Result.failure()，例如输入无效。该工作会停止，依赖它的链式工作也不会运行。

读取输入数据

入队时通过 Data 传递少量输入数据，并在工作者内部使用 inputData 读取。请保持数据量较小；它不适合承载大型数据。

override suspend fun doWork(): Result {
    val userId = inputData.getString("user_id") ?: return Result.failure()
    sync(userId)
    return Result.success()
}

返回输出数据

工作者可以在其结果中返回 Data，链式工作者会将其作为输入接收。这就是在各个步骤之间传递结果的方式。

val output = workDataOf("count" to 42)
return Result.success(output)

在正确的调度器上运行工作

CoroutineWorker 默认会在 Dispatchers.Default 上运行 doWork()。对于阻塞式 I/O，请使用 withContext(Dispatchers.IO) 切换调度器，以免耗尽默认线程池。

override suspend fun doWork(): Result = withContext(Dispatchers.IO) {
    readAndUploadFile()
    Result.success()
}

保持工作者自包含

工作者可能在完成调度很久之后、在全新的进程中运行。请不要依赖内存中的应用状态；通过输入数据传递所需内容，或从持久化存储中读取。

快速检查

请测试您对创建 Worker 的理解。

回顾

您创建了一个 Worker：

继承 CoroutineWorker 并重写挂起函数 doWork()
返回 Result.success()、Result.retry() 或 Result.failure()
读取 inputData 并返回输出 Data
对阻塞式工作使用 Dispatchers.IO；保持工作者自包含

下一步：约束条件与调度。

常见问题解答

「创建 Worker」课时是免费的吗？

是的 — 「创建 Worker」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Android Academy 课程的其余内容，请升级到 CoddyKit PRO。 Android Academy 课程共包含 4 节课。

「创建 Worker」这节课中我会学到什么？

在 Worker 中定义后台任务你通过在浏览器中直接运行的动手代码来练习 Android Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Android Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Android Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 2 节课，共 4 节。

「创建 Worker」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Android Academy 课中编写并运行代码吗？

能。每节 Android Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Android Academy