WorkManager - O que é? como usar?

Nesta palestra falei sobre como usar o WorkManager, uma nova API do Android Jetpack para trabalhos assincronos em background.

Transcript

1. WorkManager O que é? Haldny Santos Outubro, 2018
2. Olá! Eu sou Haldny Santos Engenheiro de Software - CESAR Recife 2 @haldny @haldny
3. Agenda › Entendendo o porque do WorkManager › Usando o WorkManager › Definindo as Restrições(Constraints) › Encadeando Tarefas 3
4. 1. Entendendo o porque do WorkManager 4
5. ➔ Fazer upload de vídeos e fotos ➔ Processar arquivos ➔ Sincronizar dados ➔ Fazer download de podcasts ➔ etc... Podemos fazer vários processos em background em nossos apps 5
6. ➔ Threads ➔ Executors ➔ Services ➔ AsyncTasks ➔ Handlers e Loopers E o Android nos fornece vários meios para fazer processos em background 6 ➔ Jobs (API 21+) ➔ GCMNetworkManager ➔ SyncAdapters ➔ Loaders ➔ AlarmManager
7. ➔ Doze mode (Marshmallow) ➔ App standby (Marshmallow) ➔ Limited Implicit broadcasts (Nougat) ➔ Release cached wakelocks (Oreo) ➔ Background service limitations (Oreo) ➔ App standby buckets (Pie) ➔ Background restricted apps (Pie) Otimização de bateria no Android 7
8. Tipos de trabalho em background 8
9. Quais são os seus requisitos? 9
10. Distribuções Android 10 https://developer.android.com/about/dashboards/
11. Distribuções Android 11 https://developer.android.com/about/dashboards/ 30%
12. ➔ JobScheduler nas APIs 21 e 22 tem bastante bugs: JobScheduler (API 21+) 12
13. ➔ Então, teremos sempre que criar a nossa lógica para a execução dos jobs, como no exemplo abaixo: if (Build.VERSION.SDK_INT >= 23) { // Usar JobScheduler } else { // Usar JobDispatcher ou AlarmManager } JobScheduler (API 23+) 13
14. ➔ Como criar um job usando FirebaseJobDispatcher FirebaseJobDispatcher (API 9+) 14
15. ➔ É necessário o Google Play Services!! FirebaseJobDispatcher (API 9+) 15
16. FirebaseJobDispatcher (API 9+) 16
17. ➔ O início do alarme a partir da API 19 (Build.VERSION_CODES.KITKAT) é inexato: o sistema operacional mudará os alarmes para minimizar os wakeups e o uso da bateria. AlarmManager (API 1+) 17
18. E quem poderá nos Ajudar? 18
19. WorkManager 19
20. “O WorkManager tem como objetivo simplificar a experiência do desenvolvedor, fornecendo uma APIs de fácil entendimento para o processamento em segundo plano pelo sistema. Ele é destinado a trabalhos em segundo plano que devem ser executados mesmo se o aplicativo não estiver mais em primeiro plano. Sempre que possível, ele usa o JobScheduler ou o Firebase JobDispatcher para fazer o trabalho; Se o seu aplicativo estiver em primeiro plano, ele tentará fazer o trabalho diretamente no seu processo.” 20 https://developer.android.com/reference/androidx/work/WorkManager
21. “WorkManager é uma biblioteca usada para enfileirar/executar trabalhos assíncronos.” “WorkManager garante a execução quando as restrições são atendidas, mesmo que o sistema seja reiniciado.” 21 https://developer.android.com/reference/androidx/work/WorkManager
22. “WorkManager permite a observação do status do trabalho e tem a capacidade de criar cadeias de trabalho complexas.” 22 https://developer.android.com/reference/androidx/work/WorkManager
23. “É uma biblioteca que facilita a especificação de tarefas assíncronas, levando em consideração a periodicidade e condições em que as tarefas serão executadas. Usando algumas APIs, podemos criar uma tarefa e entregá-la ao WorkManager para execução imediata ou no momento apropriado.” 23 https://medium.com/android-dev-br/workmanager-o-que-%C3%A9-com o-usar-26f5b800984e
24. ➔ Garantia de execução sempre que as restrições forem atendidas ➔ Retrocompatibilidade com e sem Google Play Services ➔ Consultável ➔ Encadeável ➔ Oportunista Features do WorkManager 24
25. 2. Usando o WorkManager 25
26. dependencies { def work_version = "1.0.0-alpha10" implementation "android.arch.work:work-runtime:$work_version" implementation "android.arch.work:work-firebase:$work_version" } Adicionando o WorkManager no nosso projeto 26
27. ➔ Worker ➔ Data ➔ Worker.Result ➔ SUCCESS ➔ RETRY ➔ FAILURE O que precisamos saber para criar um trabalho? 27
28. class DownloadWorker(appContext: Context, workParams: WorkerParameters) : Worker(appContext, workParams) { override fun doWork(): Result { val url = inputData.getString(KEY_URL) if (URLUtil.isValidUrl(url)) { val downloadFile = startDownloadFile(url) outputData = Data.Builder().putString(KEY_DOWNLOAD_FILE, downloadFile?.absolutePath).build() return Result.SUCCESS } return Result.FAILURE } } Exemplo 28
29. ➔ WorkerRequest ➔ OneTimeWorkRequest ➔ PeriodicWorkRequest Quais os tipos trabalho disponíveis na biblioteca? 29
30. val periodicDownload = PeriodicWorkRequest .Builder(DownloadWorker::class.java, 15, TimeUnit.MINUTES).build() val downloadWork = OneTimeWorkRequest .Builder(DownloadWorker::class.java).build() Exemplo 30
31. public void setPeriodic(long intervalDuration) { if (intervalDuration < MIN_PERIODIC_INTERVAL_MILLIS) { Logger.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); } PeriodicWorkRequest intervalo mínimo 31
32. val manager = WorkManager.getInstance() manager.enqueue(periodicDownload) Enfileirando o trabalho 32
33. manager.getStatusByIdLiveData(periodicDownload.id).observe(this, Observer { if (it?.state.isFinished) { Toast.makeText(this, "Download finished.", Toast.LENGTH_LONG).show() } }) manager.getStatusByIdLiveData(periodicDownload.id).observe(this, Observer { if (it?.state == State.ENQUEUED) { Toast.makeText(this, "Download enqueued.", Toast.LENGTH_LONG).show() } }) Observando o trabalho 33
34. ➔ WorkerStatus ➔ ENQUEUED ➔ RUNNING ➔ SUCCEEDED ➔ FAILED ➔ BLOCKED ➔ CANCELLED Quais os estados do trabalho? 34
35. Como o WorkManager escolhe em qual componente vai executar? 35
36. static @NonNull Scheduler createBestAvailableBackgroundScheduler( @NonNull Context context, @NonNull WorkManagerImpl workManager) { Scheduler scheduler; boolean enableFirebaseJobService = false; boolean enableSystemAlarmService = false; if (Build.VERSION.SDK_INT >= WorkManagerImpl.MIN_JOB_SCHEDULER_API_LEVEL) { scheduler = new SystemJobScheduler(context, workManager); setComponentEnabled(context, SystemJobService.class, true); Logger.debug(TAG, "Created SystemJobScheduler and enabled SystemJobService"); } Como o WorkManager escolhe em qual componente vai executar? 36
37. } else { try { scheduler = tryCreateFirebaseJobScheduler(context); enableFirebaseJobService = true; Logger.debug(TAG, "Created FirebaseJobScheduler"); } catch (Exception e) { scheduler = new SystemAlarmScheduler(context); enableSystemAlarmService = true; Logger.debug(TAG, "Created SystemAlarmScheduler"); } } } Como o WorkManager escolhe em qual componente vai executar? 37
38. try { Class firebaseJobServiceClass = Class.forName(FIREBASE_JOB_SERVICE_CLASSNAME); setComponentEnabled(context, firebaseJobServiceClass, enableFirebaseJobService); } catch (ClassNotFoundException e) {} setComponentEnabled(context, SystemAlarmService.class, enableSystemAlarmService); return scheduler; } Como o WorkManager escolhe em qual componente vai executar? 38
39. 3. Definindo as Restrições (Constraints) 39
40. val constraints = Constraints.Builder() .setRequiredNetworkType(NetworkType.CONNECTED) .build() Usando o WorkManager você pode definir as restrições 40
41. public @NonNull Builder setRequiresCharging(boolean requiresCharging) { this.mRequiresCharging = requiresCharging; return this; } public @NonNull Builder setRequiredNetworkType(@NonNull NetworkType networkType) { this.mRequiredNetworkType = networkType; return this; } Existem restrições aplicáveis a todas as versões do Android 41
42. public @NonNull Builder setRequiresBatteryNotLow(boolean requiresBatteryNotLow) { this.mRequiresBatteryNotLow = requiresBatteryNotLow; return this; } public @NonNull Builder setRequiresStorageNotLow(boolean requiresStorageNotLow) { this.mRequiresStorageNotLow = requiresStorageNotLow; return this; } Existem restrições aplicáveis a todas as versões do Android 42
43. @RequiresApi(23) public @NonNull Builder setRequiresDeviceIdle(boolean requiresDeviceIdle) { this.mRequiresDeviceIdle = requiresDeviceIdle; return this; } @RequiresApi(24) public @NonNull Builder addContentUriTrigger(Uri uri, boolean triggerForDescendants) { mContentUriTriggers.add(uri, triggerForDescendants); return this; } E outras que apenas são usadas a partir de uma determinada versão do Android 43
44. 4. Encadeando Tarefas 44
45. Temos o seguinte caso 45 Baixar Descomprimir Validar
46. val workManager = WorkManager.getInstance() workManager.beginWith(downloadWork).then(unzipWork).then(validateWorker) .enqueue() E como encadeamos os trabalhos? 46
47. E se agora precisássemos notificar o usuário e enviar um e-mail após validar? 47 Baixar Descomprimir Validar Enviar Email Notificar
48. val workManager = WorkManager.getInstance() workManager.beginWith(downloadWork).then(unzipWork).then(validateWorker) .then(notifyUserWorker, sendEmailWorker).enqueue() E como paralelizamos os trabalhos? 48
49. val chain1 = WorkManager.getInstance().beginWith(workA).then(workB) val chain2 = WorkManager.getInstance().beginWith(workC).then(workD) val chain3 = WorkContinuation.combine(chain1, chain2).then(workE) chain3.enqueue() E também é possível criar sequências complexas 49
50. ➔ Enviar mídias pro servidor ➔ Fazer download de arquivos e salvar os dados no banco de dados ➔ Fazer processamentos que não dependem na UI Quando devemos utilizar o WorkManager? 50
51. ➔ Fazer download dos dados e atualizar a View (Use ThreadPools ou RX) ➔ Extrair a cor da paleta e atualizar um ImageView (Use ThreadPools ou RX) ➔ Fazer transações de pagamentos (Use ForegroundService) Quando não devemos utilizar o WorkManager? 51
52. Demo 52
53. ➔ https://developer.android.com/topic/libraries/architecture/work manager/ ➔ https://medium.com/android-dev-br/workmanager-o-que-%C3% A9-como-usar-26f5b800984e ➔ https://www.bignerdranch.com/blog/doing-work-with-androids- new-work-manager/ ➔ https://www.androidauthority.com/schedule-background-tasks- jetpacks-workmanager-874189/ ➔ https://www.raywenderlich.com/6040-workmanager-tutorial-for- android-getting-startedhttps://github.com/googlecodelabs/andr oid-workmanager ➔ https://github.com/googlecodelabs/android-workmanager Referências 53
54. Obrigado! Alguma pergunta? Você pode me encontrar: @haldny · haldnysantos10@gmail.com 54