Esegui il debug dei worker di WorkManager con Controllo attività in background

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:

  1. Esegui la tua app su un emulatore o su un dispositivo connesso con livello API 26 o successivo.

  2. Seleziona Visualizza > Finestre degli strumenti > Controllo app dalla barra dei menu.

  3. Seleziona la scheda Controllo attività in background.

  4. Seleziona il processo dell'app in esecuzione dal menu.

  5. 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.

Screenshot dei dettagli del worker selezionato.
Figura 1. Riquadro Dettagli lavoro.
  • 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.

Screenshot della visualizzazione Grafico.
Figura 2. Visualizzazione grafico.

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.

Screenshot della finestra Controllo attività in background.
Figura 3. La finestra Controllo attività in background.

Risorse aggiuntive

Per ulteriori informazioni su Controllo attività in background, consulta le seguenti risorse aggiuntive:

Documentazione

Codelab

Post del blog