Batasan dalam memulai aktivitas dari latar belakang

Android 10 (API level 29) dan yang lebih tinggi menetapkan pembatasan tentang kapan aplikasi dapat memulai aktivitas saat aplikasi berjalan di latar belakang. Pembatasan ini membantu meminimalkan gangguan bagi pengguna dan membuat pengguna lebih mengontrol apa yang ditampilkan di layar mereka.

Panduan ini menyajikan notifikasi sebagai alternatif untuk memulai aktivitas dari latar belakang. Bagian ini juga mencantumkan kasus spesifik saat pembatasan tidak berlaku.

Tampilkan notifikasi

Dalam hampir semua kasus, aplikasi di latar belakang harus menampilkan notifikasi mendesak untuk memberikan informasi mendesak kepada pengguna, bukan langsung memulai aktivitas. Notifikasi tersebut mencakup penanganan panggilan telepon masuk atau jam alarm aktif.

Sistem pemberitahuan dan pengingat berbasis notifikasi ini memberikan beberapa keuntungan bagi pengguna:

  • Saat menggunakan perangkat, pengguna akan melihat notifikasi peringatan dini yang memungkinkan mereka merespons. Pengguna mempertahankan konteks saat ini dan memiliki kontrol atas konten yang dilihat di layar.
  • Notifikasi mendesak mengikuti aturan Jangan Ganggu pengguna. Misalnya, pengguna mungkin hanya mengizinkan panggilan dari kontak tertentu atau dari pemanggil berulang saat mode Jangan Ganggu diaktifkan.
  • Saat layar perangkat nonaktif, intent layar penuh akan segera diluncurkan.
  • Di layar Settings perangkat, pengguna dapat melihat aplikasi mana yang baru-baru ini mengirim notifikasi, termasuk dari saluran notifikasi tertentu. Dari layar ini, pengguna dapat mengontrol preferensi notifikasi mereka.

Kapan aplikasi dapat memulai aktivitas

Aplikasi yang berjalan di Android 10 atau yang lebih tinggi dapat memulai aktivitas saat satu atau beberapa kondisi berikut terpenuhi:

  • Aplikasi ini memiliki jendela yang terlihat, seperti aktivitas di latar depan.
  • Aplikasi memiliki aktivitas di data sebelumnya tugas latar depan.

  • Aplikasi memiliki aktivitas di data sebelumnya dari tugas yang ada di layar Terbaru.

  • Aplikasi memiliki aktivitas yang dimulai baru-baru ini.

  • Aplikasi memanggil finish() pada suatu aktivitas baru-baru ini. Ini hanya berlaku jika aplikasi memiliki aktivitas di latar depan atau aktivitas di data sebelumnya tugas latar depan pada saat finish() dipanggil.

  • Aplikasi memiliki salah satu layanan berikut yang terikat oleh sistem. Layanan ini mungkin perlu meluncurkan UI.

  • Aplikasi memiliki layanan yang terikat dengan aplikasi lain yang terlihat. Aplikasi yang terikat dengan layanan harus tetap terlihat oleh aplikasi di latar belakang agar aplikasi berhasil memulai aktivitas.

  • Aplikasi akan menerima notifikasi PendingIntent dari sistem. Dalam hal intent yang tertunda untuk layanan dan penerima siaran, aplikasi dapat memulai aktivitas selama beberapa detik setelah intent yang tertunda dikirim.

  • Aplikasi menerima PendingIntent yang dikirim dari aplikasi lain yang terlihat.

  • Aplikasi menerima siaran sistem tempat aplikasi diharapkan meluncurkan UI. Contohnya mencakup ACTION_NEW_OUTGOING_CALL dan SECRET_CODE_ACTION. Aplikasi ini dapat memulai aktivitas selama beberapa detik setelah siaran dikirim.

  • Aplikasi dikaitkan dengan perangkat hardware pendamping melalui CompanionDeviceManager API. API ini memungkinkan aplikasi memulai aktivitas sebagai respons terhadap tindakan yang dilakukan pengguna pada perangkat yang disambungkan.

  • Aplikasi adalah pengontrol kebijakan perangkat yang berjalan dalam mode pemilik perangkat. Contoh kasus penggunaan mencakup perangkat perusahaan terkelola sepenuhnya serta perangkat khusus seperti reklame digital dan kios.

  • Aplikasi diberi izin SYSTEM_ALERT_WINDOW oleh pengguna.

Penyertaan diperlukan saat memulai aktivitas dari PendingIntent

Agar Aktivitas tidak disengaja dimulai berdasarkan konisi yang tercantum, mulai dari Android 14, ada API eksplisit yang memungkinkan Anda memilih untuk ikut serta atau tidak dalam memberikan izin aplikasi untuk memulai Aktivitas.

Lihat:

  • ActivityOptions.setPendingIntentBackgroundActivityStartMode
  • ActivityOptions.setPendingIntentCreatorBackgroundActivityStartMode

Oleh Pengirim PendingIntent

Aplikasi yang menargetkan Android 14 atau yang lebih tinggi dan ingin memulai PendingIntent harus

  • memenuhi konisi yang tercantum dan
  • memilih untuk mengizinkan peluncuran aktivitas latar belakang berdasarkan pengecualian tersebut

Keikutsertaan ini hanya akan terjadi jika developer aplikasi mengetahui bahwa aplikasi akan memulai Aktivitas.

Untuk ikut serta, aplikasi harus meneruskan paket ActivityOptions dengan setPendingIntentBackgroundActivityStartMode (ActivityOptions.MODE_BACKGROUND_ACTIVITY_START_ALLOWED) ke PendingIntent.send(...) atau metode serupa.

Oleh Pembuat PendingIntent

Aplikasi yang menargetkan Android 15 atau yang lebih tinggi yang membuat PendingIntent harus

  • memenuhi konisi yang tercantum dan
  • memilih untuk mengizinkan peluncuran aktivitas latar belakang berdasarkan pengecualian tersebut

Pada umumnya, aplikasi yang memulai PendingIntent harus menjadi aplikasi yang diikutsertakan.

Saat aplikasi yang membuat PendingIntent memilih ikut serta, hal berikut akan terjadi:

  • PendingIntent dapat dimulai kapan saja saat aplikasi pembuatan terlihat
  • PendingIntent dapat dimulai kapan saja jika aplikasi pembuatan memiliki hak istimewa khusus

Oleh karena itu, sebaiknya jangan teruskan PendingIntent tersebut ke aplikasi yang tidak tepercaya dan batalkan PendingIntent jika tidak boleh digunakan lagi.

Untuk ikut serta, aplikasi harus meneruskan paket ActivityOptions dengan setPendingIntentCreatorBackgroundActivityStartMode (ActivityOptions.MODE_BACKGROUND_ACTIVITY_START_ALLOWED) ke PendingIntent.getActivity(...) atau metode serupa.