La finestra Controllo attività in background ti consente di visualizzare, monitorare ed eseguire il debug dei worker in background della tua app quando utilizzi la libreria WorkManager 2.5.0 o versioni successive.
Inizia
Per elencare i worker in Background Task Inspector:
Esegui la tua app su un emulatore o su un dispositivo connesso con livello API 26 o successivo.
Seleziona Visualizza > Finestre degli strumenti > Controllo app dalla barra dei menu.
Seleziona la scheda Controllo attività in background.
Seleziona il processo dell'app in esecuzione dal menu.
I worker nell'app attualmente in esecuzione vengono visualizzati nel riquadro Controllo attività in background. Fai clic sul worker che vuoi ispezionare ulteriormente.
Visualizzare e ispezionare i worker
Quando esegui il deployment di un'app utilizzando WorkManager 2.5.0 o versioni successive su un dispositivo con livello API 26 o successivo, la scheda Controllo attività in background mostra i worker attivi. Controllo attività in background (mostrato in una sezione successiva come figura 3) elenca il nome della classe, lo stato attuale, l'ora di inizio e i nuovi tentativi per tutti i job, indipendentemente dal fatto che siano in esecuzione, non riusciti o completati.
Dettagli lavoro
Fai clic su un lavoro nell'elenco per aprire il riquadro Dettagli lavoro, che mostra informazioni dettagliate sul lavoratore, come mostrato nella Figura 1.
- Descrizione: in questa sezione sono elencati il nome della classe worker, con il pacchetto completo, nonché il tag assegnato e l'UUID del worker.
- Esecuzione: questa sezione mostra gli eventuali vincoli del worker, la frequenza di esecuzione e lo stato, nonché la classe che ha creato e messo in coda il worker.
- WorkContinuation: questa sezione mostra dove si trova il worker nella catena di lavoro. Per controllare i dettagli di un altro worker nella catena di lavoro, fai clic sul suo UUID.
- Risultati: questa sezione visualizza l'ora di inizio, il conteggio dei tentativi e i dati di output del worker selezionato.
Annulla worker
Per interrompere un worker attualmente in esecuzione o accodato, seleziona il worker e fai clic su Annulla worker selezionato dalla barra degli strumenti.
Visualizza visualizzazione grafico
Poiché i worker possono essere concatenati, a volte è utile visualizzare le dipendenze dei worker sotto forma di grafico.
Per visualizzare una rappresentazione visiva di una catena worker, seleziona un worker dalla tabella e fai clic su Mostra visualizzazione grafico dalla barra degli strumenti. Nel grafico vengono tracciati solo i worker.
Il grafico consente di vedere rapidamente le relazioni tra i lavoratori e monitorare i loro progressi in relazioni di concatenamento complesse.
Per tornare alla visualizzazione elenco, fai clic su Mostra visualizzazione elenco .
Visualizzare e ispezionare offerte di lavoro, sveglie e sveglie
La finestra Controllo attività in background ti consente inoltre di esaminare i processi, le sveglie e i wakelock dell'app. Ogni tipo di attività asincrona viene visualizzata sotto l'intestazione appropriata nella scheda Controllo, consentendoti di monitorarne facilmente lo stato e l'avanzamento.
Come per i worker, puoi selezionare un job, una sveglia o un wakelock per esaminarne le informazioni dettagliate nel riquadro Dettagli attività.
Per visualizzare informazioni dettagliate su un worker, job, sveglia o wakelock, selezionalo nel riquadro Dettagli attività a destra.
Risorse aggiuntive
Per ulteriori informazioni su Controllo attività in background, consulta le seguenti risorse aggiuntive: