Uygulama bağlantılarıyla ilgili sorunları giderme

Bu kılavuzda, sık karşılaşılan sorunlar ve bunların nasıl giderileceği açıklanmaktadır. Ayrıca Play Console Derin Bağlantılar sayfasındaki veya Android Studio Uygulama Bağlantıları Asistanı'ndaki sorun giderme araçlarını da kullanabilirsiniz. Daha fazla bilgi için Uygulama Bağlantıları geliştirici araçları başlıklı makaleyi inceleyin.

  • Sorun: Uygulamanızı açması gereken bir bağlantıyı tıkladığınızda bağlantı bir web tarayıcısında açılıyor veya açıklama amaçlı iletişim kutusu gösteriliyor.
  • Çözüm:
    • assetlinks.json dosyasını kontrol edin: Dosyanın geçerli bir JSON dosyası olduğundan, https://<your-domain>/.well-known/assetlinks.json adresinde erişilebilir olduğundan ve yönlendirme olmadan HTTPS üzerinden sunulduğundan emin olun. Online doğrulayıcı kullanın.
    • SHA-256 parmak izini doğrulayın: assetlinks.json dosyasındaki sha256_cert_fingerprints'ın, uygulama sürümünüzün imzalama anahtarının parmak iziyle tam olarak eşleştiğini doğrulayın (Play Uygulama İmzalama kullanıyorsanız Play Console'daki parmak izini kullanın). İmza büyük harflerle yazılmalıdır.
    • Doğrulama autoVerify: AndroidManifest.xml dosyanızdaki <intent-filter> öğesinin android:autoVerify="true öğesini içerdiğinden emin olun.
    • Sunucu tarafı yönlendirmelerini kontrol edin: http alanından https alanına veya www olmayan bir alan adından www alanına yapılan yönlendirmeler, doğrulamanın başarısız olmasına neden olabilir.
    • Yeniden doğrulamayı zorunlu kılın: Yeni bir doğrulama sonucu almak için Uygulama Bağlantılarını Test Etme rehberindeki ADB komutlarını çalıştırın.

Android 15 ve sonraki sürümlerde dinamik kurallar güncellenmiyor

  • Sorun: assetlinks.json dosyanızdaki kuralları güncellediniz ancak yeni bağlantılar uygulama tarafından işlenmiyor.
  • Çözüm:
    • Yeniden doğrulamayı zorunlu kılın: Değişiklikleri test etmenin en güvenilir yolu, adb shell pm verify-app-links --re-verify. <your-package-name> ile yeniden getirmeyi zorunlu kılmaktır.
    • Yazım hatalarını kontrol edin: Kurallarınızdaki kalıp eşleştiricilerde söz dizimi hataları olup olmadığını dikkatlice inceleyin.
    • Manifest filtre kurallarını kontrol edin: Bağlantı yolunun filtrelenmediğinden emin olmak için uygulama manifestindeki amaç filtresi kurallarını inceleyin. Bağlantı filtreleniyorsa uygulama manifestindeki intent filtresini daha az kısıtlayıcı hale getirin.

Sık karşılaşılan uygulama hatalarını düzeltme

Android Uygulama Bağlantılarınızı doğrulayamıyorsanız aşağıdaki yaygın hataları kontrol edin. Bu bölümde yer tutucu alan adı olarak example.com kullanılır. Bu kontrolleri yaparken example.com yerine sunucunuzun gerçek alan adını kullanın.

Yanlış intent filtresi ayarı
Uygulamanızın sahibi olmadığı bir URL'yi <intent-filter> öğesine ekleyip eklemediğinizi kontrol edin.
Yanlış sunucu yapılandırması

Sunucunuzun JSON yapılandırmasını kontrol edin ve SHA değerinin doğru olduğundan emin olun.

Ayrıca, example.com. (sondaki nokta ile) öğesinin example.com ile aynı içeriği sunduğunu kontrol edin.

Sunucu tarafı yönlendirmeler

Aşağıdakiler gibi bir yönlendirme ayarlarsanız sistem, uygulamanız için hiçbir Android Uygulama Bağlantısı'nı doğrulamaz:

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

Bu davranış, uygulamanızın güvenliğini korur.

Sunucu sağlamlığı

İstemci uygulamalarınızın sunucunuza bağlanıp bağlanamadığını kontrol edin.

Doğrulanamayan bağlantılar

Test amacıyla, doğrulanabilir olmayan bağlantıları bilerek ekleyebilirsiniz. Android 11 ve önceki sürümlerde bu bağlantıların, sistemin uygulamanız için tüm Android Uygulama Bağlantıları'nı doğrulamasını engellediğini unutmayın.

assetlinks.json dosyasında yanlış imza var

İmzanızın doğru olduğunu ve uygulamanızı imzalamak için kullanılan imzayla eşleştiğini doğrulayın. Sık yapılan hatalar şunlardır:

  • Uygulamayı hata ayıklama sertifikasıyla imzalama ve yalnızca assetlinks.json'da yayın imzasına sahip olma.
  • assetlinks.json içinde küçük harfli bir imza kullanıyorsanız. İmza büyük harflerle yazılmalıdır.
  • Play Uygulama İmzalama özelliğini kullanıyorsanız Google'ın her sürümünüzü imzalamak için kullandığı imzayı kullandığınızdan emin olun. Web sitesi ilişkilendirmelerini bildirme ile ilgili talimatları uygulayarak tam bir JSON snippet'i de dahil olmak üzere bu ayrıntıları doğrulayabilirsiniz.