WorkManager適用于完成延遲或者異步任務(wù)鄙陡,即使是我們的App當(dāng)前沒有被打開或者設(shè)備重啟也能完成這些任務(wù)馍惹。
關(guān)鍵功能
- 兼容最低API 14
- 在API 23+ 的設(shè)備上使用JobScheduler實(shí)現(xiàn)
- 在API14-22的設(shè)備上使用BroadcastReceiver + AlarmManager組合實(shí)現(xiàn)(這個(gè)就很好理解了茎芭,至于JobScheduler后面有時(shí)間可以寫一篇文章分析分析)
- 可以添加執(zhí)行任務(wù)的約束條件,例如:網(wǎng)絡(luò)是否連接、是否處于充電狀態(tài)
- 可以用于完成一次性紊婉、周期性的異步任務(wù)
- 監(jiān)控管理任務(wù)執(zhí)行
- 可以將任務(wù)串聯(lián)起來(lái)完成(例如先完成任務(wù)A再完成任務(wù)B最后完成任務(wù)C)
- 即使是App吁系、手機(jī)重啟也能保證執(zhí)行相關(guān)任務(wù)
WorkManager被設(shè)計(jì)用于執(zhí)行延遲任務(wù)芹敌,這意味著這些任務(wù)不需要被立即執(zhí)行,并且這些延遲任務(wù)在App被殺死或者設(shè)備重啟后依然能夠可靠的執(zhí)行垮抗。這么說(shuō)有點(diǎn)抽象了氏捞,舉兩個(gè)這樣任務(wù)的例子:
- 發(fā)送App運(yùn)行的log和分析數(shù)據(jù)到后端服務(wù)器(這個(gè)比較像友盟、Bugly這樣的服務(wù)會(huì)用到)
- 周期性的和服務(wù)器同步數(shù)據(jù)(例如:筆記類的應(yīng)用冒版,就可以定期的同步服務(wù)器和App的筆記)
WorkManager不適用于完成需要和App生命周期關(guān)聯(lián)的任務(wù)液茎,也不適用于完成需要被立即執(zhí)行的任務(wù)。關(guān)于什么樣的任務(wù)適用Android提供的相關(guān)API辞嗡,可以參考下圖(這里的任務(wù)都是指需要后臺(tái)執(zhí)行的任務(wù)):
簡(jiǎn)單明了的選擇分類捆等,就不做過(guò)多解釋了。
由于Android對(duì)后臺(tái)任務(wù)管理的不斷嚴(yán)格续室,在完成后臺(tái)任務(wù)的時(shí)候需要考慮不同API版本對(duì)后臺(tái)任務(wù)的限制栋烤。關(guān)于如何選擇完成后臺(tái)任務(wù)的API,可以按如下幾點(diǎn)來(lái)考慮:
- 后臺(tái)任務(wù)是否需要被立即執(zhí)行還是可以延遲執(zhí)行挺狰? 例如如果是點(diǎn)擊按鈕獲取網(wǎng)絡(luò)數(shù)據(jù)明郭,那么這個(gè)任務(wù)就需要被立即執(zhí)行买窟。但是如果只是想把log上傳到服務(wù)器,那么這個(gè)任務(wù)就可以延遲執(zhí)行薯定,這樣就不會(huì)對(duì)App運(yùn)行有影響
- 完成任務(wù)是否需要系統(tǒng)處于某些特定的場(chǎng)景 有些任務(wù)可能需要在某些特定的場(chǎng)景下執(zhí)行始绍,例如手機(jī)處于充電模式并且有網(wǎng)絡(luò)連接等情況。為什么要處于這樣的場(chǎng)景下才完成某些任務(wù)呢话侄?如果手機(jī)處于充電亏推、熄屏并且連接wifi等情況下,那么我們就可以完成一些比較耗電耗流量的任務(wù)年堆,并且不會(huì)對(duì)用戶體驗(yàn)造成任何影響吞杭。這樣的任務(wù)有可能需要事先存儲(chǔ)需要完成的任務(wù),再集中執(zhí)行变丧。
- 任務(wù)是否需要在精確的時(shí)間被執(zhí)行 日歷類的應(yīng)用需要在精確地時(shí)間提醒用戶設(shè)置的事件篇亭,但其他的任務(wù)可能就沒有必要在精確地時(shí)間執(zhí)行。通常有可能的情況是:任務(wù)A執(zhí)行完成->執(zhí)行任務(wù)B完成->執(zhí)行任務(wù)C锄贷,但是并不需要這些任務(wù)在精確地時(shí)間(例如下午6:30)執(zhí)行译蒂。
WorkManager該如何使用
1.添加WorkManager到Android工程中
這里就不詳細(xì)講了,和引入其他庫(kù)相同谊却,詳細(xì)鏈接:https://developer.android.com/jetpack/androidx/releases/work#declaring_dependencies
2.創(chuàng)建后臺(tái)任務(wù)
通過(guò)繼承實(shí)現(xiàn) Worker
類來(lái)實(shí)現(xiàn)一個(gè)任務(wù)柔昼。 doWork()
方法可以執(zhí)行具體的任務(wù),這個(gè)任務(wù)運(yùn)行在WorkManager提供的異步線程中炎辨。實(shí)例如下:
public class UploadWorker extends Worker {
public UploadWorker(
@NonNull Context context,
@NonNull WorkerParameters params) {
super(context, params);
}
@Override
public Result doWork() {
// Do the work here--in this case, upload the images.
//在這里面完成任務(wù)--在本例中就是上傳圖片
uploadImages()
// Indicate whether the task finished successfully with the Result
//通過(guò)返回值表明任務(wù)是否完成成功
return Result.success()
}
}
從doWork()
方法中返回的 Result
表明了任務(wù)完成的狀態(tài):
- 成功完成捕透,
Result.success()
- 失敗,
Result.failure()
- 需要稍候重試碴萧,
Result.retry()
3.確定如何乙嘀、何時(shí)完成任務(wù)
Work
定義完成后需要定義WorkRequest
來(lái)確定如何、何時(shí)完成任務(wù)破喻。任務(wù)有可能是一次性的也可能是周期性的虎谢。對(duì)于一次性的任務(wù),使用 OneTimeWorkRequest
曹质,對(duì)于周期性的任務(wù)婴噩,使用PeriodicTimeWorkRequest
。
結(jié)合上面提到的上傳圖片的任務(wù)羽德,我們可以這樣實(shí)現(xiàn):
OneTimeWorkRequest uploadWorkRequest = new OneTimeWorkRequest.Builder(UploadWorker.class)
.build()
WorkRequest
也包括了其他信息几莽,例如完成任務(wù)的約束條件,任務(wù)的輸入條件宅静、延遲任務(wù)和任務(wù)的退避條件章蚣。詳細(xì)的API可以參考Defining Work guide。
4.將任務(wù)提交給Android系統(tǒng)
定義完成WorkRequest
后姨夹,需要通過(guò) WorkManager
的enqueue()
方法將任務(wù)提交系統(tǒng)纤垂。
WorkManager.getInstance().enqueue(uploadWorkRequest);
接下來(lái)任務(wù)就會(huì)在系統(tǒng)認(rèn)為合適的時(shí)間和合適的條件下去執(zhí)行相關(guān)任務(wù)矾策。好了,WorkManager相關(guān)介紹就到這里了洒忧。
相關(guān)文章:
理解Android Architecture Components系列(一)
理解Android Architecture Components系列(二)
理解Android Architecture Components系列之Lifecycle(三)
理解Android Architecture Components系列之LiveData(四)
理解Android Architecture Components系列之ViewModel(五)
理解Android Architecture Components系列之Room(六)
理解Android Architecture Components系列之Paging Library(七)
理解Android Architecture Components系列之WorkManager(八)