Jetpack使用（六） WorkManager的4种用法

写在前面：Jetpack的更新速度非常快，可能你一个月前看WorkManager是这样用的，下个月这个使用方法就有可能被废弃了（我看源码的时候是遇到过的，而且源码也变了，但核心原理是不变的），所以我们这一系列文章偏重讲原理，使用就一带而过（因为讲了也没用啊，会变的。。。。。，读者使用最好看官方文档官方文档
，当然我这里讲的也是截止到目前的最新用法）。

Jetpack使用（一）Lifecycles核心原理
Jetpack使用（二）LiveData核心原理
Jetpack使用（三）DataBinding核心原理
Jetpack使用（四）ViewModel核心原理
Jetpack使用（五）Navigation核心原理
Jetpack使用（六） WorkManager的4种用法

WorkManager有什么用：

一：确保重要的后台任务，一定会被执行，后台任务（例如：非及时性的 （请求服务器 及时性） 上传，下载，同步数据 等）

二：内部对电量进行了优化，不需要我们去处理电量优化了

三：API 14 到 最新版本，都可以使用WorkManager来管你你的后台任务

四：注意：WorkManager不能做保活操作

五：调度，管理，执行的后台任务的场景，通常是是可延迟的后台任务

注意：WorkManager之所以能做到这些，其实就是通过使用android系统的服务来管理Room数据库里的任务列表来来完成的。

使用

新建一个后台任务MainWorkManager

/**
 * 后台任务
 */
public class MainWorkManager extends Worker {

    public final static String TAG = MainWorkManager.class.getSimpleName();

    private Context mContext;
    private WorkerParameters workerParams;

    // 有构造函数
    public MainWorkManager(@NonNull Context context, @NonNull WorkerParameters workerParams) {
        super(context, workerParams);
        this.mContext = context;
        this.workerParams = workerParams;
    }

    @SuppressLint("RestrictedApi")
    @NonNull
    @Override
    public Result doWork() {

        Log.d(TAG, "doWork: 后台任务执行了");

        // 接收Activity传递过来的数据
        final String dataString = workerParams.getInputData().getString("wdy");
        Log.d(TAG, "doWork: 接收Activity传递过来的数据:" + dataString);

        // 反馈数据 给 Activity
        // 把任务中的数据回传到activity中
        Data outputData = new Data.Builder().putString("wdy", "三分归元气").build();
        Result.Success success = new Result.Success(outputData);

        // return new Result.Failure(); // 本地执行 doWork 任务时 失败
        // return new Result.Retry(); // 本地执行 doWork 任务时 重试
        // return new Result.Success(); // 本地执行 doWork 任务时 成功 执行任务完毕
        return success;
    }
}

• 1、单一任务和MainActivity互传数据

public void testBackgroundWork1(View view) {

        // 单一的任务  一次
        OneTimeWorkRequest oneTimeWorkRequest1;

        // 数据
        Data sendData = new Data.Builder().putString("wdy", "九阳神功").build();

        // 请求对象初始化
        oneTimeWorkRequest1 = new OneTimeWorkRequest.Builder(MainWorkManager.class)
                .setInputData(sendData) // 数据的携带
                .build();

        WorkManager.getInstance(this).getWorkInfoByIdLiveData(oneTimeWorkRequest1.getId())
                .observe(this, new Observer<WorkInfo>() {
                    @Override
                    public void onChanged(WorkInfo workInfo) {
                        Log.d(MainWorkManager.TAG, "Activity取到了任务回传的数据: " + workInfo.getOutputData().getString("wdy"));

                        Log.d(MainWorkManager.TAG, "状态：" + workInfo.getState().name());
                        if (workInfo.getState().isFinished()) {
                            Log.d(MainWorkManager.TAG, "状态：isFinished=true 后台任务已经完成了...");
                        }
                    }
                });

        // 请求对象 加入到队列
        WorkManager.getInstance(this).enqueue(oneTimeWorkRequest1);
    }

• 2、多个任务

  public void testBackgroundWork2(View view) {
        OneTimeWorkRequest oneTimeWorkRequest2 = new OneTimeWorkRequest.Builder(MainWorkManager2.class).build();
        OneTimeWorkRequest oneTimeWorkRequest3 = new OneTimeWorkRequest.Builder(MainWorkManager3.class).build();
        OneTimeWorkRequest oneTimeWorkRequest4 = new OneTimeWorkRequest.Builder(MainWorkManager4.class).build();
        OneTimeWorkRequest oneTimeWorkRequest5 = new OneTimeWorkRequest.Builder(MainWorkManager5.class).build();

        // 顺序执行
        WorkManager.getInstance(this).beginWith(oneTimeWorkRequest2)
                .then(oneTimeWorkRequest3)
                .then(oneTimeWorkRequest4)
                .then(oneTimeWorkRequest5)
                .enqueue();

      
    }

• 3、重复执行任务

public void testBackgroundWork3(View view) {

        // 重复的任务  多次  循环  , 最少循环重复 15分钟（少于15分钟默认为15分钟）
        PeriodicWorkRequest periodicWorkRequest =
                new PeriodicWorkRequest.Builder(MainWorkManager2.class, 20, TimeUnit.SECONDS).build();

        // 监听状态
        WorkManager.getInstance(this).getWorkInfoByIdLiveData(periodicWorkRequest.getId())
                .observe(this, new Observer<WorkInfo>() {
                    @Override
                    public void onChanged(WorkInfo workInfo) {
                        Log.d(MainWorkManager.TAG, "状态：" + workInfo.getState().name());
                        if (workInfo.getState().isFinished()) {
                            Log.d(MainWorkManager.TAG, "状态：isFinished=true 后台任务已经完成了...");
                        }
                    }
                });

        WorkManager.getInstance(this).enqueue(periodicWorkRequest);
    }

• 4、约束条件

 public void testBackgroundWork4(View view) {

        // 约束条件，必须满足我的条件，才能执行后台任务 （在连接网络，插入电源 并且 处于空闲时）  内部做了电量优化（Android App 不耗电）
        Constraints myConstraints = new Constraints.Builder()
                .setRequiredNetworkType(NetworkType.CONNECTED) // 网络链接中...
                .setRequiresCharging(true) // 充电中..
                .setRequiresDeviceIdle(true) // 空闲时.. (cpu使用率低)
                .build();

        /**
         * 除了上面设置的约束外，WorkManger还提供了以下的约束作为Work执行的条件：
         *  setRequiredNetworkType：网络连接设置
         *  setRequiresBatteryNotLow：是否为低电量时运行 默认false
         *  setRequiresCharging：是否要插入设备（接入电源），默认false
         *  setRequiresDeviceIdle：设备是否为空闲，默认false
         *  setRequiresStorageNotLow：设备可用存储是否不低于临界阈值
         */

        // 请求对象
        OneTimeWorkRequest request = new OneTimeWorkRequest.Builder(MainWorkManager2.class)
                .setConstraints(myConstraints)
                .build();

        // 测试：监听状态
        // 监听状态
        WorkManager.getInstance(this).getWorkInfoByIdLiveData(request.getId())
                .observe(this, new Observer<WorkInfo>() {
                    @Override
                    public void onChanged(WorkInfo workInfo) {
                        Log.d(MainWorkManager.TAG, "状态：" + workInfo.getState().name());
                        if (workInfo.getState().isFinished()) {
                            Log.d(MainWorkManager.TAG, "状态：isFinished=true 后台任务已经完成了...");
                        }
                    }
                });

        // 加入队列
        WorkManager.getInstance(this).enqueue(request);
    }