Cómo depurar bloqueos de activación de forma local
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Existen varias herramientas que puedes usar para depurar una app que se ejecuta de forma local y que usa bloqueos de activación. Estas herramientas pueden ayudarte a identificar y corregir problemas de rendimiento.
Las siguientes herramientas pueden ayudarte a depurar o optimizar tus bloqueos de activación:
- dumpsys proporciona información sobre el estado de los servicios del sistema en un dispositivo.
- El registro del sistema genera un archivo de registro que puedes usar para generar un informe del sistema.
- El Inspector de tareas en segundo plano de Android Studio te ayuda a supervisar los bloqueos de activación, incluidos los que pueden adquirir bibliotecas como WorkManager.
dumpsys
dumpsys es una herramienta que se ejecuta en dispositivos Android y proporciona información sobre los servicios del sistema del dispositivo.
El siguiente comando es particularmente útil para depurar bloqueos de activación:
adb shell dumpsys batterystats proporciona un historial detallado de los bloqueos de activación que mantiene cada app. Para obtener más información, consulta la documentación de dumpsys Inspect battery diagnostics.
Registro del sistema
El registro del sistema registra una amplia variedad de actividades del dispositivo durante un período breve. El registro del sistema genera un archivo de registro que puedes usar para generar un informe del sistema. Este informe te ayuda a identificar formas de mejorar el rendimiento de tu app.
Para obtener información sobre cómo comenzar, consulta esta guía de inicio rápido del registro del sistema. También puedes mirar este video para mejorar la eficiencia de la batería de Android.
Inspector de tareas en segundo plano
Puedes usar el Inspector de tareas en segundo plano de Android Studio para supervisar bloqueos de activación, alarmas y trabajos.
En particular, la biblioteca de WorkManager usa JobScheduler para programar y ejecutar trabajos. Mientras se ejecutan estos trabajos, mantienen un bloqueo de activación que se atribuye a la app. Puedes usar el Inspector de tareas en segundo plano para supervisar los trabajadores y los trabajos que se ejecutan en segundo plano, y ver detalles sobre su trabajo.
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-08-27 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-27 (UTC)"],[],[],null,["There are a number of tools you can use to debug a locally-running app that uses\nwake locks. These tools can help you identify and fix performance issues.\n| **Note:** [Some APIs acquire wake locks that are attributed to your app](/develop/background-work/background-tasks/awake#actions-keep). This means your app might be using wake locks even though you aren't writing that code explicitly. If your app has mysterious performance issues, it can be helpful to check if there are misbehaving wake locks. If your app is holding wake locks and you don't recognize the names, [Identify wake locks created by other APIs](/develop/background-work/background-tasks/awake/wakelock/identify-wls) can help you identify the API that might have created them.\n\nThe following tools can help you debug or optimize your wake locks:\n\n- [dumpsys](#dumpsys) provides information about the status of system services on a device.\n- [System tracing](#system-tracing) produces a trace file that you can use to generate a system report.\n- The Android Studio [Background Task Inspector](#bg-task) helps you to monitor wake locks, including wake locks that might be acquired by libraries like WorkManager.\n\ndumpsys\n\n[dumpsys](/tools/dumpsys) is a tool that runs on Android devices and provides\ninformation about the device's system services.\n\nThe following command is particularly useful for debugging wake locks:\n\n- `adb shell dumpsys batterystats` provides a detailed history of wake locks held by each app. For more information, see the dumpsys [Inspect battery\n diagnostics](/tools/dumpsys#battery) documentation.\n\nSystem tracing\n\n[System tracing](/topic/performance/tracing) records a wide range of device activity\nover a short period. System tracing produces a *trace file* that you can use to\ngenerate a system report. This report helps you identify ways to improve your\napp's performance.\n\nFor information on how to get started, see this [system tracing quickstart\nguide](https://perfetto.dev/docs/quickstart/android-tracing). You can also watch [this video on improving\nAndroid battery efficiency](https://youtu.be/jS46zP8kQ3k?si=BCteWawO-rK7EAGl).\n\nBackground Task Inspector\n\nYou can use Android Studio's\n[Background Task Inspector](/studio/inspect/task) to monitor [wake locks,\nalarms and jobs](/studio/inspect/task#inspect-jobs-alarms-wakelocks).\n\nIn particular, the WorkManager library uses JobScheduler to schedule and execute\njobs. While these jobs are running, they hold a wake lock that is attributed\nto the app. You can use Background Task Inspector to monitor workers and jobs\nthat execute in the background and see details about their work."]]
