Tehnici avansate pentru

dezvoltarea aplicațiilor mobile

15 - Compose - WorkManager

WorkManager

2

WorkManager

• Parte din Android Jetpack

​

• Activități de background
• execuție oportunistă
• face activitatea cât mai repede posibil
• execuție garantată
• garantează pornirea activității chiar și în anumite situații nefavorabile

15 - Compose - WorkManager

3

Avantaje

• Suport pentru task-uri asincrone
• ocazionale
• periodice

​

• Suport pentru constrângeri
• condiții de rețea
• spațiu de stocare
• starea de încărcare a bateriei

​

15 - Compose - WorkManager

4

Avantaje

• Înlănțuirea cererilor de execuție complexe
• rularea task-urilor în paralel

​

• Pipeline
• ieșirea de la o cerere de execuție = intrarea pentru altă cerere

​

• Afișarea stării cererilor de execuție în UI

​

​

15 - Compose - WorkManager

5

WorkManager

• Se bazează pe alte API-uri
• JobScheduler
• AlarmManager

​

• Alege API-ul potrivit pe baza condițiilor din timpul rulării
• Nivelul API de pe dispozitiv

15 - Compose - WorkManager

6

Când folosim WorkManager?

• Pentru task-urile care trebuie neapărat finalizate

​

• Task-ul nu depinde de rularea aplicației
• task-ul va rula chiar dacă aplicația este închisă
• sau userul se întoarce la HomeScreen

​

• Când vrem să rulăm un task în afara thread-ului principal

15 - Compose - WorkManager

7

Exemple de task-uri

• Interogarea periodică pentru obținerea ultimelor știri

​

• Aplicarea filtrelor asupra unei imagini și salvarea ei

​

• Sincronizarea periodică a datelor locale prin rețea

15 - Compose - WorkManager

8

Clasa Worker/CoroutineWorker

• Clasa Worker
• task-uri sincron pe thread-uri de background

​

• Clasa CoroutineWorker
• task-uri asincrone pe thread-uri de background
• corutine din Kotlin

​

15 - Compose - WorkManager

9

CoroutineWorker

• Extindem clasa CoroutineWorker

​

• Suprascriem metoda doWork()
• codul rulat în background

​

15 - Compose - WorkManager

10

Clasa WorkRequest

• Cerere de a efectua un anumit task

​

• Rulare o singură dată sau periodic
• Constrângeri
• condiții îndeplinite înainte ca task-ul să fie executat

​

• Transmitem CoroutineWorker la crearea WorkRequest-ului

15 - Compose - WorkManager

11

Clasa WorkManager

• Planifică WorkRequest-ul și îl face să ruleze
• îl crează și îl adaugă în coadă

​

• Distribuie încărcarea pe resursele sistemului

​

• Respectă constrângerile specificate

​

15 - Compose - WorkManager

12

Exemplu de implementare

13

CoroutineWorker - exemplu

• Clasa extinde CoroutineWorker
• suprascriem funcția suspendabilă doWork()
• rulează asincron în background
• recomandată dacă folosim Kotlin

15 - Compose - WorkManager

14

CoroutineWorker - exemplu

• Funcția makeStatusNotification din WorkerUtil
• afișarea unui banner de notificare pe ecran

15 - Compose - WorkManager

15

CoroutineWorker - exemplu

• CoroutineWorker rulează cu Dispatchers.Default implicit
• configurăm Dispatchers.IO folosind withContext()
• thread pool pentru operații IO blocante
• return@withContext pentru a returna din lambda

15 - Compose - WorkManager

16

CoroutineWorker - exemplu

• Munca efectivă
• decodificăm și încărcăm imaginea ca bitmap
• aplicăm blur pe imagine
• salvăm imaginea într-un fișier temporar

15 - Compose - WorkManager

17

CoroutineWorker - exemplu

• Dacă munca este executată cu succes
• returnăm Result.success()
• În caz de excepție (nu este executată cu succes)
• returnăm Result.failure()

15 - Compose - WorkManager

18

Repository - interacțiune cu WorkManager

• În repository vom lucra cu WorkManager
• vom crea WorkRequest-uri
• vom instrui WorkManager să le ruleze

​

• 2 tipuri de WorkRequest-uri
• OneTimeWorkRequest - rulează o singură dată
• PeriodicWorkRequest - rulează periodic

15 - Compose - WorkManager

19

Repository - exemplu

• Instanța WorkManager

15 - Compose - WorkManager

20

Repository - exemplu

• Creăm un OneTimeWorkRequest folosind OneTimeWorkRequestBuilder
• specificăm tipul de Worker
• Instruim WorkManager să pornească acel WorkRequest

15 - Compose - WorkManager

21

Tipul Data

22

Tipul Data

• Inputul și outputul unui Worker
• obiecte de tip Data

​

• Data = container lightweight pentru perechi cheie/valoare

​

• Stochează o mică cantitate de date = input sau output pentru Worker

15 - Compose - WorkManager

23

Repository - Data - exemplu

• În repository
• funcție helper care crează un obiect de tip Data
• creează un obiect Data.Builder
• adaugă perechile chei-valoare în builder
• crează și returnează obiectul Data

15 - Compose - WorkManager

24

Repository - Data - exemplu

• În repository:
• creăm un input Data ce include 2 valori (nivel blur, URI)
• setăm inputul pentru WorkRequest
• folosind setInputData()

15 - Compose - WorkManager

25

Worker - Data - exemplu

• În Worker, în doWork()
• obținem valorile din input Data

15 - Compose - WorkManager

26

Worker - Data - exemplu

• În Worker, în doWork()
• folosim un ContentResolver
• obținem imaginea asociată cu acel URI
• decodificăm imaginea

15 - Compose - WorkManager

27

Worker - Data - exemplu

• În Worker, în doWork()
• aplicăm blur pe imagine
• scriem imaginea într-un fișier temporar
• punem în output Data URI-ul imaginii rezultate
• returnăm acest output Data din Worker
• util pentru lanțul de work-eri

15 - Compose - WorkManager

28

Lanț de workeri

29

Rularea workerilor

• Rularea unor WorkRequest-uri secvențial sau în paralel

​

15 - Compose - WorkManager

30

Lanț de WorkRequest-uri

• Lanț de WorkRequest-uri
• rulare secvențială
• outputul unui WorkRequest poate deveni inputul următorului WorkRequest

15 - Compose - WorkManager

31

Lanț de WorkRequest-uri

15 - Compose - WorkManager

32

Repository - lanț de WorkRequest-uri

• În repository, creăm lanțul
• beginWith() returnează un obiect WorkContinuation
• punctul de început pentru lanț - primul WorkRequest
• OneTimeWorkRequest.from() = creăm un WorkRequest ce rulează o singură dată

15 - Compose - WorkManager

33

Repository - lanț de WorkRequest-uri

• Creăm un WorkRequest cu un input Data
• folosind un OneTimeWorkRequestBuilder
• Folosim continuation.then() pentru a adăuga WorkRequest-ul la lanț

15 - Compose - WorkManager

34

Repository - lanț de WorkRequest-uri

• Creăm ultimul WorkRequest folosind un builder
• Adăugăm WorkRequest-ul la lanț
• Instruim WorkManager să execute lanțul folosind enqueue()

15 - Compose - WorkManager

35

Lanț unic de workeri

36

Lanț unic de workeri

• Dorim să rulăm un singur lanț de workeri la un moment dat
• => lanț unic de wokeri

​

• Folosim beginUniqueWork() în loc de beginWith()
• nume unic pentru lanț

​

​

15 - Compose - WorkManager

37

Politica

• ExistingWorkPolicy
• specifică ce se întâmplă dacă există deja un work în execuție
• REPLACE, KEEP, APPEND, APPEND_OR_REPLACE
• REPLACE înlocuiește workul anterior cu cel nou

15 - Compose - WorkManager

38

Repository - lanț unic de workeri

• beginUniqueWork() - pornim un lanț unic de workeri
• numele lanțului
• politica REPLACE
• WorkRequest

15 - Compose - WorkManager

39

Afișarea informațiilor în UI

40

Informații despre WorkRequest-uri

• Obținem informații despre WorkRequest-urile care rulează și actualizăm UI-ului

​

• Funcții pentru obținerea informațiilor
• getWorkInfoByIdLiveData()
• obținem pe baza id-ului unui WorkRequest
• returnează LiveData<WorkInfo> pentru un WorkRequest specific

15 - Compose - WorkManager

41

Informații despre WorkRequest-uri

• Funcții pentru obținerea informațiilor
• getWorkInfosForUniqueWorkLiveData()
• obținem pe baza numelui lanțului
• returnează un LiveData<List<WorkInfo>> pentru un lanț unic
• getWorkInfosByTagLiveData()
• obținem pe baza tag-ului
• returnează un LiveData<List<WorkInfo>> pentru un tag

15 - Compose - WorkManager

42

WorkInfo

• WorkInfo
• starea curentă a unui WorkRequest:
• BLOCKED, CANCELLED, ENQUEUED
• FAILED, RUNNING, SUCCEEDED
• dacă WorkRequest-ul este finalizat
• ID, tags
• date de ieșire

​

15 - Compose - WorkManager

43

LiveData

• Metodele returnează LiveData

• LiveData
• container de date observabil
• conștient de ciclul de viață

​

• Convertim LiveData într-un Flow de obiecte WorkInfo
• apelăm .asFlow()

​

15 - Compose - WorkManager

44

Repository - Tag - exemplu

• În repository
• Adăugăm un tag când creăm WorkRequest-ul pe care vrem să-l urmărim

15 - Compose - WorkManager

45

Repository - Tag - obținerea informațiilor

• În repository
• cerere de a obține informațiile pe baza tag-ului
• getWorkInfosByTagLiveData()
• returnează LiveData
• conversie în Flow folosind .asFlow()

15 - Compose - WorkManager

46

Repository - Tag - obținerea informațiilor

• Transformare mapNotNull()
• din List<WorkInfo> în WorkInfo
• Informațiile WorkInfo emise ca Flow din repo
• consumate de ViewModel

15 - Compose - WorkManager

47

ViewModel - stare UI - exemplu

15 - Compose - WorkManager

48

ViewModel - stare UI - exemplu

• Flow-ul outputWorkInfo din repository
• => starea UI-ului, de tip StateFlow
• map - maparea valorilor WorkInfo la stările BlurUiState

15 - Compose - WorkManager

49

ViewModel - stare UI - exemplu

• Funcția stateIn() - transformă Flow în StateFlow
• Flow = cold flow
• StateFlow = hot flow
• ViewModel expune informația către UI
• prin starea UI-ului de tipul StateFlow

15 - Compose - WorkManager

50

UI - colectăm starea UI-ului - exemplu

• În UI, colectăm ultima valoare din StateFlow ca State
• collectAsStateWithLifecycle()
• conștientă de ciclul de viață
• conservă resursele aplicației

15 - Compose - WorkManager

51

UI - folosirea informațiilor - exemplu

• În UI, folosim starea UI-ului (de tip State)
• în funcție de stare vom afișa elemente UI diferite
• ex: dacă starea este Default => afișăm un buton Start

15 - Compose - WorkManager

52

Anularea unui work

53

Anularea unui work

• Putem anula un work folosind:
• id
• tag
• numele lanțului unic

​

• Dacă vrem să anulăm un lanț întreg => folosim numele lanțului

15 - Compose - WorkManager

54

Repository - anularea unui lanț - exemplu

• În repository
• apelăm funcția cancelUniqueWork()
• numele lanțului

15 - Compose - WorkManager

55

ViewModel - anularea unui lanț - exemplu

• În ViewModel
• funcție care apelează funcția asociată din repo

15 - Compose - WorkManager

56

UI - anularea unui lanț - exemplu

• În UI
• folosim funcția din ViewModel

15 - Compose - WorkManager

57

Constrângeri

58

Constrângeri

• WorkManager oferă suport pentru constrângeri
• cerințe ce trebuie îndeplinite înainte de rularea unui WorkRequest

​

• Exemple de constrângeri:
• requiresDeviceIdle() - dacă dispozitivul este inactiv
• requiresStorageNotLow() - dacă spațiul de stocare nu este redus

15 - Compose - WorkManager

59

Repository - constrângere - exemplu

• Constrângere: nivelul bateriei să nu fie scăzut pentru a rula un WorkRequest specific
• Adăugăm constrângerea la WorkRequestBuilder

15 - Compose - WorkManager

60

Background Task Inspector

61

Background Task Inspector

• Tool din Android Studio

​

• Vizualizarea, monitorizarea, depanarea Worker-ilor
• în timp real

​

• Dispozitive emulate sau reale

​

• API peste 26 (Android 8)

15 - Compose - WorkManager

62

Background Task Inspector

• Putem vedea Workerii, starea lor, constrângerile
• Nu poate opri Workerii din execuție

63

Background Task Inspector

• Putem vedea dependențele între Workeri sub formă de graf

64

Bibliografie

• https://developer.android.com/courses/pathways/android-basics-compose-unit-7-pathway-1
• https://developer.android.com/develop/background-work/background-tasks
• https://developer.android.com/reference/androidx/work/WorkManager
• https://developer.android.com/topic/libraries/architecture/workmanager/
• https://developer.android.com/develop/background-work/background-tasks/persistent

15 - Compose - WorkManager

65

Bibliografie

• https://developer.android.com/develop/background-work/background-tasks/persistent/getting-started
• https://developer.android.com/develop/background-work/background-tasks/persistent/getting-started/define-work
• https://developer.android.com/develop/background-work/background-tasks/persistent/how-to/states
• https://developer.android.com/develop/background-work/background-tasks/persistent/how-to/manage-work
• https://developer.android.com/develop/background-work/background-tasks/persistent/how-to/chain-work

15 - Compose - WorkManager

66

Bibliografie

• https://www.youtube.com/playlist?list=PLWz5rJ2EKKc_J88-h0PhCO_aV0HIAs9Qk
• https://www.youtube.com/watch?v=Bz0z694SrEE
• https://www.youtube.com/watch?v=83a4rYXsDs0
• https://developer.android.com/studio/inspect/task
• https://abhiappmobiledeveloper.medium.com/use-of-workmanager-in-android-app-part-3-3c5c93e6f8a7
• https://medium.com/paycell-tech-team/understanding-the-differences-between-android-livedata-and-flow-92a89913d42b

15 - Compose - WorkManager

67

Bibliografie

• https://www.linkedin.com/pulse/flow-sharedflow-stateflow-livedata-complete-guide-sagar-malhotra/

68

Cuvinte cheie

• WorkManager
• Worker / CoroutineWorker
• WorkRequest
• Data
• Lanț de WorkRequest-uri
• Lanț unic
• LiveData
• Flow / StateFlow
• Constrângeri

15 - Compose - WorkManager

69

69