Appy

Deep linking

Associated Domains nedir?

Kısaca

Associated Domains, bir uygulamanın bağlı olduğu web alan adlarını listeleyen Apple capability’si ve entitlement’ıdır. Her kayıt bir servisi bir alan adıyla eşler: applinks:example.com gibi. O alan adındaki apple-app-site-association dosyasıyla birlikte Universal Links’i, paylaşılan web kimlik bilgilerini, Handoff’u ve App Clip’leri etkinleştirir.

Şununla özetleChatGPTClaudePerplexity

Entitlement’ın içinde ne var

Entitlement, servis:alanadı biçiminde yazılmış bir dize listesidir. Apple dört servis tanımlar. applinks Universal Links içindir. webcredentials uygulamanın web sitesi için kaydedilmiş parolaları kullanmasını sağlar. activitycontinuation Handoff içindir. appclips bir App Clip’i bir alan adına bağlar.

Alan adı çıplak yazılır: https:// yok, yol yok, sondaki eğik çizgi yok; Apple’ın teknik notuna göre port numarası da yok. Her alt alan adı ayrı bir kayıttır. appclips dışındaki her serviste *. ön eki bütün alt alan adlarıyla eşleşir: applinks:*.example.com gibi.

Alan adındaki dosyayla nasıl eşleşir

Entitlement, iki taraflı bir kontrolün yarısıdır. Uygulama bir alan adını sahiplenir, alan adı da uygulamanın ID’sini apple-app-site-association (AASA) dosyasında listeleyerek bunu onaylar. Yarılardan biri eksikse servis kapalı kalır ve iOS kullanıcıya hiçbir şey bildirmez.

Uygulama yüklendiğinde sistem, listedeki her alan adı için dosyayı indirir. iOS 14’ten beri bu istek sizin sunucunuza değil, Apple’ın yönettiği bir CDN’e gider. Apple’ın belgelerine göre CDN dosyayı 24 saat içinde ister, cihazlar da yaklaşık haftada bir güncelleme olup olmadığına bakar.

Kurulum ve test

Xcode’da hedefin Signing & Capabilities sekmesini açın, Associated Domains capability’sini ekleyin ve her alan adı için bir satır girin. Bu işlem özelliği App ID için de açar. App Clip için aynı kaydın hem uygulama hedefinde hem App Clip hedefinde bulunması gerekir.

Genel internetten erişilemeyen bir sunucu için kayda ?mode=developer ekleyin. Geliştirici modundaki cihazlar o zaman dosyayı doğrudan çeker ve bunu yalnızca geliştirme profiliyle imzalanmış sürümler kullanabilir. İkinci bir mod olan managed, mobil cihaz yönetimine kayıtlı cihazlara hizmet eder. Yayınlamadan önce eki kaldırın: yayın sürümü, herkesin telefonu gibi CDN’den geçmelidir. Apple’ın teknik notu cihazda hızlı bir kontrolü de anlatır: Developer ayarlarında Associated Domains Development açıkken bir Diagnostics ekranı, verdiğiniz adresin yüklü bir uygulama için geçerli olup olmadığını söyler.

ÖrnekEntitlement kayıtları
applinks:example.com, webcredentials:example.com

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

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

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

  1. Dosyayı .json uzantısı olmadan https://alan-adiniz/.well-known/apple-app-site-association adresine yükleyin.
  2. Geçerli bir sertifikayla HTTPS üzerinden, yönlendirme olmadan doğrudan 200 ile sunun.
  3. Content-Type: application/json başlığını gönderin.
  4. Linklerinizdeki her host’ta tekrarlayın: example.com ve www.example.com için ayrı dosya ve ayrı applinks: kaydı gerekir.
  5. Apple CDN’i yeni dosyayı 24 saat içinde alır. Bu sürede ?mode=developer ile test edin.
Bir alan adını doğrulayıcıyla kontrol 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şturun
Devamını okuyuniOS ve Android için kapsamlı Universal Links rehberiAssociated Domains kaydının eksiksiz bir Universal Links ve App Links kurulumundaki yeri, adım adım.

Sık sorulan sorular

Associated Domains ile Universal Links arasındaki fark nedir?

Associated Domains mekanizmanın kendisidir. Universal Links onun üzerine kurulu özelliklerden biridir. Entitlement, paylaşılan web kimlik bilgilerini, Handoff’u ve App Clip’leri de etkinleştirebilir. Universal Links için bir applinks: kaydı ekler ve uygulamayı alan adınızdaki dosyada applinks altında listelersiniz.

Associated Domains’te joker karakter kullanabilir miyim?

Evet. Alan adının başına *. koyarak bütün alt alan adlarıyla eşleştirin, örneğin applinks:*.example.com, ve dosyayı kök alan adında barındırın. Joker, appclips servisinde kullanılamaz; kök alan adının kendisini de kapsamaz, onun için ayrı bir kayıt gerekir.

Associated Domains kaydım neden çalışmıyor?

Alışılmış üç nedene bakın. Kayıtta şema, yol ya da port vardır. Kayıttaki alan adı ile dosyayı sunan host farklıdır; örneğin biri example.com, diğeri www.example.com’dur. Ya da dosya yönlendiriliyor veya engelleniyordur; bu yüzden Apple’ın CDN’i bir kopya alamaz.

  • Universal Links

    Universal Links, Apple’ın iOS 9’dan beri sunduğu ve web sitesi yerine yüklü iOS uygulamasını doğrudan açan https linkleridir. Uygulamada applinks:example.com gibi bir Associated Domains entitlement’ı, alan adında da bir apple-app-site-association dosyası gerekir. Uygulama yoksa aynı link web sitesini açar.

  • apple-app-site-association (AASA)

    apple-app-site-association (kısaca AASA), Universal Links için alan adınızda yayınladığınız JSON dosyasıdır. https://alanadiniz.com/.well-known/apple-app-site-association adresinde durur ve hangi uygulamanın (Team ID ile bundle ID) hangi yolları açacağını listeler. iPhone, bir linkin uygulamada mı Safari’de mi açılacağına bu dosyaya bakarak karar verir; dosya yoksa ya da hatalıysa link web sitesini açar.

  • App Clip

    App Clip, bir iOS uygulamasının, uygulamanın tamamını yüklemeden kullanılabilen hafif bir sürümüdür. Bir App Clip Code, QR kod, NFC etiketi, Mesajlar’daki bir link ya da Safari’deki bir banner gibi bir çağrıyla açılır, tek bir işi görür ve ardından uygulamanın tamamını önerebilir.

Tüm terimler

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.