#码力全开·技术π对#在Android开发中，如何通过WorkManager API高效地处理后台任务？

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

dependencies {
    implementation "androidx.work:work-runtime-ktx:2.9.0" // 推荐最新稳定版
}

class CleanCacheWorker(context: Context, params: WorkerParameters) : CoroutineWorker(context, params) {
    override suspend fun doWork(): Result {
        // 执行后台任务（如清理缓存、网络请求等）
        return try {
            // 任务成功
            Result.success()
        } catch (e: Exception) {
            // 任务失败（可携带重试参数）
            Result.retry()
        }
    }
}

val workRequest = OneTimeWorkRequestBuilder<CleanCacheWorker>()
    .setInitialDelay(15, TimeUnit.MINUTES) // 延迟执行
    .setConstraints( // 设置执行约束（如仅在充电时运行）
        Constraints.Builder()
            .setRequiresCharging(true)
            .build()
    )
    .addTag("cache-cleaner") // 标记任务便于管理
    .build()

val periodicRequest = PeriodicWorkRequestBuilder<DailySyncWorker>(
    24, TimeUnit.HOURS // 最小间隔（需 >= 15分钟）
)
    .setInitialDelay(1, TimeUnit.HOURS) // 首次延迟1小时执行
    .setConstraints(Constraints.Builder().setRequiredNetworkType(NetworkType.CONNECTED).build())
    .build()

val workManager = WorkManager.getInstance(context)

// 提交一次性任务
workManager.enqueue(workRequest)

// 提交周期性任务（需处理已存在的同类任务）
workManager.enqueueUniquePeriodicWork(
    "daily-sync", // 唯一任务名
    ExistingPeriodicWorkPolicy.KEEP, // 冲突时策略（REPLACE、KEEP等）
    periodicRequest
)

workManager.cancelWorkById(workRequest.id) // 按ID取消
workManager.cancelAllWorkByTag("cache-cleaner") // 按标签批量取消

// 顺序执行：A → B → C
WorkManager.getInstance(context).beginWith(workA)
    .then(workB)
    .then(workC)
    .enqueue()

// 并行执行：A + B → C
WorkManager.getInstance(context).beginWith(listOf(workA, workB))
    .then(workC)
    .enqueue()

// 向Worker传递输入数据
val inputData = workDataOf("key" to "value")
OneTimeWorkRequestBuilder<MyWorker>().setInputData(inputData).build()

// 在Worker中获取数据
val input = inputData.getString("key")

// 返回输出数据
Result.success(workDataOf("result" to "done"))