Android--Jetpack--WorkManager详解

2024已经到来,愿你安睡时,山河入梦。愿你醒来时,满目春风。愿你欢笑时,始终如一。愿你行进时,前程似锦,坦荡从容。

编程语言的未来?

目录

一,定义

二,特点

三,作用

四,角色

五,简单使用

1,添加依赖

2,创建自己的worler并继承worker

3,在activity中使用

4,点击按钮输出如下

 六,数据传递

1,创建worker

2,在activity中使用

3,点击按钮输出如下

 七,多个任务顺序执行

1,创建三个worker

2,在activity中使用

3,点击按钮输出如下

八,重复执行后台任务

九,添加约束条件


一,定义

WorkManager是Android Jetpack的一部分,开发中,我们的任务不可能总是在前台,但是还要确保那些重要任务的执行,我们就可以放置 在后台执行,那么WorkManager就能够发挥其作用了。 它适用于需要保证系统即使应用程序退出也会运行的任务,WorkManager API可以轻松指定可延迟的 异步任务以及何时运行它们,这些API允许您创建任务并将其交给WorkManager立 即运行或在适当的时间运行。 WorkManager根据设备API级别和应用程序状态等因素选择适当的方式来运行任 务。如果WorkManager在应用程序运行时执行您的任务之一,WorkManager可以 在您应用程序进程的新线程中运行您的任务。如果您的应用程序未运行, WorkManager会选择一种合适的方式来安排后台任务 - 具体取决于设备API级别和包 含的依赖项,WorkManager可能会使用 JobScheduler,Firebase JobDispatcher或 AlarmManager

二,特点

1,支持异步一次性和定期任务

2,支持网络条件,存储空间和充电状态等约束

3,链接复杂的工作请求,包括并行运行工作

4,一个工作请求的输出用作下一个工作的输入

5,将API级别的兼容性处理回API级别14(请参阅注释)

6,可以使用或不使用Google Play服务

7,遵循系统健康最佳实践

8,LiveData支持可轻松在UI中显示工作请求状态

三,作用

1,确保重要的后台任务,一定会被执行,后台任务(例如:非及时性的 (请求服 务器 及时性) 上传,下载,同步数据 等)

2,内部对电量进行了优化,不需要我们去处理电量优化了

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

4,注意:WorkManager不能做保活操作

5,调度,管理,执行的后台任务的场景,通常是是可延迟的后台任务

四,角色

1,Worker:指定需要执行的任务,可以成为Workder类的子类,在实现的方法中,就可以执行任务逻辑了

2,WorkRequest:执行一项单一的任务

①:WorkRequest对象必须指定Work执行的任务

②:WorkRequest都有一个自动生成的唯一ID,可以使用ID执行取消 排队任务 或 获取任务状态等操作

③:WorkRequest是一个抽象的类;系统默认实现子类 OneTimeWorkRequest或PeriodicWorkRequest

④:WorkRequest.Builder创建WorkRequest对象;相应的子类: OneTimeWorkRequest.Builder或PeriodicWorkRequest.Builder

⑤:Constraints:指定对任务运行时间的限制(任务约束);使用 Constraints.Builder创建Constraints对象 ,并传递给WorkRequest.Builder

3,WorkManager:排队和管理工作请求;将WorkRequest 对象传递WorkManager的 任务队列

(注意:如果未指定任何约束, WorkManager立即运行任务)

4,WorkStatus:包含有关特定任务的信息;可以使用LiveData保存 WorkStatus对象, 监听任务状态;如LiveData

五,简单使用

1,添加依赖

implementation "androidx.work:work-runtime:2.7.1"

2,创建自己的worler并继承worker

public class YZWorker1 extends Worker {


    public YZWorker1(@NonNull Context context, @NonNull WorkerParameters workerParams) {
        super(context, workerParams);
    }
    
    
    //后台执行的任务 并且是异步的
    @NonNull
    @Override
    public Result doWork() {
        System.out.println("YZWorker1:执行后台任务");
        //成功就返回success  失败返回failure
        return Result.success();
    }
}

3,在activity中使用




    

public class MainActivity extends AppCompatActivity {

    private TextView txt1;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        txt1 = findViewById(R.id.txt_1);

        txt1.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                OneTimeWorkRequest oneTimeWorkRequest =
                        new OneTimeWorkRequest.Builder(YZWorker1.class).build();
                WorkManager.getInstance(MainActivity.this).enqueue(oneTimeWorkRequest);
            }
        });
    }
}

4,点击按钮输出如下

 

 六,数据传递

实现activity和worker的数据传递:

1,创建worker

public class YZWorker2 extends Worker {

    private Context mContext;
    private WorkerParameters workerParams;

    public YZWorker2(@NonNull Context context, @NonNull WorkerParameters workerParams) {
        super(context, workerParams);
        this.mContext = context;
        this.workerParams = workerParams;
    }

    @SuppressLint("RestrictedApi")
    @NonNull
    @Override
    public Result doWork() {
        // 接收 MainActivity传递过来的数据
        String data = workerParams.getInputData().getString("YuanZhen");
        System.out.println("YZWorker2:Activity传递过来的数据:"+data);

        // 把任务中的数据回传到activity中
        Data outputData = new Data.Builder().putString("YuanZhen", "我是worker2的数据").build();
        Result.Success success = new Result.Success(outputData);
        
        return success;
    }
}

2,在activity中使用




    

    

public class MainActivity extends AppCompatActivity {

   
    private TextView txt2;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
      
        txt2 =findViewById(R.id.txt_2);

       
        txt2.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {

                // 数据
                Data sendData = new Data.Builder().putString("YuanZhen", "我是MainActivity的数据").build();

                // 请求对象初始化
                OneTimeWorkRequest oneTimeWorkRequest = new OneTimeWorkRequest.Builder(YZWorker2.class)
                        .setInputData(sendData)
                        .build();

                // 想接收任务回馈的数据,需要状态机
                WorkManager.getInstance(MainActivity.this).getWorkInfoByIdLiveData(oneTimeWorkRequest.getId())
                        .observe(MainActivity.this, workInfo -> {
                            System.out.println("MainActivity:当前状态:"+workInfo.getState().name());
                            if (workInfo.getState().isFinished()) {
                                // 状态机 成功的时候 才去打印
                                System.out.println("MainActivity:取到了任务回传的数据:"+workInfo.getOutputData().getString("YuanZhen"));
                            }
                        });
                WorkManager.getInstance(MainActivity.this).enqueue(oneTimeWorkRequest);
            }
        });


    }
}

3,点击按钮输出如下

 

 七,多个任务顺序执行

1,创建三个worker

public class YZWorker3 extends Worker {

    public YZWorker3(@NonNull Context context, @NonNull WorkerParameters workerParams) {
        super(context, workerParams);
    }

    @NonNull
    @Override
    public Result doWork() {
        System.out.println("YZWorker3:执行了");
        return Result.success();
    }
}
public class YZWorker4 extends Worker {

    public YZWorker4(@NonNull Context context, @NonNull WorkerParameters workerParams) {
        super(context, workerParams);
    }

    @NonNull
    @Override
    public Result doWork() {
        System.out.println("YZWorker4:执行了");
        return Result.success();
    }
}
public class YZWorker5 extends Worker {

    public YZWorker5(@NonNull Context context, @NonNull WorkerParameters workerParams) {
        super(context, workerParams);
    }

    @NonNull
    @Override
    public Result doWork() {
        System.out.println("YZWorker5:执行了");
        return Result.success();
    }
}

2,在activity中使用




    

    

    

public class MainActivity extends AppCompatActivity {

 
    private TextView txt3;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
       
        txt3 =findViewById(R.id.txt_3);

       

        txt3.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                // 单一的任务  一次
                OneTimeWorkRequest oneTimeWorkRequest3 = new OneTimeWorkRequest.Builder(YZWorker3.class).build();
                OneTimeWorkRequest oneTimeWorkRequest4 = new OneTimeWorkRequest.Builder(YZWorker4.class).build();
                OneTimeWorkRequest oneTimeWorkRequest5 = new OneTimeWorkRequest.Builder(YZWorker5.class).build();

                // 顺序执行 3 4 5
                WorkManager.getInstance(MainActivity.this)
                        .beginWith(oneTimeWorkRequest3)
                        .then(oneTimeWorkRequest4)
                        .then(oneTimeWorkRequest5)
                        .enqueue();
            }
        });


    }
}

3,点击按钮输出如下

Android--Jetpack--WorkManager详解_第1张图片

八,重复执行后台任务

public class MainActivity extends AppCompatActivity {


    private TextView txt4;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
      
        txt4 =findViewById(R.id.txt_4);

       

        txt4.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                // 不能小于15分钟,否则默认修改成 15分钟
                PeriodicWorkRequest periodicWorkRequest
                        = new PeriodicWorkRequest.Builder(YZWorker5.class, 10, TimeUnit.SECONDS).build();

                // 一直都是 ENQUEUE,因为是轮询的任务,所以看不到 SUCCESS  如果是单个任务,就会看到SUCCESS
                WorkManager.getInstance(MainActivity.this).getWorkInfoByIdLiveData(periodicWorkRequest.getId())
                        .observe(MainActivity.this, new Observer() {
                            @Override
                            public void onChanged(WorkInfo workInfo) {
                                System.out.println("MainAcitvity状态:"+workInfo.getState().name());
                                if (workInfo.getState().isFinished()) {
                                    System.out.println("MainAcitvity状态:isFinished=true");
                                }
                            }
                        });

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


    }
}

九,添加约束条件

public class MainActivity extends AppCompatActivity {



    private TextView txt5;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
       
        txt5 =findViewById(R.id.txt_5);

       
        txt5.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                // 约束条件,必须满足条件,才能执行后台任务
                Constraints constraints = new Constraints.Builder()
                        .setRequiredNetworkType(NetworkType.CONNECTED) // 网络连接
                        .setRequiresCharging(true) // 充电
                        .build();

     
                OneTimeWorkRequest request = new OneTimeWorkRequest.Builder(YZWorker3.class)
                        .setConstraints(constraints)
                        .build();

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

    }
}

你可能感兴趣的:(android-jetpack,android,worker,jetpack,java)