Mengidentifikasi dan mengoptimalkan kasus penggunaan kunci tetap aktif

Dokumen ini membantu Anda mengidentifikasi dan mengoptimalkan kasus penggunaan kunci tetap aktif di aplikasi, serta menyoroti apakah ada kunci tetap aktif yang diperoleh oleh library lain atau API sistem yang terkait dengan kasus penggunaan ini. Karena kunci aktif ini dapat diatribusikan ke aplikasi Anda, mungkin sulit untuk menentukan sumber kunci aktif yang bermasalah. Penggunaan API yang salah dapat menyebabkan aplikasi Anda ditandai karena penggunaan kunci tetap aktif yang berlebihan, meskipun Anda tidak secara eksplisit mendapatkan kunci tetap aktif.

Dokumen ini mencantumkan beberapa nama kunci tetap aktif umum yang mungkin Anda temui saat menggunakan alat proses debug kunci tetap aktif atau dalam laporan dari metrik penting. Nama ini dapat berasal dari library atau API sistem, atau mungkin di-obfuscate. Dengan menggunakan alat proses debug untuk mengidentifikasi penguncian layar saat aktif yang berperilaku tidak semestinya, lalu menelusuri nama penguncian layar saat aktif dalam dokumen ini, Anda dapat menentukan API mana yang mungkin menyebabkan masalah dan menemukan rekomendasi tentang cara mengoptimalkan penggunaannya.

Dokumen ini menguraikan kasus penggunaan umum untuk mendapatkan kunci tetap aktif, yang menjelaskan nama kunci tetap aktif yang digunakan oleh berbagai API dan library, serta memberikan rekomendasi dan praktik terbaik untuk mengoptimalkan dan mengurangi penggunaan kunci tetap aktif.

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 tetap 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:

  • Lihat memilih jenis alarm untuk memutuskan antara alarm tidak akurat atau akurat. Jika alarm Anda tidak perlu tepat, gunakan alarm tidak tepat untuk memberi sistem lebih banyak fleksibilitas dalam penjadwalan, yang dapat meningkatkan masa pakai baterai.
  • Waspadai kuota alarm yang diterapkan sistem dan desain aplikasi Anda untuk mematuhinya.
  • Hindari melakukan pekerjaan yang panjang dalam metode onReceive() dan jadwalkan pekerja jika pemrosesan tambahan diperlukan setelah alarm.

Audio dan media

Media API dapat memperoleh kunci tetap 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 menggunakan Bluetooth atau USB.
  • AudioIn: Digunakan untuk perekaman audio saat dalam mode camcorder saat 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 jika situasi lainnya 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 deklarasikan 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 dan layanan latar depan terkait jika Anda tidak lagi membutuhkannya.

Bluetooth

Bluetooth API platform terutama menahan kunci aktif kernel saat tindakan Bluetooth terjadi, yang tidak dapat diatribusikan ke aplikasi.

Rekomendasi

  • Gunakan penyambungan Perangkat Pendamping untuk menyambungkan perangkat Bluetooth guna menghindari perolehan kunci tetap aktif manual selama penyambungan Bluetooth.
  • Lihat panduan berkomunikasi di latar belakang untuk memahami cara melakukan komunikasi Bluetooth di latar belakang.
  • Penggunaan WorkManager sering kali sudah cukup jika tidak ada dampak pengguna terhadap komunikasi yang tertunda. Jika kunci tetap aktif manual dianggap perlu, tahan kunci tetap aktif hanya selama aktivitas Bluetooth atau pemrosesan data aktivitas.

Sensor Perangkat

Ada beberapa metode untuk melacak data sensor perangkat seperti jumlah langkah, data akselerometer atau giroskop.

Di Wear OS, gunakan Wear Health Services untuk mengambil data perangkat seperti ketinggian, detak jantung, dan jarak yang ditempuh.

Jika data dikumpulkan oleh aplikasi lain, Anda dapat menggunakan Health Connect yang dikombinasikan dengan WorkManager untuk mengambil data secara berkala.

Untuk skenario seperti melacak selisih langkah atau jarak yang ditempuh, Anda dapat menggunakan Recording API di perangkat seluler yang dikombinasikan dengan WorkManager untuk mengambil data secara berkala. Untuk mengakses data langkah historis (seperti total langkah harian, atau langkah dalam 6 jam terakhir), Health Connect juga mendukung pelacakan langkah di perangkat untuk perangkat yang menjalankan Android 14 atau yang lebih tinggi.

Dalam situasi tertentu, pelacakan sensor perangkat kustom mungkin diperlukan menggunakan SensorManager. SensorManager tidak mendapatkan kunci tetap aktif atas nama aplikasi, kecuali jika sensor adalah sensor aktif, yang dapat diidentifikasi menggunakan API isWakeUpSensor.

Rekomendasi

Menggunakan sensor untuk merekam pada frekuensi sampling tinggi dapat menghabiskan daya baterai secara signifikan. Berikut rekomendasi untuk mengurangi pengurasan baterai dan penggunaan kunci tetap aktif:

  • Jika melacak jumlah langkah atau jarak yang ditempuh, gunakan Recording API untuk merekam data secara efisien baterai. Untuk perangkat yang menjalankan Android 14 atau yang lebih tinggi, pertimbangkan Health Connect untuk mengakses data historis perangkat dan jumlah langkah yang digabungkan.
  • Untuk pelacakan sensor pasif di Wear OS, gunakan Wear Health Services untuk mengoptimalkan penggunaan baterai.
  • Saat mendaftarkan sensor dengan SensorManager, tentukan maxReportLatencyUs lebih dari 30 detik untuk menggunakan logika pengelompokan sensor dan mengurangi jumlah interupsi yang diterima aplikasi. Saat perangkat kemudian diaktifkan oleh pemicu lain seperti interaksi pengguna, pengambilan lokasi, atau tugas terjadwal, sistem akan segera mengirimkan data sensor yang di-cache.
  • Jika aplikasi Anda memerlukan data lokasi dan sensor, sinkronkan pengambilan dan pemrosesan peristiwanya. Dengan menggabungkan pembacaan sensor ke kunci aktif singkat yang dipegang sistem untuk pembaruan lokasi, Anda tidak perlu kunci aktif untuk menjaga CPU tetap aktif. Gunakan pekerja atau kunci aktif singkat untuk menangani upload dan pemrosesan data gabungan ini.

Firebase Cloud Message (FCM)

Wake lock diperoleh saat mengirimkan siaran Firebase Cloud Message (FCM) ke aplikasi. Wake lock dilepaskan setelah metode siaran FCM onMessageReceived() selesai dieksekusi.

Nama penguncian layar saat aktif

Saat pesan FCM diterima di perangkat, kunci tetap aktif singkat dipertahankan dengan nama GOOGLE_C2DM, di Android 16+ nama kunci tetap aktif adalah GCM_MESSAGE.

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.
  • Menyelesaikan metode onMessageReceived() secepat mungkin atau menjadwalkan pekerja untuk melanjutkan tugas jika pemrosesan tambahan diperlukan. Lihat panduan Firebase untuk mengetahui informasi selengkapnya.

JobScheduler

Tugas JobScheduler mendapatkan 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 sudut 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 tetap 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 QPR2 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 QPR2 atau yang lebih tinggi, kunci tetap aktif akan diberi nama:

*job*e/@backup@/#started#/com.example.app/com.backup.BackupFileService

Rekomendasi

  • Jangan dapatkan penguncian layar saat aktif manual untuk kasus penggunaan download/ upload yang dimulai pengguna. Sebagai gantinya, gunakan API Transfer Data yang Dimulai oleh Pengguna (UIDT). Ini adalah jalur yang ditetapkan untuk tugas transfer data yang berjalan lama yang dimulai oleh pengguna.
  • Jika Anda mengidentifikasi kunci aktif yang dibuat oleh JobScheduler dengan penggunaan kunci aktif yang tinggi, hal ini mungkin karena Anda salah mengonfigurasi tugas agar tidak selesai dalam skenario tertentu. Pertimbangkan untuk menganalisis alasan penghentian tugas, terutama jika Anda melihat banyak kemunculan STOP_REASON_TIMEOUT.
  • Lakukan audit atas 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-SigCollector
  • NetworkLocationLocator
  • NetworkLocationScanner
  • NlpCollectorWakeLock
  • NlpWakeLock
  • *location*

Rekomendasi

  • Lihat panduan kami untuk Mengoptimalkan penggunaan lokasi. Pertimbangkan untuk menerapkan waktu tunggu, memanfaatkan pengelompokan permintaan lokasi, atau menggunakan update lokasi pasif.
  • Hindari mendapatkan kunci tetap aktif berkelanjutan yang terpisah untuk menyimpan data lokasi dalam cache, karena hal ini berlebihan dan harus dihapus. Saat meminta pembaruan lokasi menggunakan FusedLocationProvider atau LocationManager API, sistem akan otomatis memicu aktivasi perangkat selama callback peristiwa lokasi. Sebagai gantinya, simpan peristiwa lokasi dalam memori atau penyimpanan, dan proses peristiwa lokasi secara berkala menggunakan WorkManager.

Pesan Jarak Jauh

Bagian ini membahas skenario yang melibatkan pesan jarak jauh saat aplikasi mungkin perlu mempertahankan koneksi atau bereaksi terhadap peristiwa dari perangkat lain, yang berpotensi memengaruhi penggunaan kunci tetap aktif. Kasus penggunaan umum meliputi:

  • Aplikasi pendamping pemantauan video atau suara yang perlu memantau peristiwa yang terjadi di perangkat eksternal yang terhubung melalui jaringan lokal.
  • Aplikasi pesan yang mempertahankan koneksi soket jaringan dengan varian desktop.

Sebagian besar proses aktif dalam skenario pesan jarak jauh ini adalah kunci aktif kernel. Karena kunci wake kernel tidak diatribusikan ke aplikasi, tidak ada nama kunci wake terkait yang tercantum di sini.

Rekomendasi

  • Jika peristiwa jaringan dapat diproses di sisi server, gunakan FCM untuk menerima informasi di klien. Anda dapat memilih untuk menjadwalkan pekerja yang dipercepat jika pemrosesan data FCM tambahan diperlukan.
  • Jika peristiwa harus diproses di sisi klien menggunakan koneksi socket, wake lock tidak diperlukan untuk memproses interupsi peristiwa. Saat paket data tiba di radio Wi-Fi atau seluler, hardware radio akan memicu interupsi dalam bentuk kunci aktif kernel. Kemudian, Anda dapat memilih untuk menjadwalkan pekerja atau mendapatkan kunci tetap aktif untuk memproses data.
  • Misalnya, jika Anda menggunakan ktor-network untuk memproses paket data pada soket jaringan, Anda hanya boleh mendapatkan kunci tetap aktif saat paket telah dikirim ke klien.

WorkManager

Pekerja WorkManager mendapatkan kunci tetap aktif 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 QPR2 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

Di perangkat yang menjalankan Android 16 QPR2 atau yang lebih tinggi dan menggunakan WorkManager 2.10.0+, wake lock akan diberi nama:

*job*e/#BackupFileWorker#/com.example.app/androidx.work.impl.background.systemjob.SystemJobService

Rekomendasi

  • Upgrade versi WorkManager Anda ke versi stabil terbaru agar tag kunci tetap aktif lebih verbose di Android 16 QPR2 atau yang lebih tinggi.
  • Lakukan audit atas penggunaan pekerja WorkManager Anda. Khususnya, pastikan aplikasi mengikuti panduan kami untuk mengoptimalkan penggunaan baterai untuk API penjadwalan tugas. Untuk membuat tag kunci tetap aktif lebih verbose di Android 16 QPR2 atau yang lebih tinggi, gunakan metode setTraceTag pada pekerja untuk menambahkan informasi debug lainnya, seperti class mana yang menjadwalkan pekerja.
  • Jika Anda mengidentifikasi kunci wake yang dibuat oleh WorkManager dengan penggunaan kunci wake yang tinggi, hal ini mungkin karena Anda salah mengonfigurasi worker sehingga tidak dapat diselesaikan dalam skenario tertentu. Pertimbangkan untuk menganalisis alasan penghentian pekerja, terutama jika Anda melihat banyak kejadian STOP_REASON_TIMEOUT.
  • Selain mencatat alasan penghentian pekerja, lihat dokumentasi kami tentang men-debug pekerja. Selain itu, pertimbangkan untuk mengumpulkan dan menganalisis rekaman aktivitas sistem untuk memahami kapan kunci tetap aktif diperoleh dan dilepaskan.

_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 penguncian layar saat 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.