Quando utilizzi un Worker, WorkManager chiama automaticamente Worker.doWork() su un thread in background. Il thread in background proviene dal Executor
specificato in Configuration di WorkManager.
Per impostazione predefinita, WorkManager configura un Executor per te, ma puoi anche personalizzarne uno tuo. Ad esempio, puoi condividere un Executor in background esistente nella tua app, creare un Executor a thread singolo per assicurarti che tutto il lavoro in background venga eseguito in sequenza o persino specificare un Executor personalizzato. Per personalizzare
Executor, assicurati di inizializzare WorkManager manualmente.
Quando configuri WorkManager manualmente, puoi specificare Executor come segue:
WorkManager.initialize( context, Configuration.Builder() // Uses a fixed thread pool of size 8 threads. .setExecutor(Executors.newFixedThreadPool(8)) .build() )
Ecco un esempio di un semplice Worker che scarica i contenuti di una pagina web
100 volte:
class DownloadWorker(context: Context, params: WorkerParameters) : Worker(context, params) { override fun doWork(): ListenableWorker.Result { repeat(100) { try { downloadSynchronously("https://www.google.com") } catch (e: IOException) { return ListenableWorker.Result.failure() } } return ListenableWorker.Result.success() } }
Tieni presente che Worker.doWork() è una chiamata sincrona: devi eseguire l'intero lavoro in background in modo bloccante e completarlo entro l'uscita dal metodo. Se chiami un'API asincrona in doWork() e restituisci un Result, il callback potrebbe non funzionare correttamente. Se ti trovi in questa situazione, valuta la possibilità di utilizzare un ListenableWorker (consulta Threading in ListenableWorker).
Quando un Worker attualmente in esecuzione viene interrotto per qualsiasi motivo, riceve una chiamata a Worker.onStopped(). Esegui l'override di questo metodo o chiama Worker.isStopped() per creare un checkpoint del codice e liberare risorse quando necessario. Quando l'elemento Worker nell'esempio precedente viene interrotto, potrebbe trovarsi nel mezzo del ciclo di download degli elementi e continuerà a farlo anche se è stato interrotto. Per ottimizzare questo comportamento, puoi procedere come segue:
class DownloadWorker(context: Context, params: WorkerParameters) : Worker(context, params) { override fun doWork(): ListenableWorker.Result { for (i in 0 until 100) { if (isStopped) { break } try { downloadSynchronously("https://www.google.com") } catch (e: IOException) { return ListenableWorker.Result.failure() } } return ListenableWorker.Result.success() } }
Una volta interrotto un Worker, non importa cosa restituisci da Worker.doWork(); Result verrà ignorato.