1. WorkManager 概述与核心优势

WorkManager 是 Google 推出的 Android 后台任务调度库，属于 Jetpack 家族成员。它旨在替代所有临时性的后台任务方案，为需要保证执行的异步任务提供统一的、电量友好的调度接口——无论应用进程是否存活、设备是否重启。

1.1 解决的问题

Android 系统对后台执行有着越来越严格的限制（如 Doze、App Standby、后台限制等）。传统方案常在这些场景下失效，而 WorkManager 通过组合系统级 JobScheduler、Firebase JobDispatcher 等底层机制，自动适配不同 API 级别，保证任务在约束满足后一定被执行。

  • 一次性与周期性：支持一次性任务和可配置的周期性任务。
  • 链式依赖：可以将多个任务组成链式工作流，前序成功才执行后续。
  • 约束灵活：支持网络状态、电量、存储空间、空闲时间等触发条件。
  • 进程存活保障：即使应用被杀死或设备重启，已入队的任务仍会被重新调度。
  • 生命周期感知：自动与 Lifecycle 组件协作，避免在 Activity/Fragment 销毁后执行无用操作。
设计理念：WorkManager 不是“立即执行”的库，它保证任务“最终一定会执行”，适合日志上传、数据同步、内容预缓存等场景。

1.2 与 JobScheduler / JobIntentService 对比

对比维度WorkManagerJobSchedulerJobIntentService
最低 APIAPI 14+（内部适配）API 21+API 26+（建议替代）
进程保护系统重启后恢复需加 RECEIVE_BOOT_COMPLETED重启后失效
链式任务原生支持需自行实现不支持
约束条件丰富（网络、电量、空闲等）基本网络与空闲无约束系统
电量优化内置 Doze 兼容部分兼容不兼容 Doze
使用复杂度低，面向声明式 API中等，需手动管理组件高，Service 模式繁琐
迁移提示：如果项目中仍在使用 JobIntentService，建议尽快迁移到 WorkManager。Android 13 已标记其为废弃，未来版本可能移除。

1.3 核心概念：Worker / WorkRequest / WorkManager

三个核心类构成了 WorkManager 的基本执行模型：

  • Worker：定义具体执行逻辑的抽象类。开发者需重写 doWork() 方法，返回 Result.success()、retry() 或 failure()。
  • WorkRequest：描述一次任务的执行计划，包含 Worker 类、约束条件、输入数据、重试策略等。常用子类 OneTimeWorkRequest 和 PeriodicWorkRequest。
  • WorkManager：调度入口。通过 getInstance(context) 获取实例，调用 enqueue(request) 提交任务。
WorkManager 核心执行流程 WorkManager 核心执行流程 应用代码 Worker 类 WorkRequest 约束条件 WorkManager.enqueue() 系统调度执行 结果回调 组合 注意：系统调度会根据约束条件、电量状态、设备空闲情况决定实际执行时机

1.4 入门依赖配置

在模块级 build.gradle 中加入如下依赖：

// 模块的 build.gradle (app)
dependencies {
    // WorkManager 核心库 (Java)
    implementation "androidx.work:work-runtime:2.9.1"
    
    // 如果使用 Kotlin，可选 kotlin 扩展库（含协程支持）
    // implementation "androidx.work:work-runtime-ktx:2.9.1"
}

同步 Gradle 后即可使用。建议同时启用 work-runtime-ktx 以使用协程版 Worker（CoroutineWorker）。

版本要求：WorkManager 最低支持 API 14（Android 4.0+），在 API 23+ 会使用 JobScheduler 作为底层引擎，API 14~22 则使用 AlarmManager + BroadcastReceiver 组合。所有细节由库自动适配，开发者无需关心。

1.5 第一个示例：声明并运行一个简单任务

创建一个继承 Worker 的类，并在 Application 或 Activity 中入队：

// 1. 定义 Worker
public class MyWorker extends Worker {
    public MyWorker(@NonNull Context context, @NonNull WorkerParameters params) {
        super(context, params);
    }

    @NonNull
    @Override
    public Result doWork() {
        // 这里执行后台任务，比如上传日志
        Log.d("WorkManager", "任务正在后台执行");
        return Result.success();
    }
}

// 2. 创建 WorkRequest 并入队
OneTimeWorkRequest request = new OneTimeWorkRequest.Builder(MyWorker.class)
        .addTag("upload_log")
        .build();

WorkManager.getInstance(context).enqueue(request);

enqueue 返回后，WorkManager 会确保任务在满足约束时尽快执行。若进程被杀，系统会在合适时机重新调度。

1.6 常见问题与调试

  • 任务未执行：检查是否添加了必要的权限？Doze 模式下任务会延迟。使用 WorkManager.getWorkInfosByTag() 查询状态。
  • 周期性任务初始延迟：PeriodicWorkRequest 有一个最小间隔（15 分钟），首次执行可能延后。使用 setInitialDelay() 控制。
  • 调试建议：在测试时可通过 adb shell dumpsys jobscheduler 或 adb shell am broadcast -a android.intent.action.BOOT_COMPLETED 强制触发系统调度。
← 上一章 📖 返回目录 下一章 →