Kotlin WorkManager使用方法詳解
WorkMananger的簡介
Google推出WorkManager組件,WorkManager很適合用于處理一些要求定時執(zhí)行的任務,它可以根據(jù)操作系統(tǒng)的版本自動選擇底層是使用AlarmManager實現(xiàn)還是JobScheduler實現(xiàn),從而降低了我們的使用成本。另外,它還支持周期性任務,鏈式任務處理等功能,是一個非常強大的工具。
WorkManager的基本用法
在app/build.gradle文件添加依賴
implementation "androidx.work:work-runtime:2.7.1"
WorkManager的基本用法其實非常簡單,主要分為以下3步:
- 定義一個后臺任務,并實現(xiàn)具體的任務邏輯。
- 配置該后臺任務的運行條件和約束信息,并構建后臺任務請求。
- 將該后臺任務請求傳入WorkManager的enqueue()方法中,系統(tǒng)會在合適的時間運行。
第一步要定義一個后臺任務,這里創(chuàng)建一個SimpleWorker類,代碼如下所示:
class SimpleWorker(context: Context, params: WorkerParameters) : Worker(context, params) { override fun doWork(): Result { Log.d("SimpleWorker", "do work in SimpleWorker") return Result.success() } }
第二步,配置后臺任務的運行條件和約束信息,代碼如下所示:
//設置約束條件 //NetworkType.CONNECTED 最通用的連上網(wǎng)絡 //NetworkType.UNMETERED WF //NetworkType.METERED 流量,4G val constraints: Constraints =Constraints.Builder() .setRequiredNetworkType(NetworkType.CONNECTED) .build() val request=OneTimeWorkRequest.Builder(SimpleWorker::class.java) .setConstraints(constraints) .build()
最后一步,將構建出的后臺任務請求傳入WorkManager的enqueue()方法中,系統(tǒng)就會在合適的時間去運行了,代碼如下所示:
WorkManager.getInstance(context).enqueue(request)
使用WorkManager處理復雜的任務
(1)讓后臺任務在指定的推遲時間后運行
val request=OneTimeWorkRequest.Builder(SimpleWorker::class.java) .setInitialDelay(5,TimeUnit.MINUTES) .build()
(2)給后臺任務請求添加標簽
val request=OneTimeWorkRequest.Builder(SimpleWorker::class.java) ... .addTag("simple") .build()
(3)通過標簽來取消后臺任務請求
WorkManager.getInstance(this).cancelAllWorkByTag("simple")
(4)即使沒有標簽,也可以通過id來取消后臺任務請求
WorkManager.getInstance(this).cancelAllWorkById(request.id)
(5) 一次性取消所有后臺任務請求
WorkManager.getInstance(this).cancelAllWork()
(6)如果后臺任務的doWork()方法中返回了Result.retry(),那么是可以結合setBackoffCriteria()方法來重新執(zhí)行任務的。
setBackoffCriteria():第一個參數(shù)用于指定如果任務失敗再次執(zhí)行失敗,下次重試的時間應該以什么樣的形式延遲,可選值有兩種:1.LINEAR,代表下次重試時間以線性的方式延遲。2.EXPONENTIAL,代表下次重試時間以指數(shù)的方式延遲。第二個參數(shù)和第三個參數(shù)用于指定在多久之后重新執(zhí)行任務,時間最短不能少于10秒鐘。
val request=OneTimeWorkRequest.Builder(SimpleWorker::class.java) ... .setBackoffCriteria(BackoffPolicy.LINEAR,10,TimeUnit.SECONDS) .build()
(7)doWork方法中返回Result.success()和Result.failure()又有什么作用?這兩個返回值其實就是用于通知任務運行結果的,我們可以使用如下代碼對后臺任務的運行結果進行監(jiān)聽:
WorkManager.getInstance(this).getWorkInfoByIdLiveData(request.id).observer(this){workInfo-> if(workInfo.state==WorkInfo.State.SUCCEEDED){ Log.d("MainActivity","do work succeeded") }else if(workInfo.state==WorkInfo.State.FAILED){ Log.d("MainActivity","do work failed") } }
鏈式任務
假如這里定義了3個獨立的后臺任務:同步數(shù)據(jù),壓縮數(shù)據(jù)和上傳數(shù)據(jù)。現(xiàn)在我們想要實現(xiàn)先同步,再壓縮,最后上傳的功能,就可以借助鏈式任務來實現(xiàn)。
val sync=... val compress=... val upload=... WorkManager.getInstance(this) .beginWith(sync) .then(compress) .then(upload) .enqueue()
到此這篇關于Kotlin WorkManager使用方法詳解的文章就介紹到這了,更多相關Kotlin WorkManager內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家!
相關文章
Android自定義Animation實現(xiàn)View搖擺效果
這篇文章主要為大家詳細介紹了Android自定義Animation實現(xiàn)View搖擺效果,具有一定的參考價值,感興趣的小伙伴們可以參考一下2017-01-01Android RecycleView使用(CheckBox全選、反選、單選)
這篇文章主要為大家詳細介紹了Android RecycleView使用,CheckBox全選、反選、單選效果,具有一定的參考價值,感興趣的小伙伴們可以參考一下2017-09-09Android 清除SharedPreferences 產(chǎn)生的數(shù)據(jù)(實例代碼)
項目是要保存上次文件播放的位置,我使用SharedPreferences來保存,鍵值對分別是文件路徑和當時播放的位置2013-11-11