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 berupa 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.

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 dalam aturan Anda dengan cermat untuk menemukan kesalahan sintaksis.
    • Periksa aturan filter manifes: tinjau aturan filter intent di manifes aplikasi untuk memastikan jalur link tidak difilter. Jika link difilter, buat filter intent dalam manifes aplikasi menjadi tidak terlalu membatasi.

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) menyajikan 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 hingga https://example.com
  • example.com hingga 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 dalam assetlinks.json

Pastikan tanda tangan Anda 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 asosiasi situs.