Android App Links Doğrulanmıyor: adb ile Beş Dakikalık Teşhis

Uygulama yüklü. Link yine de Chrome’da açılıyor.

Genellikle bir hata olarak değil, bir destek talebi olarak ortaya çıkar. Biri alan adınıza giden bir linke dokunur, uygulamanız telefonda duruyordur ama onun yerine Chrome açılır. Android 12’den beri, Android dokümantasyonuna göre, bir https linkinin uygulamanızı açması için sistemin alan adınızı yükleme anında doğrulamış olması gerekiyor — ve bu doğrulama başarısız olduğunda sessizce başarısız oluyor. Çökme yok, bildirim yok, panellerinizde hiçbir iz yok.

İki özellik bu sorunun ayıklanmasını özellikle zorlaştırıyor. Doğrulama alan adı başına yapılır; example.com doğrulanmışken promo.example.com sessizce doğrulanmamış kalabilir. Üstelik cihaz başınadır: aynı derleme Pixel’de geçip bir Samsung telefonda kalabilir — Samsung geliştirici forumlarındaki başlıklarda tekrar tekrar bildirilen bir kombinasyon. Bunu bir vaka ortasında okuyorsanız doğrudan aşağıdaki teşhise atlayın; arka plan bilgisi sonra da burada olacak.

İki alan adı, iki karar

Yükleme anında gerçekte ne oluyor?

Uygulamanız yüklendiğinde veya güncellendiğinde Android, autoVerify ile bildirdiğiniz her alan adını okur ve her biri için https://alanadi/.well-known/assetlinks.json dosyasını indirir. Android dokümantasyonuna göre dosyanın HTTPS üzerinden, yönlendirmesiz, doğrudan 200 ve application/json içerik tipiyle dönmesi gerekir — doğrulayıcı yönlendirmeleri takip etmez. Sonuç alan adı başına önbelleğe alınır; bir alt alan adı doğrulanmışken kardeşinin doğrulanmamış kalabilmesinin nedeni budur.

Dosyanın içindeki sha256_cert_fingerprints, cihazdaki APK’yı imzalayan sertifikayla eşleşmek zorundadır. İşte bir numaralı tuzak: Play App Signing kullanıyorsanız o sertifika Google’ın uygulama imzalama anahtarıdır — sizin yükleme (upload) anahtarınız değil. Yerel keystore’unuzdan aldığınız parmak izi, elden yüklediğiniz derlemeleri kusursuz doğrular ama Play Store’dan gelen her yüklemede başarısız olur. “Benim cihazımda çalışıyor” raporlarının yarısı tam olarak buraya çıkar.

Başlamadan önce bilinmesi gereken bir özellik daha: karar önbelleğe alınır. Sunucudaki JSON’u düzeltmek, doğrulama yeniden çalışana kadar zaten başarısız olmuş telefonlarda hiçbir şey değiştirmez — neyse ki bunu zorlayabilirsiniz.

Uygulamanın yüklü olduğu herhangi bir Android 12+ cihazı bağlayın ve bunları sırayla çalıştırın. Vakaların çoğu üçüncü adımda çözülür.

Vaka ortasında JSON’a gözle bakmak istemiyorsanız, link doğrulama aracımız assetlinks.json dosyanızı indirip durum kodunu, içerik tipini ve parmak izi biçimini tek seferde kontrol eder.

Her zamanki şüpheliler

Gördüğümüz raporların neredeyse tamamını beş neden kapsıyor. Solda neden, sağda çözüm.

Android 15 ve 16 neyi değiştirdi?

İki yeni sürüm de çıtayı aynı yöne taşıdı: desteklenen yol doğrulanmış https App Links; geri kalan her şey daralmaya devam ediyor.

Akıllı linkin dürüstçe oturduğu yer

Akıllı link, bu mekanizmaların hiçbiri çalışmadan önce, sunucuda yönlendirir: biri bir Appy linkini açtığında yönlendirme cihazı okur ve Android, iOS ve masaüstü ziyaretçileri farklı hedeflere gönderir. Bu yönlendirme her planda çalışır ve cihaz üstü doğrulamaya bağlı değildir; çünkü işletim sistemi alan adınızı görmeden önce gerçekleşir.

Neyi yapmadığı konusunda net olalım: akıllı link App Links doğrulamasını atlayamaz. Yönlendirme sizin https alan adınızda biter ve uygulamanın mı tarayıcının mı açılacağına yine aynı verified-veya-none durumu karar verir. Vaka ortasında size kazandırdığı şey kontrol edilebilir bir ön kapıdır — assetlinks.json’u onarırken Android trafiğini Play Store sayfasına veya web’e yönlendirin, sonra hedefi geri çevirin; basılmış hiçbir şeye dokunmanız gerekmez, çünkü dinamik QR kodlar baskıdan sonra da düzenlenebilir kalır. Analitik de bu sırada bozuk yola ne kadar Android trafiği geldiğini gösterir.

Her durumda doğrulamayı düzeltin. Pro’daki deeplink hedefleri ve Enterprise’daki, yükleme sonrası açılışı taşıyan ertelenmiş deeplink özelliği elde olması iyi şeyler — ama çalışan bir assetlinks.json’un üstünde otururlar, onun yerine geçmezler.

Sık sorulan sorular