Android Jetpack - 使用 WorkManager 管理后台任务(1)，Android开发快速上手

OneTimeWorkRequest 意味着这个任务只需执行一遍。

加入任务队列

要让任务执行，需要将 WorkRequest 加入任务队列：

WorkManager.getInstance().enqueue(request)

现在加入任务队列后，任务会马上得到执行。但需要注意的是，这句代码的作用是将任务加入任务队列，而不是执行任务，至于区别后面会讲到。

数据交互

后台任务少不了数据的交互，我们看一下数据是如何传入传出的。

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) 是将任务加入任务队列，并不代表马上执行任务，因为任务可能需要等到满足环境条件的情况才会执行。

强大的生命力

还是一样的代码，我们来做点不一样的操作：

1. 断网后运行
2. 将进程杀掉
3. 联网
4. 再次运行

不出意外的话，这时候你会看到有两个时间的打印，而且两个时间还不一样，这是为什么呢？

第一个时间是第一次运行后，加入了任务队列，但还没有执行的任务。第二个则是本次执行的任务打印的。这说明了，就算进程被杀掉，任务还是存在，甚至如果重启手机，任务依然会在满足条件的情况下得到执行。

这是 WorkManager 的另一个特点，一旦发起一个任务，任务是可以保证一定会被执行的，就算退出应用，甚至重启手机都阻止不了他。但可能由于添加了环境约束等原因，它执行的时间是不确定的。

当应用正在运行时，它会在当前的进程中启用一个子线程执行。应用没有运行的情况下启用，它则会自己选择一种合适的方式在后台运行。具体是什么方式和 Android 的版本和依赖环境有关：

定时任务

前面说了 OneTimeWorkRequest 是指任务只需要执行一遍，而 PeriodicWorkRequest 则可以发起一个多次执行的定时任务：

val request = PeriodicWorkRequest
.Builder(MainWorker::class.java, 15, TimeUnit.MINUTES)
.setConstraints(constraints)
.setInputData(data)

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数Android工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则几千的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年Android移动开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Android开发知识点，真正体系化！

由于文件比较大，这里只是将部分目录大纲截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且后续会持续更新
如果你觉得这些内容对你有帮助，可以添加V：vip204888 备注Android获取（资料价值较高，非无偿）

写在最后

在技术领域内，没有任何一门课程可以让你学完后一劳永逸，再好的课程也只能是“师傅领进门，修行靠个人”。“学无止境”这句话，在任何技术领域，都不只是良好的习惯，更是程序员和工程师们不被时代淘汰、获得更好机会和发展的必要前提。

如果你觉得自己学习效率低，缺乏正确的指导，可以一起学习交流！

加入我们吧！群内有许多来自一线的技术大牛，也有在小厂或外包公司奋斗的码农，我们致力打造一个平等，高质量的Android交流圈子，不一定能短期就让每个人的技术突飞猛进，但从长远来说，眼光，格局，长远发展的方向才是最重要的。

35岁中年危机大多是因为被短期的利益牵着走，过早压榨掉了价值，如果能一开始就树立一个正确的长远的职业规划。35岁后的你只会比周围的人更值钱。

如果你觉得自己学习效率低，缺乏正确的指导，可以一起学习交流！

加入我们吧！群内有许多来自一线的技术大牛，也有在小厂或外包公司奋斗的码农，我们致力打造一个平等，高质量的Android交流圈子，不一定能短期就让每个人的技术突飞猛进，但从长远来说，眼光，格局，长远发展的方向才是最重要的。

35岁中年危机大多是因为被短期的利益牵着走，过早压榨掉了价值，如果能一开始就树立一个正确的长远的职业规划。35岁后的你只会比周围的人更值钱。

本文已被CODING开源项目：《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》收录