Depurar wake locks localmente
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Há várias ferramentas que você pode usar para depurar um app em execução local que usa
bloqueios de despertar. Essas ferramentas podem ajudar você a identificar e corrigir problemas de desempenho.
As ferramentas a seguir podem ajudar você a depurar ou otimizar os bloqueios de despertar:
- O dumpsys fornece informações sobre o status dos serviços do sistema
em um dispositivo.
- O rastreamento do sistema produz um arquivo que pode ser usado para
gerar um relatório do sistema.
- O Inspetor de tarefas em segundo plano do Android Studio ajuda você a
monitorar wake locks, incluindo aqueles que podem ser adquiridos por bibliotecas
como o WorkManager.
dumpsys
dumpsys é uma ferramenta que é executada em dispositivos Android e fornece informações sobre os serviços do sistema do dispositivo.
O comando a seguir é especialmente útil para depurar bloqueios de despertar:
- O
adb shell dumpsys batterystats fornece um histórico detalhado dos bloqueios de despertar
mantidos por cada app. Para mais informações, consulte a documentação do dumpsys Inspecionar diagnósticos
da bateria.
Rastreamento do sistema
O rastreamento do sistema registra uma ampla variedade de atividades do dispositivo
em um curto período. O rastreamento do sistema produz um arquivo de rastreamento que pode ser usado para
gerar um relatório do sistema. Esse relatório ajuda a identificar maneiras de melhorar o desempenho do
app.
Para saber como começar, consulte este guia de início rápido de rastreamento do sistema. Você também pode assistir este vídeo sobre como melhorar a eficiência da bateria do Android.
Inspetor de tarefas em segundo plano
Use o Inspetor de tarefas em segundo plano do Android Studio para monitorar bloqueios de despertar, alarmes e jobs.
Em particular, a biblioteca WorkManager usa o JobScheduler para programar e executar
jobs. Enquanto esses jobs estão em execução, eles mantêm um bloqueio de despertar atribuído
ao app. Use o Inspetor de tarefas em segundo plano para monitorar workers e jobs
que são executados em segundo plano e ver detalhes sobre o trabalho deles.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-08-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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."]]
