Men-debug kunci layar saat aktif secara lokal
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Ada sejumlah alat yang dapat Anda gunakan untuk men-debug aplikasi yang berjalan secara lokal yang menggunakan kunci tetap aktif. Alat ini dapat membantu Anda mengidentifikasi dan memperbaiki masalah performa.
Alat berikut dapat membantu Anda men-debug atau mengoptimalkan kunci tetap aktif:
- dumpsys memberikan informasi tentang status layanan sistem di perangkat.
- Pelacakan sistem menghasilkan file rekaman aktivitas yang dapat Anda gunakan untuk membuat laporan sistem.
- Background Task Inspector Android Studio membantu Anda
memantau kunci tetap aktif, termasuk kunci tetap aktif yang mungkin diperoleh oleh library
seperti WorkManager.
dumpsys
dumpsys adalah alat yang berjalan di perangkat Android dan memberikan informasi tentang layanan sistem perangkat.
Perintah berikut sangat berguna untuk melakukan proses debug kunci aktif:
adb shell dumpsys batterystats
memberikan histori mendetail tentang kunci tetap aktif
yang dipegang oleh setiap aplikasi. Untuk mengetahui informasi selengkapnya, lihat dokumentasi dumpsys Periksa diagnostik
baterai.
Pelacakan sistem
Pelacakan sistem merekam berbagai aktivitas perangkat dalam waktu singkat. Pelacakan sistem menghasilkan file rekaman aktivitas yang dapat Anda gunakan untuk membuat laporan sistem. Laporan ini membantu Anda mengidentifikasi cara meningkatkan performa aplikasi.
Untuk mengetahui informasi tentang cara memulai, lihat panduan memulai cepat pelacakan sistem ini. Anda juga dapat menonton video ini tentang cara meningkatkan efisiensi baterai Android.
Background Task Inspector
Anda dapat menggunakan
Background Task Inspector Android Studio untuk memantau wake lock, alarm, dan tugas.
Secara khusus, library WorkManager menggunakan JobScheduler untuk menjadwalkan dan mengeksekusi tugas. Saat tugas ini berjalan, tugas tersebut akan menahan kunci tetap aktif yang diatribusikan
ke aplikasi. Anda dapat menggunakan Background Task Inspector untuk memantau pekerja dan tugas
yang dijalankan di latar belakang dan melihat detail tentang tugasnya.
Konten dan contoh kode di halaman ini tunduk kepada lisensi yang dijelaskan dalam Lisensi Konten. Java dan OpenJDK adalah merek dagang atau merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-27 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 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."]]