Si notas que tus trabajadores se ejecutan con demasiada frecuencia o no se ejecutan, estos son algunos pasos de depuración que pueden ayudarte a descubrir lo que sucede.
Cómo habilitar el registro
Para determinar por qué no se ejecutan correctamente los trabajadores, puede ser muy útil consultar los registros con verbosidad de WorkManager. Para habilitar el registro, usa la inicialización personalizada.
Primero, inhabilita el WorkManagerInitializer
predeterminado en tu archivo AndroidManifest.xml
creando un nuevo proveedor de WorkManager con la regla de combinación de manifiesto remove
aplicada:
<provider
android:name="androidx.work.impl.WorkManagerInitializer"
android:authorities="${applicationId}.workmanager-init"
tools:node="remove"/>
Ahora que el inicializador predeterminado de WorkManager está inhabilitado, puedes usar la inicialización a pedido.
Para ello, la clase android.app.Application
debe proporcionar una implementación de androidx.work.Configuration.Provider
:
Kotlin
class MyApplication() : Application(), Configuration.Provider { override fun getWorkManagerConfiguration() = Configuration.Builder() .setMinimumLoggingLevel(android.util.Log.DEBUG) .build() }
Java
public class MyApplication extends Application implements Configuration.Provider { @NonNull @Override public Configuration getWorkManagerConfiguration() { return new Configuration.Builder() .setMinimumLoggingLevel(android.util.Log.DEBUG) .build(); } }
Cuando defines una configuración personalizada de WorkManager, este se inicializa cuando llamas a WorkManager.getInstance(Context)
en lugar de hacerlo automáticamente cuando se inicia la aplicación. Consulta Configuración e inicialización personalizadas de WorkManager para obtener más información, incluida la asistencia para versiones de WorkManager anteriores a la 2.1.0.
Cuando el registro de DEBUG
esté habilitado, verás muchos más registros con el prefijo de etiqueta WM-
.
Cómo usar adb shell dumpsys jobscheduler
Puedes usar adb
para obtener más información sobre la programación de trabajos en Android 6.0 (nivel de API 23) o versiones posteriores. Si es la primera vez que usas adb
, consulta Herramientas de línea de comandos para obtener más detalles.
Una vez que hayas instalado adb
, ejecuta el siguiente comando para ver la lista de trabajos atribuidos a tu paquete:
adb shell dumpsys jobscheduler
El resultado debería ser similar al siguiente:
JOB #u0a172/4: 6412553 com.google.android.youtube/androidx.work.impl.background.systemjob.SystemJobService
u0a172 tag=*job*/com.google.android.youtube/androidx.work.impl.background.systemjob.SystemJobService
Source: uid=u0a172 user=0 pkg=com.google.android.youtube
JobInfo:
Service: com.google.android.youtube/androidx.work.impl.background.systemjob.SystemJobService
Requires: charging=false batteryNotLow=false deviceIdle=false
Extras: mParcelledData.dataSize=180
Network type: NetworkRequest [ NONE id=0, [ Capabilities: NOT_METERED&INTERNET&NOT_RESTRICTED&TRUSTED&VALIDATED Uid: 10172] ]
Minimum latency: +1h29m59s687ms
Backoff: policy=1 initial=+30s0ms
Has early constraint
Required constraints: TIMING_DELAY CONNECTIVITY [0x90000000]
Satisfied constraints: DEVICE_NOT_DOZING BACKGROUND_NOT_RESTRICTED WITHIN_QUOTA [0x3400000]
Unsatisfied constraints: TIMING_DELAY CONNECTIVITY [0x90000000]
Tracking: CONNECTIVITY TIME QUOTA
Implicit constraints:
readyNotDozing: true
readyNotRestrictedInBg: true
Standby bucket: RARE
Base heartbeat: 0
Enqueue time: -51m29s853ms
Run time: earliest=+38m29s834ms, latest=none, original latest=none
Last run heartbeat: 0
Ready: false (job=false user=true !pending=true !active=true !backingup=true comp=true)
Cuando se usa WorkManager, el componente responsable de administrar la ejecución de trabajadores es SystemJobService
en el nivel de API 23 o versiones posteriores. Busca instancias de trabajos que se atribuyan a tu nombre de paquete y androidx.work.impl.background.systemjob.SystemJobService
.
Para cada trabajo, el resultado del comando indica las restricciones obligatorias, satisfechas e insatisfechas. Verifica si las restricciones de tu trabajador están completamente satisfechas.
El resultado también incluye el historial de trabajos de los trabajos ejecutados recientemente, por lo que puedes usarlo para verificar si SystemJobService
se invocó hace poco.
Job history:
-1h35m26s440ms START: #u0a107/9008 com.google.android.youtube/androidx.work.impl.background.systemjob.SystemJobService
-1h35m26s362ms STOP-P: #u0a107/9008 com.google.android.youtube/androidx.work.impl.background.systemjob.SystemJobService app called jobFinished
Cómo solicitar información de diagnóstico de WorkManager 2.4.0 y versiones posteriores
En las compilaciones de depuración de tu app, puedes solicitar información de diagnóstico de WorkManager 2.4.0 y versiones posteriores con el siguiente comando:
adb shell am broadcast -a "androidx.work.diagnostics.REQUEST_DIAGNOSTICS" -p "<your_app_package_name>"
Esto proporciona información sobre lo siguiente:
- Solicitudes de trabajo completadas en las últimas 24 horas.
- Solicitudes de trabajo actualmente en ejecución
- Solicitudes de trabajo programadas.
La información podría verse así (el resultado es visible a través de logcat
):
adb shell am broadcast -a "androidx.work.diagnostics.REQUEST_DIAGNOSTICS" -p "androidx.work.integration.testapp"
adb logcat
...
2020-02-13 14:21:37.990 29528-29660/androidx.work.integration.testapp I/WM-DiagnosticsWrkr: Recently completed work:
2020-02-13 14:21:38.083 29528-29660/androidx.work.integration.testapp I/WM-DiagnosticsWrkr: Id Class Name State Unique Name Tags
08be261c-2def-4bd6-a716-1e4410968dc4 androidx.work.impl.workers.DiagnosticsWorker SUCCEEDED null androidx.work.impl.workers.DiagnosticsWorker
48ce04f1-8df9-450b-96ec-6eceabb9c690 androidx.work.impl.workers.DiagnosticsWorker SUCCEEDED null androidx.work.impl.workers.DiagnosticsWorker
c46f4699-c384-440c-a10e-26d56ce02963 androidx.work.impl.workers.DiagnosticsWorker SUCCEEDED null androidx.work.impl.workers.DiagnosticsWorker
ce125372-046e-484e-949f-9abb35ce62c3 androidx.work.impl.workers.DiagnosticsWorker SUCCEEDED null androidx.work.impl.workers.DiagnosticsWorker
72887ddd-8ed1-4018-b798-fac218e95e16 androidx.work.impl.workers.DiagnosticsWorker SUCCEEDED null androidx.work.impl.workers.DiagnosticsWorker
dcff3d61-320d-4996-8644-5d97944bd09c androidx.work.impl.workers.DiagnosticsWorker SUCCEEDED null androidx.work.impl.workers.DiagnosticsWorker
acab0bf7-6087-43ad-bdb5-be0df9195acb androidx.work.impl.workers.DiagnosticsWorker SUCCEEDED null androidx.work.impl.workers.DiagnosticsWorker
23136bcd-01dd-46eb-b910-0fe8a140c2a4 androidx.work.integration.testapp.ToastWorker SUCCEEDED null androidx.work.integration.testapp.ToastWorker
245f4879-c6d2-4997-8130-e4e90e1cab4c androidx.work.integration.testapp.ToastWorker SUCCEEDED null androidx.work.integration.testapp.ToastWorker
17d05835-bb61-429a-ad11-fe43fc320a54 androidx.work.integration.testapp.ToastWorker SUCCEEDED null androidx.work.integration.testapp.ToastWorker
e95f12be-4b0c-4e64-88da-8ee07a31e42f androidx.work.integration.testapp.ToastWorker SUCCEEDED null androidx.work.integration.testapp.ToastWorker
431c3ec2-4a55-469b-b50b-4072d35f1232 androidx.work.integration.testapp.ToastWorker SUCCEEDED null androidx.work.integration.testapp.ToastWorker
883a388f-f911-4098-9143-37bd8fbc098a androidx.work.integration.testapp.ToastWorker SUCCEEDED null androidx.work.integration.testapp.ToastWorker
b904163c-6822-4299-8d5a-78df49b7e53d androidx.work.integration.testapp.ToastWorker SUCCEEDED null androidx.work.integration.testapp.ToastWorker
453fd7b9-2b16-45b9-abc5-3d2ce7b6a4ba androidx.work.integration.testapp.ToastWorker SUCCEEDED null androidx.work.integration.testapp.ToastWorker
2020-02-13 14:21:38.083 29528-29660/androidx.work.integration.testapp I/WM-DiagnosticsWrkr: Running work:
2020-02-13 14:21:38.089 29528-29660/androidx.work.integration.testapp I/WM-DiagnosticsWrkr: Id Class Name State Unique Name Tags
b87c8a4f-4ac6-4e25-ba3e-4cea53ce468a androidx.work.impl.workers.DiagnosticsWorker RUNNING null androidx.work.impl.workers.DiagnosticsWorker
...