Putting Work Manager To Work

My slides from GDG Devfest Kolkata - 2019

Transcript

1. Putting Work Manager To Work DevFest Kolkata 2019 1
2. Android @ RedMart 1 Adnan A M DevFest Kolkata 2019 2
3. Background Processing DevFest Kolkata 2019 3
4. Options 4 Threads/Executors 4 Services 4 Alarm Manager 4 Async Tasks 4 Download Manager DevFest Kolkata 2019 4
5. Restrictions 4 Doze Mode/Battery Saver 4 Background Services Limitations 4 App Standby Buckets 4 Restricted Background Apps DevFest Kolkata 2019 5
6. Work Manager The brand new magic tool to help you perform Background Work seamlessly. DevFest Kolkata 2019 6
7. The One With All The Features 4 API 14+ 4 Constraints 4 Multiple Chained Tasks 4 Guranteed Work Execution (Full Offline Mode Support) DevFest Kolkata 2019 7
8. A sample is worth a thousand explanations 1 Me @ 5 AM today DevFest Kolkata 2019 8
9. Implementing Work Manager - Basic 4 Add Dependency 4 Extend Worker class 4 Override doWork method 4 Return result 4 Schedule Work DevFest Kolkata 2019 9
10. Implementing Work Manager - Basic The One With All The Dependencies dependencies { def work_version = 2.0.0 // (Java only) implementation "android.arch.work:work-runtime:$work_version" // Kotlin + coroutines implementation "android.arch.work:work-runtime-ktx:$work_version" // optional - RxJava2 support implementation "android.arch.work:work-rxjava2:$work_version" // optional - Test helpers androidTestImplementation "android.arch.work:work-testing:$work_version" } DevFest Kolkata 2019 10
11. Implementing Work Manager - Basic Extend Worker Class class SomeWorker(appContext: Context, workerParams: WorkerParameters): Worker(appContext, workerParams) { override fun doWork(): Result { someWork() return Result.SUCCESS } } DevFest Kolkata 2019 11
12. Implementing Work Manager - Basic Override doWork() class SomeWorker(appContext: Context, workerParams: WorkerParameters): Worker(appContext, workerParams) { override fun doWork(): Result { someWork() return Result.SUCCESS } } DevFest Kolkata 2019 12
13. Implementing Work Manager - Basic Return Result class SomeWorker(appContext: Context, workerParams: WorkerParameters): Worker(appContext, workerParams) { override fun doWork(): Result { someWork() return Result.SUCCESS } } DevFest Kolkata 2019 13
14. Implementing Work Manager - Basic Schedule Work val myWorkRequest = OneTimeWorkRequest.Builder(SomeWorker) .build() WorkManager.getInstance().enqueue(myWorkRequest) DevFest Kolkata 2019 14
15. Worker Class - Under The Hood Abstract class Extends ListenableWorker startWork() -> doWork() DevFest Kolkata 2019 15
16. Worker Class - Under The Hood @Override public final @NonNull ListenableFuture<Payload> startWork() { mFuture = SettableFuture.create(); getBackgroundExecutor().execute(new Runnable() { @Override public void run() { Result result = doWork(); mFuture.set(new Payload(result, getOutputData())); } }); return mFuture; } DevFest Kolkata 2019 16
17. Result - Under The Hood Enum SUCCESS, FAILURE, RETRY DevFest Kolkata 2019 17
18. The One With All The Work Request One Time Work Request Periodic Work Request DevFest Kolkata 2019 18
19. One Time Work Request val someWorkRequest = OneTimeWorkRequest.Builder(SomeWorker).build() DevFest Kolkata 2019 19
20. Periodic Work Request // Create a periodic work request with 30 mins as repeat interval val repeatInterval = 30 val somePeriodicWorkRequest = PeriodicWorkRequest.Builder(SomeWorker, repeatInterval, TimeUnit.MINUTES).build() DevFest Kolkata 2019 20
21. The One With The TAGS Human Readable Logical Groups Multiple Tags DevFest Kolkata 2019 21
22. TAGS - Sample val someWorkRequest = OneTimeWorkRequest.Builder(SomeWorker) .addTag("Sync") .addTag("Job Status") .build() val someOtherWorkRequest = OneTimeWorkRequest.Builder(SomeWorker) .addTag("Sync") .addTag("Driver Activity") .build() DevFest Kolkata 2019 22
23. The One With The Constraints 4 Network 4 Battery 4 Storage 4 Device State DevFest Kolkata 2019 23
24. Constraints - Sample private fun getWorkerConstraints(): Constraints { return Constraints.Builder().setRequiredNetworkType(NetworkType.CONNECTED) .setRequiresBatteryNotLow(true) .setRequiresCharging(true) .setRequiresDeviceIdle(false) .setRequiresStorageNotLow(false) .build() } DevFest Kolkata 2019 24
25. The One With All The Chaining WorkManager.getInstance().beginWith(work1) .then(work2) .then(work3) .enqueue() DevFest Kolkata 2019 25
26. The One With All The Combining WorkManager.getInstance().enqueue(work1, work2, work3) DevFest Kolkata 2019 26
27. The One Where It All Made Sense WorkManager.getInstance().beginWith(work1, work2, work3) .then(work4) .then(work5) .then(work7) .enqueue() DevFest Kolkata 2019 27
28. Complex chains/combines A | +----------+ | | B C | +----+ | | D E DevFest Kolkata 2019 28
29. Complex chains/combines WorkContinuation continuation = workManager.beginWith(A); continuation.then(C).enqueue(); continuation.then(B).then(D, E).enqueue(); DevFest Kolkata 2019 29
30. Complex chains/combines A | +----------+ | | B C +----------+ | +----------+ | | D E DevFest Kolkata 2019 30
31. Complex chains/combines WorkContinuation continuation = workManager.beginWith(A); continuation.then(B, C).then(D, E).enqueue(); DevFest Kolkata 2019 31
32. Complex chains/combines Chain 1 Chain 2 A C | | B D +----------+ | E DevFest Kolkata 2019 32
33. Complex chains/combines WorkContinuation chain1 = WorkManager.getInstance() .beginWith(workA) .then(workB); WorkContinuation chain2 = WorkManager.getInstance() .beginWith(workC) .then(workD); WorkContinuation chain3 = WorkContinuation.combine(chain1, chain2) //Combines chain 1 and 2 .then(workE); chain3.enqueue(); DevFest Kolkata 2019 33
34. The One With The Unique Work Ensure single instance of same work val uniqueName = "MyUniqueName" val myWorkRequest = OneTimeWorkRequest.Builder(SomeWorker).build() WorkManager.getInstance().enqueueUniqueWork(uniqueName, ExistingWorkPolicy.REPLACE, myWorkRequest) DevFest Kolkata 2019 34
35. Existing Work Policy REPLACE KEEP APPEND DevFest Kolkata 2019 35
36. Query Status ID Tag Unique Name DevFest Kolkata 2019 36
37. Query Work Info By ID WorkManager.getInstance().getWorkInfoById(requestId) WorkManager.getInstance().getWorkInfoByIdLiveData(requestId) DevFest Kolkata 2019 37
38. Query Work Info By Tag WorkManager.getInstance().getWorkInfosByTag("Sync") WorkManager.getInstance().getWorkInfosByTagLiveData("Sync") DevFest Kolkata 2019 38
39. Query Work Info By Unique Name WorkManager.getInstance().getWorkInfosForUniqueWork("MyUniqueName") WorkManager.getInstance().getWorkInfosForUniqueWorkLiveData("MyUniqueName") DevFest Kolkata 2019 39
40. Cancel Work WorkManager.getInstance().cancelWorkById(requestId) WorkManager.getInstance().cancelAllWorkByTag("Sync") WorkManager.getInstance().cancelUniqueWork("MyUniqueName") WorkManager.getInstance().cancelAllWork() DevFest Kolkata 2019 40
41. Tips/Gotchas 4 Use Tags to limit scopes and group operations together 4 Multiple chained jobs with different constraints can run at different times 4 Evaulate trigger points for all your workers DevFest Kolkata 2019 41
42. Tips/Gotchas 4 One Time Work & Periodic Work share tags 4 Check isStopped() before doing work 4 Cancel all work before removing WM DevFest Kolkata 2019 42
43. Summary 4 Runs Work On Background Thread 4 Guarantees execution across system reboots 4 Runs work using best possible method based on API level of the user's device 4 Wavelock Management DevFest Kolkata 2019 43
44. Summary - Under The Hood 4 Uses Room DB to save data 4 Keeps snapshots of work being done, hence queryable 4 Restarts pending work 4 Runs your work on a separate thread but synchronously using a Single Threaded Executor DevFest Kolkata 2019 44
45. The One With The Endgame 4 Reach out to me at @AdnanM0123 4 Talk about WM or droidcon India or anything Android 4 Well, anything except Flutter/RN maybe ? DevFest Kolkata 2019 45