Memecahkan masalah App Links

Panduan ini menjelaskan masalah umum dan cara memecahkan masalah tersebut. 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, tetapi link tersebut terbuka di browser web atau menampilkan dialog disambiguasi.
  • Solusi:
    • Periksa assetlinks.json: Pastikan file ini 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 apakah 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 menggunakan 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 resolusi 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 resolusi link dengan flag 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 pencocok pola dalam aturan Anda dengan cermat untuk menemukan error sintaksis.
    • Periksa aturan filter manifes: Tinjau aturan filter intent dalam manifes aplikasi untuk memastikan jalur link tidak difilter. Jika link difilter, buat filter intent dalam 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 dibuka. Lihat Mendiagnosis resolusi link dengan flag 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 tidak dimiliki aplikasi Anda dalam elemen <intent-filter>.
Konfigurasi server yang salah

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

Selain itu, pastikan example.com. (dengan titik di akhir) menyajikan konten yang sama dengan example.com.

Pengalihan sisi server

Sistem tidak akan memverifikasi semua 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 mungkin sengaja menambahkan link yang tidak dapat diverifikasi. Perlu diingat bahwa, di Android 11 dan yang lebih rendah, 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 dalam huruf besar.
  • 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.

Mengambil laporan bug

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