数据交互
后台任务少不了数据的交互,我们看一下数据是如何传入传出的。
input
先是在 Activity 传数据给 Worker ,我们传一个格式化过的时间过去:
val dateFormat = SimpleDateFormat(“hh:mm:ss”, Locale.getDefault())
val data = Data.Builder()
.putString(“time”, dateFormat.format(Date()))
.build()
val request = OneTimeWorkRequest.Builder(DemoWorker::class.java)
.setInputData(data)
.build()
使用 WorkRequest 的 setInputData 方法传递 Data,Data 的使用和 Bundle 差不多。
在 Worker 中,从 inputData 可以取到数据,这里取到后简单打印一下:
class MainWorker : Worker() {
override fun doWork(): WorkerResult {
Log.d(“WorkManager”, inputData.getString(“time”,“”))
return WorkerResult.SUCCESS
}
}
output
当任务处理完了,需要将处理结果返回。传入的是 inputData,传出就是 outputData:
class MainWorker : Worker() {
override fun doWork(): WorkerResult {
Log.d(“MainWorker”, inputData.getString(“time”,“”))
outputData = Data.Builder()
.putString(“name”, “SouthernBox”)
.build()
return WorkerResult.SUCCESS
}
}
每一个 WorkRequest 都会有一个 id,通过 id 可以获取到对应任务的 WorkStatus,并且是以 LiveData 形式提供的:
WorkManager.getInstance()
.getStatusById(request.id)
.observe(this, Observer { workStatus ->
if (workStatus != null && workStatus.state.isFinished) {
Log.d(“MainActivity”, workStatus.outputData.getString(“name”, “”))
}
})
如果需要取消一个在队列中的任务,也是通过 id 实现的:
WorkManager.getInstance().cancelWorkById(request.id)
这样我们就完成了一个最简单的 WorkManager,执行一下就可以看到打印的结果了。
特性
到目前为止都是基本操作,和一个普通的异步任务没有太大区别,接下来我们看看它不一样的一些地方。
环境约束
WorkManager 允许我们指定任务执行的环境,比如网络已连接、电量充足时等,在满足条件的情况下任务才会执行。
可指定的条件及设置方法如下:
val constraints = Constraints.Builder()
.setRequiredNetworkType(NetworkType.CONNECTED) // 网络状态
.setRequiresBatteryNotLow(true) // 不在电量不足时执行
.setRequiresCharging(true) // 在充电时执行
.setRequiresStorageNotLow(true) // 不在存储容量不足时执行
.setRequiresDeviceIdle(true) // 在待机状态下执行,需要 API 23
.build()
val request = OneTimeWorkRequest.Builder(MainWorker::class.java)
.setConstraints(constraints)
.build()
这个很好理解,除了网络状态,其他设置项都是传入一个布尔值,网络状态可选值如下:
状态 | 说明 |
---|---|
NOT_REQUIRED | 没有要求 |
CONNECTED | 网络连接 |
UNMETERED | 连接无限流量的网络 |
METERED | 连接按流量计费的网络 |
NOT_ROAMING | 连接非漫游网络 |
我们试一下效果,添加一个需要联网的条件,Activity 代码如下:
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
val constraints = Constraints.Builder()
.setRequiredNetworkType(NetworkType.CONNECTED)
.build()
val dateFormat = SimpleDateFormat(“hh:mm:ss”, Locale.getDefault())
val data = Data.Builder()
.putString(“date”, dateFormat.format(Date()))
.build()
val request = OneTimeWorkRequest
.Builder(MainWorker::class.java)
.setConstraints(constraints)
.setInputData(data)
.build()
WorkManager.getInstance().enqueue(request)
WorkManager.getInstance()
.getStatusById(request.id)
.observe(this, Observer { workStatus ->
if (workStatus != null && workStatus.state.isFinished) {
Log.d(“MainActivity”,
workStatus.outputData.getString(“name”, “”))
}
})
}
}
打开应用之前,先把网络关闭,打开后发现 Worker 并没有打印时间,这时候再把网连上,就会看到打印出时间了。
这也是为什么前面说 WorkManager.getInstance().enqueue(request) 是将任务加入任务队列,并不代表马上执行任务,因为任务可能需要等到满足环境条件的情况才会执行。
强大的生命力
还是一样的代码,我们来做点不一样的操作:
- 断网后运行
- 将进程杀掉
- 联网
- 再次运行
不出意外的话,这时候你会看到有两个时间的打印,而且两个时间还不一样,这是为什么呢?
第一个时间是第一次运行后,加入了任务队列,但还没有执行的任务。第二个则是本次执行的任务打印的。这说明了,就算进程被杀掉,任务还是存在,甚至如果重启手机,任务依然会在满足条件的情况下得到执行。
这是 WorkManager 的另一个特点,一旦发起一个任务,任务是可以保证一定会被执行的,就算退出应用,甚至重启手机都阻止不了他。但可能由于添加了环境约束等原因,它执行的时间是不确定的。
当应用正在运行时,它会在当前的进程中启用一个子线程执行。应用没有运行的情况下启用,它则会自己选择一种合适的方式在后台运行。具体是什么方式和 Android 的版本和依赖环境有关:
定时任务
前面说了 OneTimeWorkRequest 是指任务只需要执行一遍,而 PeriodicWorkRequest 则可以发起一个多次执行的定时任务:
val request = PeriodicWorkRequest
.Builder(MainWorker::class.java, 15, TimeUnit.MINUTES)
.setConstraints(constraints)
.setInputData(data)
.build()
这样,发起的任务就会每隔 15 分钟执行一次。除了需要传入间隔时间,使用起来跟 OneTimeWorkRequest 是没有区别的。
你可能会想更频繁的去执行一个任务,比如几秒钟执行一遍,但很遗憾,最小时间间隔就是 15 分钟,看一下源码就知道了。
还有需要注意的是,定时任务并不是说经过指定时间后它就马上执行,而是经过这一段时间后,等到满足约束条件等情况时,它才执行。
任务链
WorkManager 允许我们按照一定的顺序执行任务,比如我想 A、B、C 三个任务按先后顺序执行:
自我介绍一下,小编13年上海交大毕业,曾经在小公司待过,也去过华为、OPPO等大厂,18年进入阿里一直到现在。
深知大多数初中级安卓工程师,想要提升技能,往往是自己摸索成长,但自己不成体系的自学效果低效又漫长,而且极易碰到天花板技术停滞不前!
因此收集整理了一份《2024年最新Android移动开发全套学习资料》送给大家,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。
由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频
如果你觉得这些内容对你有帮助,可以添加下面V无偿领取!(备注Android)
点击这里免费领取吧!
以添加下面V无偿领取!(备注Android)**
[外链图片转存中…(img-iw01Tvxh-1711289814459)]
[外链图片转存中…(img-byU8Wqkt-1711289814459)]
[外链图片转存中…(img-xO9xuo2q-1711289814459)]