Perubahan izin kontak Android: panduan migrasi MANAGE_CONTACTS

Akses kontak di Android sedang berubah. Perubahan ini memengaruhi pengembangan aplikasi, pemeriksaan kebijakan Google Play, dan pilihan privasi yang dilihat pengguna. Pada 21 Oktober 2026, Google mengumumkan bahwa aplikasi yang menargetkan versi Android berikutnya tidak lagi dapat menggunakan WRITE_CONTACTS untuk menulis kontak secara langsung secara default. Sebagian besar aplikasi sebaiknya berpindah ke intent kontak standar atau antarmuka sistem dengan cakupan yang lebih sempit.

Ini bukan larangan terhadap semua fitur kontak dan bukan berarti aplikasi lama langsung berhenti bekerja. Perubahan utamanya adalah berpindah dari akses luas yang dapat mengubah buku alamat di latar belakang menuju tindakan yang dimulai dan dikonfirmasi pengguna: menambahkan kontak, mengedit kontak, membiarkan pengguna memilih seseorang, atau menerbitkan kemampuan panggilan dan pesan aplikasi melalui direktori sistem. Migrasi lebih awal dapat mengurangi permintaan izin dan mencegah pekerjaan mendadak saat aplikasi mulai menargetkan Android baru.

Ringkasan: sebagian besar aplikasi tidak perlu menulis kontak langsung

Jika pengguna meminta aplikasi menyimpan kartu nama, menambahkan nomor telepon, atau mengedit satu kontak, gunakan ACTION_INSERT, ACTION_EDIT, atau ACTION_INSERT_OR_EDIT. Alur ini membuka editor sistem dan tidak memerlukan izin penulisan kontak yang luas pada perangkat yang menjalankan Android berikutnya.

Gunakan Contact Picker jika pengguna hanya perlu memilih seseorang. Gunakan People Directory jika aplikasi panggilan atau pesan ingin menawarkan tindakan seperti “Telepon dengan…” atau “Kirim pesan dengan…” tanpa menambahkan baris buatan ke buku alamat. Simpan MANAGE_CONTACTS untuk aplikasi yang fungsi utamanya benar-benar membutuhkan pengelolaan kontak secara luas, seperti pengelola kontak khusus, pengganti dialer, atau alat pencadangan. Baca pengumuman resmi Android Developers dan referensi intent umum.

Mengapa Google mengganti penulisan kontak yang luas

Model lama memperlakukan permintaan satu kali dari pengguna dan pemeliharaan seluruh buku alamat hampir sebagai masalah izin yang sama. Aplikasi yang hanya menyimpan satu kontak dapat meminta WRITE_CONTACTS, tetapi izin itu juga dapat memungkinkan perubahan besar di latar belakang. Pengguna sulit membedakan kebutuhan kecil dari akses yang sangat kuat berdasarkan dialog izin saja.

Desain baru berpusat pada tindakan pengguna saat itu. Ketika aplikasi membuka editor kontak sistem, pengguna dapat melihat bidang yang akan disimpan, akun tujuan, dan konfirmasi akhir. Sistem menjaga batas interaksi tersebut tanpa memberikan kemampuan menulis tanpa batas kepada aplikasi. Ini mengikuti prinsip privasi Android: gunakan kemampuan minimum yang diperlukan dan biarkan pengguna mengendalikan langkah terakhir.

Google juga memperbaiki perbedaan perilaku antarperangkat. Sebelumnya beberapa editor menghilangkan foto, menyembunyikan pilihan membuat kontak baru, atau menangani tombol kembali secara berbeda. Android berikutnya akan menstandarkan perilaku tambah dan edit agar lebih mudah diuji.

Jalur migrasi untuk pengembang

Simpan atau edit satu kontak dengan intent

Pemindai kartu nama, aplikasi chat, aplikasi pesanan, dan alat acara biasanya tidak memerlukan akses luas. Gunakan ACTION_INSERT untuk membuat kontak, ACTION_INSERT_OR_EDIT saat nomor atau email mungkin ditambahkan ke kontak yang ada, dan ACTION_EDIT jika URI kontak sudah diketahui.

Uji seluruh alur: pemilihan akun, foto, nomor telepon, email, pembatalan, rotasi layar, dan hasil setelah penyimpanan. Tipe MIME khusus di luar ContactsContract.CommonDataKinds dapat diabaikan oleh editor. Siapkan fallback yang jelas untuk bidang yang tidak dapat dipindahkan.

Gunakan Contact Picker untuk pilihan pengguna

Jika aplikasi hanya membutuhkan satu orang yang dipilih pengguna, membaca seluruh buku alamat adalah berlebihan. Contact Picker, tersedia sejak Android 17, memungkinkan pengguna memilih kontak tanpa izin luas. Undangan, pembayaran, berbagi perjalanan, dan layanan tumpangan biasanya membutuhkan orang yang dipilih, bukan seluruh basis data.

Ini juga meningkatkan pengalaman. Picker menjelaskan alasan informasi kontak diperlukan tepat ketika pengguna memilih seseorang, bukan meminta izin luas sebelum fitur dipahami.

Gunakan People Directory untuk kemampuan dalam aplikasi

Aplikasi panggilan dan pesan kadang menulis baris tambahan ke kontak agar pengguna melihat “Telepon dengan…” atau “Kirim pesan dengan…”. Google memperkenalkan People Directory pada Android QPR2 yang direncanakan untuk kuartal keempat 2026. Aplikasi dapat menerbitkan cara orang saling dihubungi di dalam aplikasi tanpa mengubah buku alamat pribadi.

Pembagiannya menjadi lebih jelas: aplikasi kontak menyimpan buku alamat pribadi, sedangkan direktori menjelaskan kemampuan aplikasi. Pantau ketersediaan QPR2 dan uji integrasi pada perangkat yang didukung sebelum menghapus fallback lama.

Kapan MANAGE_CONTACTS layak digunakan

MANAGE_CONTACTS adalah akses aplikasi khusus, bukan dialog izin runtime biasa. Pengguna mengaktifkannya di Setelan > Akses aplikasi khusus > Kelola kontak. Untuk aplikasi yang memenuhi syarat, akses ini mencakup pembacaan sehingga READ_CONTACTS belum tentu perlu diminta juga.

Akses ini dapat diperlukan oleh pengelola kontak khusus, pengganti dialer, aplikasi identifikasi penelepon atau anti-spam yang memperbarui banyak entri, sinkronisasi perusahaan, pencadangan dan pemulihan massal, serta transfer antarperangkat. Keinginan mempertahankan layar edit bermerek saja tidak cukup.

Daftar periksa migrasi

1. Cari WRITE_CONTACTS, penulisan langsung melalui ContentResolver, baris kontak khusus, dan deklarasi Play.
2. Kelompokkan fitur sebagai tambah, edit, pilihan pengguna, kemampuan dalam aplikasi, atau pengelolaan luas.
3. Ganti tindakan satu kontak dengan intent standar.
4. Gunakan Contact Picker jika fitur hanya membutuhkan pilihan.
5. Evaluasi People Directory untuk panggilan dan pesan dalam aplikasi.
6. Pertahankan MANAGE_CONTACTS hanya jika fungsi utama memerlukan pengelolaan luas dan catat alasannya.
7. Uji Android baru dan versi lama, termasuk pembatalan dan data yang tidak lengkap.
8. Samakan Manifest, deklarasi Play, kebijakan privasi, dan penjelasan di aplikasi.

Pengguna juga dapat memilih aplikasi yang menjelaskan alasan izin dan menyediakan alur yang dimulai oleh pengguna. Untuk membandingkan alat Android, sumber resmi, izin, dan informasi privasi, lihat direktori perangkat lunak Android BTTC.

Pertanyaan umum

Apakah ini langsung berlaku untuk semua aplikasi Android?

Tidak. Pembatasan penulisan langsung berlaku untuk aplikasi yang menargetkan Android berikutnya. Aplikasi dengan target lama mempertahankan perilaku saat ini.

Apakah aplikasi bisa menghapus kontak dengan intent?

Tidak. Tidak ada intent standar untuk menghapus kontak. Biasanya pengguna menghapusnya di aplikasi kontak; aplikasi dengan MANAGE_CONTACTS yang sah dapat menghapus secara langsung.

Apakah MANAGE_CONTACTS menggantikan READ_CONTACTS?

Akses ini mencakup pembacaan untuk aplikasi yang memenuhi syarat, tetapi aplikasi yang hanya membaca dan tidak mengubah kontak masih dapat membenarkan READ_CONTACTS.

Apakah aplikasi boleh mempertahankan editor kontak sendiri?

Hanya jika produk benar-benar membutuhkan pengelolaan kontak luas. Mempertahankan antarmuka sendiri bukan alasan yang cukup.

Kesimpulan

Android menjadikan akses kontak lebih jelas dan dimediasi pengguna. Untuk sebagian besar aplikasi, gunakan intent standar untuk menyimpan dan mengedit, Contact Picker untuk memilih, dan People Directory untuk panggilan serta pesan dalam aplikasi. Simpan MANAGE_CONTACTS hanya untuk produk yang benar-benar mengelola buku alamat dalam skala luas, lalu uji perubahan target SDK sebelum rilis.