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, tetapi link tersebut terbuka di browser web atau menampilkan dialog disambiguasi.
  • Solusi:
    • Periksa assetlinks.json: Pastikan file tersebut 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 berasal 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 Menguji Link Aplikasi panduan 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 salah 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 tidak terlalu ketat.

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 sebenarnya dari server Anda.

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 tanda titik di akhir) menayangkan konten yang sama dengan example.com.

Pengalihan sisi server

Sistem tidak akan 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 mungkin sengaja menambahkan link yang tidak dapat diverifikasi. 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 yang 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 menggunakan 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 hubungan situs.

Mengambil foto laporan bug

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