您好,登录后才能下订单哦!
这篇文章主要介绍“Android开发Jetpack组件WorkManager怎么用”,在日常操作中,相信很多人在Android开发Jetpack组件WorkManager怎么用问题上存在疑惑,小编查阅了各式资料,整理出简单好用的操作方法,希望对大家解答”Android开发Jetpack组件WorkManager怎么用”的疑惑有所帮助!接下来,请跟着小编一起来学习吧!
WorkManager 用于处理 Android 后台任务。我们只需要设置好任务内容、何时执行,剩下的工作就可以完全交给系统处理。它会自动向下兼容,在不同的 Android 版本上采用不同的实现方案。
由于是交给系统调度的,它可以保证应用退出甚至手机重启后,任务依然能够得到执行。WorkManager 很适合执行一些定期和服务器交互的任务,比如周期性的同步数据等等。并且,WorkManager 还支持周期性任务、链式任务。
需要注意的是,WorkManager 不能保证任务一定能够准时执行,这是因为系统为了减少电量消耗,会将触发事件临近的几个任务放在一起执行,以减少 CPU 被唤醒的次数,延长电池使用时间。
另外,在国产手机上 WorkManager 可能无法正常运行,这是因为绝大多数手机厂商定制 Android 系统时,会添加一个“一键关闭”的功能,这样被杀死后的应用程序,既无法接收广播,也不能运行 WorkManager 的后台任务。国产手机增加此功能也是迫于无奈,主要是因为市面上有太多的恶意应用想要霸占后台。所以,我们在国产手机上不要使用 WorkManager 去实现核心功能。
在 app/build.gradle 中添加依赖:
implementation 'androidx.work:work-runtime:2.3.2'
WorkManager 的用法分为三步:
定义一个后台任务
配置任务运行条件
将任务传给 WorkManager
创建一个 SimpleWorker 类,继承自 Worker:
class SimpleWorker(context: Context, params: WorkerParameters) : Worker(context, params) { override fun doWork(): Result { Log.d("~~~", "do something") return Result.success() } }
Result.success()
表示任务执行成功
Result.failure()
表示任务执行失败
Result.retry()
表示任务需要重试。这个方法需要配合任务重试配置一起使用
使用 OneTimeWorkRequest 构建只需执行一次的任务
val request = OneTimeWorkRequest.Builder(SimpleWorker::class.java).build()
使用 PeriodicWorkRequest 构建周期性执行的任务
val request = PeriodicWorkRequest.Builder(SimpleWorker::class.java, 15, TimeUnit.MINUTES).build()
为了减少耗电量,PeriodicWorkRequest 要求任务执行周期不得短于十五分钟,查看源码可以发现,如果传入的值短于十五分钟,系统会打印一条警告,然后自动将周期设置成十五分钟:
public static final long MIN_PERIODIC_INTERVAL_MILLIS = 15 * 60 * 1000L; // 15 minutes. /** * Sets the periodic interval for this unit of work. * * @param intervalDuration The interval in milliseconds */ public void setPeriodic(long intervalDuration) { if (intervalDuration < MIN_PERIODIC_INTERVAL_MILLIS) { Logger.get().warning(TAG, String.format( "Interval duration lesser than minimum allowed value; Changed to %s", MIN_PERIODIC_INTERVAL_MILLIS)); intervalDuration = MIN_PERIODIC_INTERVAL_MILLIS; } setPeriodic(intervalDuration, intervalDuration); }
WorkManager.getInstance(this).enqueue(request)
这就是 WorkManager 的基本使用。
通过 setInitialDelay 方法设置延迟时间
val request = OneTimeWorkRequest.Builder(SimpleWorker::class.java) .setInitialDelay(5, TimeUnit.MINUTES) .build()
通过 addTag 方法添加标签:
val request = OneTimeWorkRequest.Builder(SimpleWorker::class.java) .addTag("simple") .build()
添加标签的作用是,方便我们根据标签取消任务。
WorkManager.getInstance(this).cancelAllWorkByTag("simple")
WorkManager.getInstance(this).cancelWorkById(request.id)
WorkManager.getInstance(this).cancelAllWork()
通过 setBackoffCriteria 配置任务重试:
val request = OneTimeWorkRequest.Builder(SimpleWorker::class.java) .setBackoffCriteria(BackoffPolicy.LINEAR, 10, TimeUnit.SECONDS) .build()
前文说到,Result.retry() 表示任务需要重试,这个方法需要配合任务重试配置一起使用。任务重试配置就是指这个 setBackoffCriteria 方法,它传入了三个值,第二个值和第三个值表示重试时间配置。第一个值表示重试延迟的形式,有两个值可供选择:
BackoffPolicy.LINEAR 重试时间每次呈线性增长,按照此例中的配置,每次重试时间就是 10s,20s,30s,40s…
BackoffPolicy.EXPONENTIAL 重试时间每次呈指数级增长,按照此例中的配置,每次重试时间就是 10s,20s,40s,80s…
WorkManager.getInstance(this).getWorkInfoByIdLiveData(request.id).observe(this) { Log.d("~~~", "state = ${it.state}, tags = ${it.tags.toList()}") when (it.state) { WorkInfo.State.SUCCEEDED -> Log.d("~~~", "success") WorkInfo.State.FAILED -> Log.d("~~~", "fail") WorkInfo.State.RUNNING -> Log.d("~~~", "running") WorkInfo.State.ENQUEUED -> Log.d("~~~", "enqueued") WorkInfo.State.CANCELLED -> Log.d("~~~", "cancelled") WorkInfo.State.BLOCKED -> Log.d("~~~", "blocked") } }
首先通过 getWorkInfoByIdLiveData 获得任务信息的 LiveData<WorkInfo> 数据,然后观察此数据即可。也可以通过 getWorkInfosByTagLiveData 获得相同 Tag 的 LiveData<List<WorkInfo>>,观察这个任务信息列表。通过 WorkInfo 的 getState 方法获取任务状态,主要用到的状态有 WorkInfo.State.SUCCEEDED 和 WorkInfo.State.FAILED,标志着任务的成功和失败。
val request = OneTimeWorkRequest.Builder(SimpleWorker::class.java) .setInputData(Data.Builder().apply { putString("key", "value") }.build()) .build()
SimpleWorker 类中读取此数据:
inputData.getString("key")
val first = OneTimeWorkRequest.Builder(SimpleWorker::class.java) .build() val second = OneTimeWorkRequest.Builder(SimpleWorker::class.java) .build() val third = OneTimeWorkRequest.Builder(SimpleWorker::class.java) .build() WorkManager.getInstance(this) .beginWith(first) .then(second) .then(third) .enqueue()
通过 beginWith 发起链式任务,然后后缀 then 即可,任务会按照连接顺序依次执行。WorkManager 要求必须在上一个任务执行成功后,才会执行下一个任务。也就是说任何一个任务的失败都会导致链式任务的中断。
到此,关于“Android开发Jetpack组件WorkManager怎么用”的学习就结束了,希望能够解决大家的疑惑。理论与实践的搭配能更好的帮助大家学习,快去试试吧!若想继续学习更多相关知识,请继续关注亿速云网站,小编会继续努力为大家带来更多实用的文章!
免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:is@yisu.com进行举报,并提供相关证据,一经查实,将立刻删除涉嫌侵权内容。