Debugowanie blokad uśpienia lokalnie
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Do debugowania aplikacji działającej lokalnie, która korzysta z blokad wybudzania, możesz użyć kilku narzędzi. Te narzędzia mogą pomóc w znalezieniu i rozwiązaniu problemów z wydajnością.
Te narzędzia mogą pomóc w debugowaniu lub optymalizacji blokad wybudzania:
- dumpsys udostępnia informacje o stanie usług systemowych na urządzeniu.
- Śledzenie systemu tworzy plik śledzenia, którego możesz użyć do wygenerowania raportu systemowego.
- Background Task Inspector w Android Studio pomaga monitorować blokady uśpienia, w tym blokady uśpienia, które mogą być wywoływane przez biblioteki takie jak WorkManager.
dumpsys
dumpsys to narzędzie działające na urządzeniach z Androidem, które dostarcza informacji o usługach systemowych urządzenia.
To polecenie jest szczególnie przydatne do debugowania blokad wybudzania:
adb shell dumpsys batterystats zawiera szczegółową historię blokad wybudzania
utrzymywanych przez poszczególne aplikacje. Więcej informacji znajdziesz w dokumentacji dumpsys Sprawdzanie diagnostyki baterii.
Śledzenie systemu
Śledzenie systemu rejestruje szeroki zakres aktywności urządzenia w krótkim czasie. Śledzenie systemu tworzy plik śledzenia, którego możesz użyć do wygenerowania raportu systemowego. Ten raport pomaga znajdować sposoby na zwiększenie skuteczności aplikacji.
Informacje o tym, jak zacząć, znajdziesz w tym krótkim przewodniku po śledzeniu systemu. Możesz też obejrzeć ten film o zwiększaniu wydajności baterii na Androidzie.
Background Task Inspector
Aby monitorować blokady wybudzania, alarmy i zadania, możesz użyć inspektora zadań w tle w Android Studio.
W szczególności biblioteka WorkManager używa JobScheduler do planowania i wykonywania zadań. Podczas wykonywania tych zadań są one w stanie aktywności, który jest przypisany do aplikacji. Za pomocą narzędzia Background Task Inspector możesz monitorować procesy i zadania wykonywane w tle oraz wyświetlać szczegóły ich działania.
Treść strony i umieszczone na niej fragmenty kodu podlegają licencjom opisanym w Licencji na treści. Java i OpenJDK są znakami towarowymi lub zastrzeżonymi znakami towarowymi należącymi do firmy Oracle lub jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-27 UTC.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 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."]]
