如何将Android应用中的Evernote Android Job迁移至WorkManager

我来帮你把Evernote Android Job的实现迁移到WorkManager，这俩都是后台任务调度方案，但WorkManager是Jetpack官方推荐的适配方案，能更好地兼容不同Android版本的后台限制。咱们一步步来改造：

1. 先确保引入WorkManager依赖 #

在你的app模块的build.gradle（或build.gradle.kts）里添加WorkManager的依赖，用最新稳定版即可：

dependencies {
    implementation "androidx.work:work-runtime:2.8.1"
}

2. 移除原有的JobManager和JobCreator代码 #

原来的JobManager.create(this).addJobCreator(new MyJob())以及MyJob类都可以直接删掉了——WorkManager不需要通过JobCreator来映射任务标签和实现类，直接使用Worker类即可。

3. 将SyncMasterDataJOB改造为Worker类 #

把原来的Job子类改成WorkManager的Worker子类，核心逻辑迁移到doWork()方法里：

import android.content.Context;
import androidx.work.Worker;
import androidx.work.WorkerParameters;

public class SyncMasterDataWorker extends Worker {
    public static final String TAG = "worker_note_sync";

    // 必须的构造方法，传入上下文和Worker参数
    public SyncMasterDataWorker(Context context, WorkerParameters params) {
        super(context, params);
    }

    @Override
    public Result doWork() {
        // 这里写你原来在onRunJob里的业务逻辑
        // 比如同步主数据的操作

        // 返回结果对应原来的Result.SUCCESS/FAILURE/RETRY
        return Result.success();
    }
}

4. 替换周期性任务的调度逻辑 #

原来的schedulePeriodic()方法需要改成用WorkManager的PeriodicWorkRequest来实现，同时用enqueueUniquePeriodicWork来替代setUpdateCurrent(true)的效果：

import androidx.work.ExistingPeriodicWorkPolicy;
import androidx.work.PeriodicWorkRequest;
import androidx.work.WorkManager;
import java.util.concurrent.TimeUnit;

// 把这个方法放到SyncMasterDataWorker类里即可
public static void schedulePeriodic() {
    try {
        // 创建周期性任务请求
        // 注意：Android 7.0（API 24）及以上系统强制周期性任务最小间隔为15分钟
        // 如果你的原代码是测试用的15秒，实际运行时系统会自动调整为15分钟，测试可以用OneTimeWorkRequest模拟
        PeriodicWorkRequest periodicWork = new PeriodicWorkRequest.Builder(
                SyncMasterDataWorker.class,
                15, TimeUnit.SECONDS, // 任务重复间隔
                5, TimeUnit.SECONDS    // Flex时间：任务可以在间隔结束前的5秒内执行
        ).build();

        // 用enqueueUniquePeriodicWork确保同一TAG的任务只有一个，替换已有任务（对应setUpdateCurrent(true)）
        WorkManager.getInstance(getApplicationContext())
                .enqueueUniquePeriodicWork(
                        TAG,
                        ExistingPeriodicWorkPolicy.REPLACE,
                        periodicWork
                );
    } catch (Exception e) {
        e.printStackTrace();
    }
}

几个关键注意点 #

• 周期性任务最小间隔限制：Android 7.0+系统不允许小于15分钟的周期性后台任务，如果你设置的间隔小于15分钟，系统会自动调整为15分钟。如果是测试场景，可以用OneTimeWorkRequest配合setInitialDelay来模拟短间隔任务。
• 任务唯一性：ExistingPeriodicWorkPolicy.REPLACE会替换掉已存在的同TAG任务，和原来的setUpdateCurrent(true)效果一致；如果想保留原有任务，可用KEEP。
• 参数传递：如果需要给任务传递参数，可以用Data.Builder构建数据，在PeriodicWorkRequest.Builder里调用setInputData()，然后在Worker里通过getInputData()获取，对应原来Job的Params参数。

内容的提问来源于stack exchange，提问作者user