Memecahkan masalah App Links

Panduan ini menjelaskan masalah umum dan cara memecahkannya. Anda juga dapat menggunakan alat pemecahan masalah di halaman Deep Link Konsol Play atau Asisten Link Aplikasi Android Studio. Untuk mengetahui informasi selengkapnya, lihat Alat developer Link Aplikasi.

  • Masalah: Anda mengklik link yang seharusnya membuka aplikasi Anda, tetapi link tersebut terbuka di browser web atau menampilkan dialog disambiguasi.
  • Solusi:
    • Periksa assetlinks.json: Pastikan file adalah JSON yang valid, dapat diakses di https://<your-domain>/.well-known/assetlinks.json, dan ditayangkan melalui HTTPS tanpa pengalihan. Gunakan validator online.
    • Verifikasi Sidik Jari SHA-256: Periksa kembali bahwa sha256_cert_fingerprints di assetlinks.json sama persis dengan sidik jari kunci penandatanganan untuk rilis aplikasi Anda (gunakan yang dari Konsol Play jika Anda menggunakan Penandatanganan Aplikasi Play). Tanda tangan harus huruf besar.
    • Verifikasi autoVerify: Pastikan <intent-filter> di AndroidManifest.xml Anda menyertakan android:autoVerify="true".
    • Periksa pengalihan sisi server: Pengalihan dari http ke https atau dari domain non-www ke www dapat menyebabkan verifikasi gagal.
    • Paksa Verifikasi Ulang: Jalankan perintah ADB di panduan Menguji Link Aplikasi untuk mendapatkan hasil verifikasi baru.
    • Mendiagnosis penyelesaian link (Android 17+): Jalankan adb shell am start --debug-link -a android.intent.action.VIEW -d "<URL>" untuk memeriksa aplikasi kandidat, filter intent manifes, dan aturan Link Aplikasi Dinamis yang cocok dengan URL. Untuk mengetahui detailnya, lihat Mendiagnosis penyelesaian link dengan tanda debug-link.

Aturan dinamis di Android 15 ke atas tidak diperbarui

  • Masalah: Anda telah memperbarui aturan dalam file assetlinks.json, tetapi link baru tidak ditangani oleh aplikasi.
  • Solusi:
    • Paksa verifikasi ulang: Cara paling andal untuk menguji perubahan adalah dengan memaksa pengambilan ulang menggunakan adb shell pm verify-app-links --re-verify <your-package-name>.
    • Periksa kesalahan ketik: Tinjau pencocokan pola dengan cermat dalam aturan Anda untuk menemukan error sintaksis.
    • Periksa aturan filter manifes: Tinjau aturan filter intent di manifes aplikasi untuk memastikan jalur link tidak difilter. Jika link difilter, buat filter intent di manifes aplikasi menjadi kurang ketat.
    • Mendiagnosis aturan pencocokan (Android 17+): Jalankan adb shell am start --debug-link -a android.intent.action.VIEW -d "<URL>" untuk memeriksa aturan mana yang dievaluasi dan menentukan apakah aturan pengecualian (allow = 1) mencegah aplikasi terbuka. Lihat Mendiagnosis resolusi link dengan tanda debug-link.

Memperbaiki error penerapan umum

Jika Anda tidak dapat memverifikasi Link Aplikasi Android, periksa error umum berikut. Bagian ini menggunakan example.com sebagai nama domain placeholder; saat melakukan pemeriksaan ini, ganti example.com dengan nama domain server Anda yang sebenarnya.

Penyiapan filter intent yang salah
Periksa apakah Anda menyertakan URL yang bukan milik aplikasi Anda dalam elemen <intent-filter>.
Konfigurasi server yang salah

Periksa konfigurasi JSON server Anda, dan pastikan nilai SHA sudah benar.

Selain itu, periksa apakah example.com. (dengan titik di akhir) menayangkan konten yang sama dengan example.com.

Pengalihan sisi server

Sistem tidak memverifikasi link aplikasi Android untuk aplikasi Anda jika Anda menyiapkan pengalihan seperti berikut:

  • http://example.com ke https://example.com
  • example.com ke www.example.com

Perilaku ini melindungi keamanan aplikasi Anda.

Ketahanan server

Periksa apakah aplikasi klien Anda dapat terhubung ke server Anda.

Link yang tidak dapat diverifikasi

Untuk tujuan pengujian, Anda dapat menambahkan link yang tidak dapat diverifikasi secara sengaja. Perlu diingat bahwa, di Android 11 dan yang lebih lama, link ini menyebabkan sistem tidak memverifikasi semua Link Aplikasi Android untuk aplikasi Anda.

Tanda tangan salah di assetlinks.json

Pastikan tanda tangan Anda sudah benar dan cocok dengan tanda tangan yang digunakan untuk menandatangani aplikasi Anda. Kesalahan umum meliputi:

  • Menandatangani aplikasi dengan sertifikat debug dan hanya memiliki tanda tangan rilis di assetlinks.json.
  • Memiliki tanda tangan huruf kecil di assetlinks.json. Tanda tangan harus berupa huruf kapital.
  • Jika Anda menggunakan Penandatanganan Aplikasi Play, pastikan Anda menggunakan tanda tangan yang digunakan Google untuk menandatangani setiap rilis Anda. Anda dapat memverifikasi detail ini, termasuk cuplikan JSON lengkap, dengan mengikuti petunjuk tentang mendeklarasikan pengaitan situs.

Merekam laporan bug

Untuk masalah kompleks yang sulit direproduksi, ambil laporan bug dan analisis. Log ini dapat memberikan insight berharga tentang proses verifikasi dan error tingkat sistem.