Deep linking
Uygulama imza sertifikası parmak izi (SHA-256) nedir?
Kısaca
Uygulama imza parmak izi, bir Android uygulamasını imzalayan sertifikanın SHA-256 özetidir; iki nokta ile ayrılmış 32 çift onaltılık karakter olarak yazılır. Android onu, bir alan adı adına tam olarak hangi sürümün hareket edebileceğini belirlemek için kullanır; assetlinks.json’da paket adının yanında listelenmesinin nedeni budur.
Neyi tanımlar
Her Android uygulaması yüklenebilmek için önce bir sertifikayla imzalanır. Parmak izi o sertifikanın kısa, sabit uzunlukta bir özetidir. Aynı anahtarla imzalanmış iki sürümün parmak izi aynıdır; başka herhangi bir anahtarla imzalanmış sürümünki farklıdır.
Android App Links için kimlik kanıtı budur. Paket adını tek başına herkes kopyalayabilir. Alan adınızdaki assetlinks.json’da paket adıyla birlikte yayınlanan parmak izi ise Android’e, linklerinizi açmasına izin verilen uygulamanın tam olarak bu imzalı uygulama olduğunu söyler. Alan bir liste alır; yani tek bir dosya birden fazla anahtarı kapsayabilir.
Play App Signing tuzağı
Play App Signing kullanıldığında iki anahtar vardır. Yüklediğiniz dosyayı bir upload key ile imzalarsınız. Google Play de insanların telefonuna ulaşan uygulamayı, kendi tuttuğu uygulama imzalama anahtarıyla imzalar. İki anahtarın parmak izi farklıdır.
App Links’in testte çalışırken yayında çalışmamasının en yaygın nedeni budur. Android’in belgeleri bunu açıkça söyler: Play App Signing kullanıyorsanız keytool’u kendi bilgisayarınızda çalıştırarak aldığınız parmak izi, kullanıcıların cihazlarındakiyle genellikle eşleşmez. Debug sürümü ise yine başka bir anahtarla imzalanır. Dosyada yalnızca kendi bilgisayarınızdaki parmak izi varsa Play sürümü hiçbir zaman doğrulanmaz ve linkler tarayıcıda açılır.
Doğru parmak izi nerede bulunur
Play sürümü için Play Console’daki uygulama imzalama sayfasını açın. Sayfa, uygulama imzalama anahtarı sertifikasını SHA-256 parmak iziyle birlikte ve, Android’in belgelerine göre, uygulama için hazır bir Digital Asset Links parçasını gösterir. Uygulama imzalama anahtarı için listelenen her parmak izini kopyalayın.
Kendi elinizdeki bir anahtar için keytool -list -v -keystore komutunu, ardından keystore dosyasını yazarak çalıştırın ve SHA256 satırını okuyun. Bir test telefonunda gerçekte neyin yüklü olduğunu görmek için adb shell pm get-app-links komutu paket adıyla birlikte, uygulamanın imzalarını her alan adının doğrulama durumunun yanında yazdırır. Dosyaya önce Play parmak izini koyun; linklerin test sürümlerinde de açılmasını istiyorsanız upload ya da debug parmak izini sonra ekleyin.
14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5Burada deneyin
Uygulamanızın dosyasını oluşturun
Team ID ve bundle ID’yi ya da paket adını ve imza parmak izini girin. Sunucunuza koyacağınız apple-app-site-association veya assetlinks.json dosyası hazır olsun.
Uygulamalar
Bu alan adındaki linkleri açması gereken her uygulamayı ekleyin. Her biri appIDs içinde bir kayıt olur.
- Uygulama 1
10 karakter; Apple Developer hesabınızda Membership details altında.
Xcode’da uygulama target’ınızdan, örneğin com.example.app.
Uygulamayı açan yollar
Kurallar yukarıdan aşağıya kontrol edilir ve ilk eşleşen kazanır; bu yüzden hariç tutma kurallarını geniş kuralların üstüne koyun. * herhangi sayıda karakterle, ? tam bir karakterle eşleşir.
- Kural 1
& ile birleştirilmiş ad=değer çiftleri
Diğer servisler
Dosyanız
apple-app-site-association
Örnek. Bilgilerinizi girdiğinizde değişir.
{
"applinks": {
"details": [
{
"appIDs": [
"ABCDE12345.com.example.app"
],
"components": [
{
"/": "/*"
}
]
}
]
}
}Tarayıcınızda oluşturulur. Hiçbir yere gönderilmez.
Nerede yayınlanmalı
Dosya nereye gidecek
- Dosyayı
.jsonuzantısı olmadanhttps://alan-adiniz/.well-known/apple-app-site-associationadresine yükleyin. - Geçerli bir sertifikayla HTTPS üzerinden, yönlendirme olmadan doğrudan 200 ile sunun.
Content-Type: application/jsonbaşlığını gönderin.- Linklerinizdeki her host’ta tekrarlayın:
example.comvewww.example.comiçin ayrı dosya ve ayrıapplinks:kaydı gerekir. - Apple CDN’i yeni dosyayı 24 saat içinde alır. Bu sürede
?mode=developerile test edin.
Dosyaları kendiniz barındırmak istemiyor musunuz? Akıllı linkler ücretsizdir; Enterprise planda Appy iki dosyayı da uygulamanızın link alan adında sunar.
Ücretsiz link oluşturunSık sorulan sorular
Uygulamamın SHA-256 parmak izini nereden bulurum?
İnsanların Google Play’den indirdiği sürüm için Play Console’daki uygulama imzalama sayfasında, uygulama imzalama anahtarı sertifikasının altında. Kendi bilgisayarınızdaki bir keystore için keytool -list -v -keystore komutunu keystore dosyasıyla çalıştırın. Play App Signing açıksa iki değer birbirinden farklıdır.
Upload key ile uygulama imzalama anahtarı arasındaki fark nedir?
Upload key sizindir. Play Console’a gönderdiğiniz bundle’ı onunla imzalarsınız. Uygulama imzalama anahtarını ise Google Play tutar ve cihazlara teslim edilen uygulamayı o imzalar. Android linkleri teslim edilen uygulamaya göre kontrol eder; bu yüzden assetlinks.json’da uygulama imzalama anahtarının parmak izi gerekir.
assetlinks.json’da birden fazla parmak izi olabilir mi?
Evet. sha256_cert_fingerprints bir dizidir ve Android’in belgelerine göre birden fazla parmak izi, uygulamanın debug ve yayın sürümleri gibi farklı sürümlerini destekleyebilir. Play uygulama imzalama anahtarını ve debug anahtarınızı listelerseniz linkler ikisinde de açılır.
İlgili terimler
- assetlinks.json
assetlinks.json, Android’in alan adınızla uygulamanız arasındaki bağı doğrulamak için okuduğu Digital Asset Links dosyasıdır. https://alanadiniz.com/.well-known/assetlinks.json adresinde yayınlanır; uygulamanın paket adını ve imza sertifikasının SHA-256 parmak izlerini içerir. Dosya yoksa ya da bilgiler tutmuyorsa Android App Links doğrulanmaz ve linkler uygulama yerine tarayıcıda açılır.
- Android App Links
Android App Links, Android’in uygulamanıza ait olduğunu doğruladığı https linkleridir; dokunuş, hangi uygulamanın kullanılacağını sormadan doğrudan uygulamayı açar. Google servisleri bulunan cihazlarda Android 6 ve sonrasında çalışır; autoVerify içeren bir intent filter ve alan adınızda bir assetlinks.json dosyası ister.
- Bundle ID
Bundle ID, bir iOS uygulamasını tanımlayan, com.example.app gibi benzersiz bir dizgidir. Android’deki karşılığı application ID’dir ve çoğunlukla paket adı diye anılır. İkisini de siz seçersiniz, ikisi de genellikle ters alan adı biçiminde yazılır ve uygulama yayınlandıktan sonra ikisi de değişmemelidir. Google Play linkleri ve assetlinks.json paket adını kullanır.
Her telefonu doğru yere gönderen bir link oluşturun
Tek link, tek QR kod: iPhone App Store’a, Android telefon kendi mağazasına, bilgisayar web sitenize gider. Ücretsiz planda 4 link ve QR kod var, reklam yok.