Beberapa library dan API sistem dapat memperoleh kunci tetap aktif yang dapat diatribusikan ke aplikasi Anda. Hal ini dapat mempersulit identifikasi kunci tetap aktif di aplikasi Anda yang mungkin menyebabkan masalah. Jika Anda salah menggunakan API, hal itu dapat menyebabkan aplikasi Anda mempertahankan kunci tetap aktif terlalu lama, meskipun Anda tidak memanggil API kunci tetap aktif secara langsung.
Dokumen ini mencantumkan beberapa nama kunci tetap aktif umum yang mungkin Anda lihat saat menggunakan alat proses debug kunci tetap aktif. Anda juga dapat melihat nama ini dalam laporan dari Android vitals. Dalam beberapa kasus, kunci aktif mungkin telah dibuat oleh library atau API sistem. Dalam kasus lain, ada alasan mengapa alat meng-obfuscate nama penguncian layar saat aktif yang Anda gunakan di aplikasi. Anda dapat menggunakan alat debug untuk mengidentifikasi penguncian layar saat aktif yang berperilaku tidak semestinya, lalu menelusuri nama penguncian layar saat aktif dalam dokumen ini untuk mengidentifikasi API mana yang mungkin menyebabkan masalah dan cara menyelesaikannya.
Dokumen ini membahas skenario saat kunci aktif mungkin dibuat. Dalam setiap kasus, meskipun kunci tetap aktif mungkin dibuat oleh library atau API lain, kunci tersebut diatribusikan ke aplikasi yang memanggil API tersebut.
AlarmManager- Audio dan media
- Firebase Cloud Message (FCM)
- JobScheduler
- Lokasi
- WorkManager
_UNKNOWN: Ditampilkan oleh alat proses debug jika nama kunci tetap aktif tampaknya menggunakan informasi identitas pribadi (PII).
AlarmManager
AlarmManager mendapatkan penguncian layar saat aktif dan mengatribusikannya ke aplikasi
penelepon. AlarmManager mendapatkan penguncian layar saat aktif saat alarm berbunyi, dan melepaskan
penguncian saat metode onReceive() siaran alarm selesai
dieksekusi.
Nama penguncian layar saat aktif
AlarmManager membuat kunci aktif dengan nama *alarm*. (Tanda bintang adalah bagian dari nama kunci tetap aktif, bukan karakter pengganti.)
Rekomendasi
Sebaiknya lakukan praktik berikut untuk mengoptimalkan perilaku alarm:
- Gunakan
AlarmManageruntuk mengoptimalkan frekuensi penjadwalan alarm. - Hanya gunakan alarm
RTC_WAKEUP(yang mengaktifkan perangkat) jika diperlukan. - Minimalkan penggunaan alarm, dan hindari melakukan pekerjaan yang panjang dalam metode
onReceive().
Audio dan media
API Media dapat memperoleh kunci aktif saat merekam atau memutar audio. Wake lock dikaitkan dengan aplikasi pemanggil.
Nama penguncian layar saat aktif
API Media mendapatkan penguncian layar saat aktif dengan berbagai nama yang diawali dengan Audio:
AudioBitPerfect: Digunakan untuk pemutaran audio USB lossless.AudioDirectOut: Digunakan untuk pemutaran audio lossless di TV atau perangkat khusus.AudioDup: Digunakan untuk pemutaran notifikasi saat terhubung melalui Bluetooth atau USB.AudioIn: Digunakan untuk merekam audio saat dalam mode camcorder dan mikrofon aktif.AudioMix: Digunakan untuk pemutaran audio ke perangkat umum.AudioOffload: Digunakan untuk pemutaran hanya musik jangka panjang, untuk aplikasi yang mendukung mode ini.AudioSpatial: Digunakan untuk pemutaran audio film atau musik multi-saluran di perangkat yang mendukung audio spasial.AudioUnknown: Digunakan saat situasi lain tidak berlaku.MmapCapture: Digunakan untuk pengambilan audio latensi rendah.MmapPlayback: Digunakan untuk pemutaran latensi rendah, seperti untuk game atau untuk aplikasi audio profesional.
Rekomendasi
Sebaiknya lakukan praktik berikut:
- Jangan gunakan nama penguncian layar saat aktif yang dimulai dengan
Audio. - Jika menggunakan media API, Anda tidak perlu mendapatkan kunci tetap aktif secara langsung; Anda dapat mengandalkan API untuk mendapatkan kunci tetap aktif yang diperlukan untuk Anda.
- Saat Anda menggunakan API media, akhiri sesi media jika Anda tidak lagi memerlukannya.
Firebase Cloud Message (FCM)
GCM mendapatkan kunci wake saat mengirimkan siaran Firebase Cloud Message (FCM) ke aplikasi. Kunci wake dilepaskan setelah metode onMessageReceived() siaran FCM selesai dieksekusi.
Nama penguncian layar saat aktif
GCM memperoleh kunci tetap aktif dengan nama GOOGLE_C2DM.
Rekomendasi
Sebaiknya lakukan praktik berikut untuk mengoptimalkan perilaku FCM:
- Mengoptimalkan frekuensi pengiriman FCM.
- Jangan gunakan FCM prioritas tinggi kecuali jika pesan benar-benar perlu dikirimkan segera.
- Selesaikan metode
onMessageReceived()secepat mungkin. Lihat panduan Firebase untuk mengetahui informasi selengkapnya.
JobScheduler
Tugas JobScheduler memperoleh wake lock saat menjalankan tugas di latar belakang. Wake lock diatribusikan ke aplikasi yang membuat pekerja.
Nama penguncian layar saat aktif
Nama kunci tetap aktif yang diperoleh oleh JobScheduler bergantung pada versi sistem Android yang dijalankannya, dan tujuan tugas.
Item yang diapit tanda kurung siku adalah variabel. Misalnya,
"<package_name>" adalah nama paket aplikasi Anda, bukan
teks literal <package name>. Namun, *job* adalah urutan karakter
*job*, dengan tanda bintang; tanda bintang tidak digunakan sebagai karakter pengganti.
Android 15 dan yang lebih lama
Tugas yang dimulai pengguna membuat kunci aktif dengan nama yang mengikuti pola ini:
*job*u/@<name_space>@/<package_name>/<classname>
Tugas lain menggunakan pola ini:
*job*/@<name_space>@/<package_name>/<classname>
Android 16 dan yang lebih baru
Tugas yang dimulai pengguna membuat kunci tetap aktif dengan nama yang mengikuti pola ini:
*job*u/@<name_space>@/#<trace_tag>#/<package_name>/<classname>
Tugas yang diprioritaskan menggunakan pola ini:
*job*e/@<name_space>@/#<trace_tag>#/<package_name>/<classname>
Tugas reguler menggunakan pola ini:
*job*r/@<name_space>@/#<trace_tag>#/<package_name>/<classname>
Contoh
Misalkan ada tugas yang dipercepat dengan namespace backup dan tag
pelacakan started. Nama paketnya adalah com.example.app, dan class yang
membuat tugas adalah com.backup.BackupFileService.
Di perangkat yang menjalankan Android 15 atau yang lebih rendah, kunci tetap aktif akan diberi nama:
*job*/@backup@/com.example.app/com.backup.BackupFileService
Pada perangkat yang menjalankan Android 16 atau yang lebih tinggi, kunci tetap aktif akan diberi nama:
*job*e/@backup@/#started#/com.example.app/com.backup.BackupFileService
Rekomendasi
Audit penggunaan tugas JobScheduler Anda. Khususnya, ikuti panduan kami untuk mengoptimalkan penggunaan baterai untuk API penjadwalan tugas.
Lokasi
LocationManager dan FusedLocationProviderClient menggunakan
kunci tetap aktif untuk mendapatkan dan mengirimkan lokasi perangkat. Wake lock
dikaitkan dengan aplikasi yang memanggil API tersebut.
Nama penguncian layar saat aktif
Layanan lokasi menggunakan nama berikut:
CollectionLib-SigCollectorNetworkLocationLocatorNetworkLocationScannerNlpCollectorWakeLockNlpWakeLock*location*
Rekomendasi
Mengoptimalkan penggunaan lokasi. Misalnya, tetapkan waktu tunggu, gabungkan permintaan lokasi, atau gunakan update lokasi pasif.
WorkManager
Pekerja WorkManager mendapatkan kunci aktivasi saat menjalankan tugas di latar belakang. Wake lock diatribusikan ke aplikasi yang membuat pekerja.
Nama penguncian layar saat aktif
Nama kunci tetap aktif yang diperoleh oleh WorkManager bergantung pada versi sistem Android yang dijalankannya.
Android 15 dan yang lebih lama
Tugas WorkManager membuat kunci aktivasi dengan nama yang mengikuti pola ini:
*job*/<package_name>/androidx.work.impl.background.systemjob.SystemJobService
Android 16 dan yang lebih baru
Tugas yang diprioritaskan membuat kunci wake dengan nama yang mengikuti pola ini:
*job*e/#<trace_tag>#/<package_name>/androidx.work.impl.background.systemjob.SystemJobService
Tugas reguler mengikuti pola ini:
*job*r/#<trace_tag>#/<package_name>/androidx.work.impl.background.systemjob.SystemJobService
Secara default, <trace_tag> adalah nama pekerja.
Contoh
Misalkan ada pekerja yang dipercepat bernama BackupFileWorker. Nama paketnya
adalah com.example.app.
Di perangkat yang menjalankan Android 15 atau yang lebih rendah, kunci tetap aktif akan diberi nama:
*job*/com.example.app/androidx.work.impl.background.systemjob.SystemJobService
Pada perangkat yang menjalankan Android 16 atau yang lebih tinggi, kunci tetap aktif akan diberi nama:
*job*e/#BackupFileWorker#/com.example.app/androidx.work.impl.background.systemjob.SystemJobService
Rekomendasi
Audit penggunaan pekerja WorkManager Anda. Khususnya, ikuti panduan kami untuk mengoptimalkan penggunaan baterai untuk API penjadwalan tugas.
_UNKNOWN
Jika alat proses debug menganggap nama penguncian layar saat aktif berisi informasi identitas pribadi (PII), alat tersebut tidak akan menampilkan nama penguncian layar saat aktif yang sebenarnya. Sebagai gantinya, mereka
melabeli kunci tetap aktif sebagai _UNKNOWN. Misalnya, alat dapat melakukan hal ini jika nama kunci
layar berisi alamat email.
Rekomendasi
Ikuti praktik terbaik penamaan penguncian layar saat aktif, dan hindari penggunaan PII dalam nama penguncian layar saat aktif. Jika Anda menemukan kunci tetap aktif bernama _UNKNOWN yang dikaitkan dengan aplikasi Anda, coba
identifikasi kunci tetap aktif tersebut, dan beri nama yang berbeda.