Cómo depurar tus trabajadores de WorkManager con el Inspector de tareas en segundo plano

En Android Studio Arctic Fox y versiones posteriores, el Inspector de tareas en segundo plano te ayuda a visualizar, supervisar y depurar los trabajadores en segundo plano de tu app cuando usas la biblioteca de WorkManager en la versión 2.5.0 o una posterior.

Cómo comenzar

Para enumerar los trabajadores en el Inspector de tareas en segundo plano, haz lo siguiente:

  1. Ejecuta tu app en un emulador o un dispositivo conectado con nivel de API 26 o posterior.

  2. Selecciona View > Tool Windows > App Inspection en la barra de menú.

  3. Selecciona la pestaña Background Task Inspector.

  4. Selecciona el proceso de la app en ejecución en el menú desplegable.

  5. Los trabajadores de la app que se encuentra en ejecución se muestran en el panel Background Task Inspector. Haz clic en el trabajador que deseas inspeccionar mejor.

Cómo ver e inspeccionar a trabajadores

Si implementas una app con WorkManager 2.5.0 o versiones posteriores en un dispositivo que ejecuta el nivel de API 26 o posterior, deberías ver trabajadores activos en la pestaña Background Task Inspector, como se muestra a continuación.

Captura de pantalla de la ventana de Background Task Inspector.
Figura 1: Ventana de Background Task Inspector.

El Inspector de tareas en segundo plano muestra el nombre de la clase, el estado actual, la hora de inicio, los reintentos y los datos de salida de todos los trabajos, ya sea que se estén ejecutando, estén listos o hayan fallado.

Detalles del trabajo

Si haces clic en un trabajo específico de la lista, se abre el panel Work Details, que muestra información detallada del trabajador.

Captura de pantalla de los detalles del trabajador seleccionado.
Figura 2: Detalles del trabajo.

Descripción

La sección Description enumera el nombre de la clase de trabajador con el paquete completamente calificado, así como la etiqueta asignada y el UUID de ese trabajador.

Ejecución

En la sección Execution, se muestran las restricciones del trabajador (si existen), la frecuencia de ejecución, su estado y la clase que creó y puso en cola este trabajador.

WorkContuniation

En la sección WorkContinuation, se muestra la ubicación de este trabajador en la cadena de trabajo. Para verificar los detalles de otro trabajador de la cadena de trabajo, haz clic en su UUID.

Resultados

En la sección Results, se muestra la hora de inicio y el recuento de reintentos, además de los datos de salida del trabajador seleccionado.

Cómo cancelar trabajadores

Para detener un trabajador en ejecución o en cola, selecciónalo y haz clic en Cancel Selected Worker en la barra de herramientas.

Ver vista de gráfico

Debido a que los trabajadores se pueden encadenar juntos, a veces es útil visualizar sus dependencias a modo de gráfico. Para ver una representación visual de una cadena de trabajadores, selecciona un trabajador de la tabla y haz clic en Show Graph View  en la barra de herramientas.

Captura de pantalla de la vista de gráfico.
Figura 3: Vista de gráfico.

El gráfico te permite ver con rapidez las relaciones entre los trabajadores y supervisar su progreso en relaciones de encadenamiento complejas.

Para volver a la vista de lista, haz clic en Show List View .

Recursos adicionales

Para obtener más información sobre el Inspector de tareas en segundo plano, consulta los siguientes recursos adicionales:

Documentación

Codelabs

Entradas de blog