写在前面: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);
}