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() {
                    @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() {
                    @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() {
                    @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);
    }

你可能感兴趣的:(Jetpack使用(六) WorkManager的4种用法)