Eseguire il debug dei wakelock localmente
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Esistono diversi strumenti che puoi utilizzare per eseguire il debug di un'app in esecuzione in locale che utilizza
wake lock. Questi strumenti possono aiutarti a identificare e risolvere i problemi di prestazioni.
I seguenti strumenti possono aiutarti a eseguire il debug o l'ottimizzazione dei wake lock:
- dumpsys fornisce informazioni sullo stato dei servizi di sistema su un dispositivo.
- La traccia di sistema produce un file di traccia che puoi utilizzare per
generare un report di sistema.
- Background Task Inspector di Android Studio ti aiuta a
monitorare i wake lock, inclusi quelli che potrebbero essere acquisiti da librerie
come WorkManager.
dumpsys
dumpsys è uno strumento che viene eseguito sui dispositivi Android e fornisce
informazioni sui servizi di sistema del dispositivo.
Il seguente comando è particolarmente utile per il debug dei wake lock:
adb shell dumpsys batterystats fornisce una cronologia dettagliata dei wake lock
mantenuti da ogni app. Per ulteriori informazioni, consulta la documentazione di dumpsys Inspect battery
diagnostics.
Tracciamento del sistema
La traccia di sistema registra un'ampia gamma di attività del dispositivo
in un breve periodo. La traccia di sistema produce un file di traccia che puoi utilizzare per generare un report di sistema. Questo report ti aiuta a identificare i modi per migliorare il rendimento della tua app.
Per informazioni su come iniziare, consulta questa guida rapida alla tracciatura del sistema. Puoi anche guardare questo video su come migliorare
l'efficienza della batteria di Android.
Background Task Inspector
Puoi utilizzare lo
strumento di controllo delle attività in background di Android Studio per monitorare wake lock,
allarmi e job.
In particolare, la libreria WorkManager utilizza JobScheduler per pianificare ed eseguire
i job. Mentre questi job sono in esecuzione, mantengono un wake lock attribuito
all'app. Puoi utilizzare Background Task Inspector per monitorare i worker e i job
che vengono eseguiti in background e visualizzare i dettagli del loro lavoro.
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2025-08-27 UTC.
[null,null,["Ultimo aggiornamento 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."]]
