Dynamic Links'ten Uygulama Bağlantıları'na ve Geçiş Bağlantıları'na geçiş

Bu taşıma kılavuzunda, Uygulama Bağlantıları ve Evrensel Bağlantılar'ın yanı sıra isteğe bağlı olarak uygulama-site ilişkilendirme dosyalarınızı barındırmak için Firebase Hosting'in kullanılması ele alınmaktadır.

Bu taşıma işlemi, aşağıdaki Firebase Dynamic Links özelliklerinin yerini alır:

Taşıma işleminiz için bu kılavuzda desteklenmeyen diğer Firebase Dynamic Link özelliklerine ihtiyaç duymaya devam ederseniz Dinamik Bağlantıların Kullanımdan Kaldırılmasıyla İlgili SSS belgelerindeki diğer taşıma senaryolarını inceleyin.

Aşağıdaki gibi bir Firebase Dynamic Links'iniz olduğunu varsayalım:

Bu taşıma kılavuzunun amacı, Firebase Dynamic Links'i aşağıdaki gibi değiştirmektir:

https://example.page.link/m9Mm

Aşağıdaki gibi görünen Uygulama Bağlantısı / Evrensel Bağlantı derin bağlantılarıyla:

https://your-project-domain.web.app/welcome

Uygulama Bağlantısı / Geçiş Bağlantısı derin bağlantısının kullanıcılarınıza aşağıdakileri sağlayacağını unutmayın:

• Uygulamanız yüklü olduğunda kullanıcıların tıklayabileceği ve uygulamanızı açacak bir derin bağlantı
• Uygulama açıldığında kullanıcıları uygulamanızın belirli bir bölümüne yönlendiren kullanıcı yolculuğunun devamı

Ancak Uygulama Bağlantısı / Geçiş Bağlantısı derin bağlantısı, kullanıcılarınıza aşağıdaki davranışları sağlamaz (Firebase Dynamic Links daha önce sağlıyordu):

• Kullanıcıları, uygulamanızı indirip yüklemeleri için cihazlarına uygun mağazaya yönlendirme
• Uygulamayı indirip yükledikten ve ilk kez açtıktan sonra kullanıcı yolculuğunun devamını sağlamak

Bu Uygulama Bağlantıları / Evrensel Bağlantılar'ın davranış ve işlevselliğinde, yukarıdaki tabloda belirtilen Firebase Dynamic Links'e kıyasla farklılıklar olduğunu unutmayın.

Başlamadan önce

Firebase Dynamic Links, uygulamanız yüklendikten sonra derin bağlantı işlevi sağlamak için kendi temel uygulamasında Uygulama Bağlantıları'nı (Android'de) ve Evrensel Bağlantıları'nı (iOS'te) kullanır.

Bu kılavuzda, Firebase Dynamic Links'in sağladığı işlevin ilgili bölümünü değiştirirken Firebase Dynamic Links'i yeni Uygulama Bağlantıları / Geçiş Bağlantıları taşıma çözümüne taşırken Firebase Hosting'i kullanarak kendi Uygulama Bağlantılarınızı ve Geçiş Bağlantılarınızı nasıl oluşturacağınız açıklanmaktadır.

Taşıma işlemini tamamlamak için aşağıdaki bilgilere ihtiyacınız vardır:

• Taşımak istediğiniz Firebase Dynamic Links'ler
• Dinamik bağlantılarınıza dahil edilen derin bağlantı URL parametreleri
• Önceki Firebase Dynamic Links alanınızı değiştirmek için kullanmayı planladığınız alan (varsa)

Mevcut bağlantı meta verilerinizi dışa aktarmak ve yukarıda listelenen bilgileri edinmek için Dinamik Bağlantı Meta Verilerini Dışa Aktarma kılavuzunu kullanabilirsiniz.

Taşıma adımlarına genel bakış

1. Firebase Hosting'i kullanarak uygulama bağlantısı / evrensel bağlantı yapılandırma dosyalarınızı barındırmak için yeni bir alan adı hazırlayın (kullanmak istediğiniz bir alan adınız yoksa).

2. Uygulama Bağlantısı / Geçiş Bağlantısı yapılandırma dosyalarınızı oluşturun ve barındırma alanınızda barındırın.

3. Firebase Dynamic Links'inizde kullanılan derin bağlantı şemasıyla eşleşen yeni Uygulama Bağlantıları / Geçiş Bağlantıları oluşturun.

4. Android / iOS uygulamalarınızı ve uygulama kodunuzu derin bağlantılar alacak şekilde güncelleyin.

5. Uygulama Bağlantıları / Evrensel Bağlantılar entegrasyonlarınızı test edin.

6. Yayınlanan veya paylaşılan Firebase Dynamic Links'lerinizi App Links ve Universal Links ile değiştirin.

İlk adım, hem uygulama bağlantıları hem de evrensel bağlantı taşıma akışlarında ortaktır. Kalan işlemler platforma göre değişir. Bu nedenle, önce hangi platformu taşımak istediğinize bağlı olarak aşağıdaki kılavuzun ilgili bölümüne gidin.

• Android App Links için taşıma adımları
• iOS'te Geçiş Bağlantıları için Taşıma Adımları

Firebase Hosting'i kullanarak uygulama bağlantısı / evrensel bağlantı yapılandırma dosyalarınızı barındıracak yeni bir alan hazırlayın

Alan adı seçme

İlk adım, uygulama bağlantılarınız/evrensel bağlantılarınız için kullanmak istediğiniz bir alan seçmektir. Bu, kullanıcılarınızla paylaşacağınız yeni bağlantılar için kullanılacak alan adı olacaktır.

Firebase Hosting kullanıyorsanız your-project-domain.web.app veya your-project-domain.firebaseapp.com biçimindeki proje alt alan adları otomatik olarak ücretsiz olarak sağlanır. İsterseniz Uygulama Bağlantısı / Geçiş Bağlantı yapılandırma dosyalarınızı da barındırmak için Firebase Hosting ile veya Firebase Hosting olmadan özel bir alan kullanabilirsiniz.

Firebase Hosting'i ayarlayın

Ardından, Firebase Barındırma örneğinizi oluşturup yapılandırmanız gerekir.

Firebase Hosting örneğinizi oluşturmayı tamamladığınızda your-project-domain.web.app` gibi bir alanınız olur. Dilerseniz özel alan da seçebilirsiniz.

Android App Links için taşıma adımları

Uygulama Bağlantısı yapılandırma dosyalarınızı yeni barındırma alanınızda oluşturun ve barındırın

Uygulama Bağlantıları'nı kullanmak için bağlantılarınızda kullanılan alan ile uygulamanız arasında güvenli bir ilişki kurulmasına yardımcı olan bir yapılandırma dosyası barındırmanız gerekir. Uygulama Bağlantıları için bu dosya assetlinks.json dosyasıdır.

assetlinks.json dosyasını oluşturma ve barındırma adımları

assetlinks.json dosyası, uygulama bağlantılarımız için kullanacağımız web alanının içeriğini işleyebilecek yetkili uygulamaların listesini sağlamamıza olanak tanır. Assetlinks.json dosyasının kendisinin web alanının kök dizininde (/.well-known) barındırılması gerekir.

Bu yapılandırmayı tamamlamak için aşağıdaki adımları uygulayın:

1. Firebase Hosting kök dizininizdeki herkese açık klasörün altına .well-known klasörünü oluşturun.

2. .well-known klasörü altında assetlinks.json adlı bir dosya oluşturun.

3. Aşağıdaki her alanın anlamını dikkate alarak aşağıdaki içeriği assetlinks.json dosyanıza kopyalayın:

   [{
     "relation": ["delegate_permission/common.handle_all_urls"],
     "target": {
       "namespace": "android_app",
       "package_name": "com.example.android",
       "sha256_cert_fingerprints":
         ["01:23:45:67:89:AB:CD:EF:01:23:45:67:89:AB:CD:EF:01:23:45:67:89:AB:CD:EF:01:23:45:67:89:AB:CD:EF"]
     }
   }]
   

   • namespace - sağlamak istediğiniz uygulamanın adını ifade eder
   • package_name: Uygulamanın build.gradle dosyasında beyan edilen applicationId değerini ifade eder.
   • sha256_cert_fingerprints: Uygulamayı imzalamak için kullandığınız anahtar mağazası dosyasının SHA256 parmak izini belirtir.

   Hata ayıklama amacıyla bir sha256_cert_fingerprints kaydı oluşturmak amacıyla Android Studio tarafından kullanılan Debugger.keystore dosyasını kullanabilirsiniz. Dosyayı Mac ve Linux'ta /Users/<username>/.android/debug.keystore, Windows'ta ise C:\Users\<username>\.android\debug.keystore adresinde bulabilirsiniz.

   Bu anahtar deposundan, keytool'u kullanarak SHA256 değerini alabilirsiniz.

   Bu adımı tamamlamayla ilgili daha fazla talimat için Uygulama Bağlantıları dokümanının bu bölümüne bakın.

   Alternatif olarak, assetlinks.json dosyasının içeriğini oluşturmak ve uygulamanızı App Links'i kullanacak şekilde yapılandırmak için Android Studio'daki App Links Asistanı'nı da kullanabilirsiniz.

4. firebase.json dosyanızı, dosyayı barındırma için dizine ekleyecek şekilde güncelleyin.

   "headers": [
     {
       "source": "/.well-known/assetlinks.json",
       "headers": [
         {
           "key": "Content-Type",
           "value": "application/json"
         }
       ]
     }
   ]
   

5. assetlinks.json dosyasını oluşturduktan sonra değişiklikleri barındırmak için firebase deploy komutunu çalıştırın.

   Yukarıdaki dağıtım komutunu çalıştırmak için Firebase CLI'nin yüklü olması gerekir.

   firebase deploy --only hosting
   

6. assetlinks.json dosyasını doğrulamak için şu adrese gidin: https://your-project-domain.web.app/.well-known/assetlinks.json

Firebase Dynamic Links'inizde kullanılan derin bağlantı şemasıyla eşleşen yeni App Links oluşturun

Bu adımda, App Links için oluşturduğunuz yeni alanla eşleşen normal derin bağlantı URL'lerini kullanarak Firebase Dynamic Links'inizdeki derin bağlantıları yeniden oluşturursunuz.

Örneğin, aşağıdaki Firebase Dynamic Links'e sahip olduğunuzu varsayalım:

Bu durumda, https://example.web.app/welcome gibi derin bağlantı parametresini ayıklarsınız ve artık bunu uygulamanızın Uygulama Bağlantısı parametresi olarak kullanırsınız.

Bu işlemi, Uygulama Bağlantıları / Evrensel Bağlantılar'a taşımak istediğiniz her Firebase Dinamik Bağlantısı için tekrarlamanız ve kullandığınız derin bağlantı şemasını kopyalamanız gerekir.

Örneğin, lütfen aşağıdaki Firebase Dynamic Links kısa bağlantılarına, derin bağlantı parametrelerine ve taşınan derin bağlantı değerlerine bakın:

Ardından, kullanıcıların önceki Firebase Dynamic Links yerine bu uygulama bağlantılarını tıklaması için, yayınlanmış veya paylaşılmış tüm Firebase Dynamic Links örneklerini yeni taşınan derin bağlantılarla değiştirmeniz gerekir.

Android uygulamanızı ve uygulama kodunuzu derin bağlantılar alacak şekilde güncelleme

Alan adı seçtikten, derin bağlantı şeması seçtikten ve Firebase Dynamic Links'i App Links'e taşıdıktan sonraki adım Android uygulamanızı ve uygulama kodunuzu yeni derin bağlantıları alacak şekilde güncellemektir.

Uygulamanızı derin bağlantıları işleyecek şekilde yapılandırmayla ilgili buradaki Uygulama Bağlantıları dokümanının tamamını veya alternatif olarak Android Studio kılavuzunu okumanızı öneririz. Ancak ana adımlar şunlardır:

1. İlgili derin bağlantıları işlemesi gereken etkinlikleri belirleme
2. AndroidManifest.xml dosyanızda bu etkinlikler için bir Intent Filter ekleme
3. Derin bağlantıyı etkinliklerinizin uygulama kodunda alma

Derin bağlantılarınızın bazılarını işlemek için MainActivity sınıfınızı kullanmak istediğinizi varsayalım. Bunu yapmak için AndroidManifest.xml dosyanızdaki MainActivity'ye aşağıdaki Intent filtresini eklemeniz gerekir:

<activity android:name=".MainActivity"
   android:exported="true">
   <intent-filter>
       <action android:name="android.intent.action.MAIN" />
       <category android:name="android.intent.category.LAUNCHER" />
   </intent-filter>
   <intent-filter android:autoVerify="true">
       <action android:name="android.intent.action.VIEW" />
       <category android:name="android.intent.category.DEFAULT" />
       <category android:name="android.intent.category.BROWSABLE" />
       <data android:host="example.web.app" android:scheme="http"
           android:pathPrefix="/welcome" />
       <data android:host="example.web.app" android:scheme="https"
           android:pathPrefix="/welcome" />
   </intent-filter>
</activity>

Bu adımda, wxample.web.app alanından derin bağlantıların ele alınacağı hedefin MainActivity olduğunu ve buna /welcome yolu ön ekini de dahil ettiğinizi belirtirsiniz. Ayrıca, uygulamanızı bu bağlantı türü için varsayılan işleyici olarak atamanıza olanak tanıyan android:autoVerify="true" özelliğini belirtmeniz gerektiğini de unutmayın.

Son olarak, derin bağlantı verilerini almak ve uygulamanızda derin bağlantı deneyimini artırmak için MainActivity sınıfınıza kodu eklemeniz gerekir. Bu, Firebase Dynamic Links ile entegrasyon sırasında uygulamanızda kodlamış olabileceğiniz mantığa benzer.

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  setContentView(R.layout.main)

  val  data: Uri? = intent?.data

  val toast = Toast.makeText(this, data, duration)
  toast.show()
}

Uygulama Bağlantıları'nı Test Etme

Yeni oluşturduğunuz uygulama bağlantılarını, uygulamanızı fiziksel bir cihazda veya Android Emulator'da çalıştırarak test edebilirsiniz.

Uygulama Bağlantıları için yapılandırılmış alanı kullanarak tıklanabilir bir bağlantı oluşturmanız ve ardından bu bağlantıyı tıklayarak uygulamanızı açtığından ve sizi istenen etkinliğe yönlendirdiğinden emin olmanız gerekir.

Alternatif olarak, Android Studio'daki Uygulama Bağlantıları Asistanı'nı kullanarak uygulama bağlantıları entegrasyonunuzu test edebilir veya eşleşen etkinliğin doğru şekilde başlatılmasını sağlamak için yapılandırdığınız bir uygulama bağlantısı URL'si için aşağıdaki komutu kullanabilirsiniz:

adb shell am start -a android.intent.action.VIEW -d <your_deep_link_url>

Yayınlanan veya paylaşılan Firebase Dynamic Links'lerinizi App Links ile değiştirme

Taşıma işleminizin son adımı, yayınlanan veya paylaşılan Firebase Dynamic Links'i mümkün olduğunda Uygulama Bağlantıları ile değiştirmek ve Uygulama Bağlantıları'nı kullanmaya devam etmektir.

Bu adımı tamamlamak, Firebase Dynamic Links'in nerede ve nasıl yayınlandığına bağlı olarak değişiklik gösterir. Ancak hangilerinin mevcut olduğunu takip etmenize yardımcı olması için mevcut Firebase Dynamic Link meta verilerinizi dışa aktarabilirsiniz. Dinamik Bağlantıları Dışa Aktarma Meta Verilerini Dışa Aktarma kılavuzuna bakın.

iOS'te Evrensel Bağlantılar için Taşıma Adımları

Geçiş bağlantısı yapılandırma dosyalarınızı yeni barındırma alanınızda oluşturun ve barındırın

Geçiş Bağlantıları'nı kullanmak için bağlantılarınızda kullanılan alan ile uygulamanız arasında güvenli bir ilişki kurulmasına yardımcı olan bir yapılandırma dosyası barındırmanız gerekir. Geçiş Bağlantıları için bu dosya apple-app-site-association dosyasıdır (AASA dosyası olarak da bilinir).

apple-app-site-association dosyasını oluşturma ve barındırma adımları

AASA dosyası, Geçiş Bağlantılarımız için kullanacağımız web alanının içeriğini işleyebilecek yetkili uygulamaların listesini sağlamamıza olanak tanır. AASA dosyasının, web alanının kök dizininde /.well-known altında barındırılması gerekir.

Bu yapılandırmayı tamamlamak için aşağıdaki adımları uygulayın:

1. Firebase Hosting kök dizininizdeki herkese açık klasörün altında ".well-known" klasörünü oluşturun.

2. ".well-known" klasörü altında "apple-app-site-association" adlı bir dosya oluşturun.

3. Aşağıdaki her alanın anlamını göz önünde bulundurarak aşağıdaki içeriği apple-app-site-association dosyanıza kopyalayın:

   {
     "applinks": {
       "apps": [],
       "details": [
         {
           "appId": "$TEAM_ID.com.firebase.UniversalLinks",
           "paths": [
             "NOT /_/*",
             "/*"
           ]
         }
       ]
     }
   }
   

   • $TEAM_ID.BundleId: Bağlantıları yönetme yetkisine sahip tam nitelikli uygulama adı

4. firebase.json dosyanızı, dosyayı barındırma için dizine ekleyecek şekilde güncelleyin.

   "headers": [
     {
       "source": "/.well-known/apple-app-site-association",
       "headers": [
         {
           "key": "Content-Type",
           "value": "application/json"
         }
       ]
     }
   ]
   

5. AASA dosyası hazır olduğuna göre, değişiklikleri barındırmak için Firebase dağıtımı yapın.

6. https://your-project-domain.web.app/.well-known/app-app-site-association adresine giderek AASA dosyasını doğrulayın.

Firebase Dynamic Links'inizde kullanılan derin bağlantı şemasıyla eşleşen yeni geçiş bağlantıları oluşturun

Bu adımda, Universal Links'iniz için oluşturduğunuz yeni alanla eşleşen normal derin bağlantı URL'lerini kullanarak Firebase Dynamic Links'inizdeki derin bağlantıları yeniden oluşturursunuz.

Örneğin, aşağıdaki Firebase Dynamic Links'e sahip olduğunuzu varsayalım:

Bu durumda, derin bağlantı parametresini (ör. https://example.web.app/welcome) ayıklarsınız ve artık bunu uygulamanızın Evrensel Bağlantı parametresi olarak kullanırsınız.

Uygulama Bağlantıları / Geçiş Bağlantıları'nı kullanarak geçiş yapmak istediğiniz her Firebase Dynamic Link için bu işlemi tekrarlamanız ve kullandığınız derin bağlantı şemasını kopyalamanız gerekir.

Örneğin, lütfen aşağıdaki Firebase Dynamic Links kısa bağlantılarına, derin bağlantı parametrelerine ve taşınan derin bağlantı değerlerine bakın:

Ardından, kullanıcıların önceki Firebase Dynamic Links yerine bu Evrensel Bağlantıları tıklaması için yayınlanmış veya paylaşılmış tüm Firebase Dynamic Links örneklerini yeni taşınan derin bağlantılarla değiştirmeniz gerekir.

iOS uygulamanızı ve uygulama kodunuzu derin bağlantılar alacak şekilde güncelleme

Alan adı seçtikten, derin bağlantı şeması belirledikten ve Firebase Dynamic Links'inizi Evrensel Bağlantılar'a taşıdıktan sonraki adım, iOS uygulamanızı ve uygulama kodunuzu yeni derin bağlantıları alacak şekilde güncellemektir.

Uygulamanızı derin bağlantıları işleyecek şekilde yapılandırırken Geçiş Bağlantıları dokümanlarının tamamını uygulamanızı öneririz, ancak temel adımlar şunlardır:

1. Uygulamanızın yeni oluşturulan alanınızdaki derin bağlantıları işleyebilmesi için proje yapılandırmanızı güncelleyin

2. Derin bağlantıyı uygulama kodunuzda alma

Proje yapılandırmanızı, uygulamanızın derin bağlantıları işleyebileceği şekilde güncellemek için xCode'da apple-app-site-associate dosyanızı barındırmak üzere kullanmayı planladığınız alan için projenize ek bir İlişkili Alan adı eklemeniz gerekir.

Bunu yapmak için:

1. Xcode'u açma
2. Dosya gezgininde projenizi seçme
3. Proje ayarlarınızın İmzalama ve Özellikler sekmesine gitme
4. İlişkili Alanlar bölümüne gidin
5. Ek alanı "applinks:" biçiminde projenize eklemek için + düğmesini tıklayın.

Son olarak, gelen derin bağlantıları alabilmeniz için uygulama kodunuzu güncellemeniz gerekir.

Bunu başarmak için önce aşağıdaki kodu ekleyerek AppDelegate.swift dosyasını Evrensel Bağlantı'ya yanıt verecek şekilde güncelleyin:

func application(_ application: UIApplication, continue userActivity: NSUserActivity,
                 restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
  AppDelegate.showReceivedUrl(userActivity: userActivity);
  return true
}

static func showReceivedUrl(userActivity: NSUserActivity) {
  if userActivity.activityType == NSUserActivityTypeBrowsingWeb {
    let url = userActivity.webpageURL!
    print(url.absoluteString)
}

Yukarıdaki kod, Geçiş Bağlantısı geri çağırma yöntemini geçersiz kılar ve varsa derin bağlantı URL'sini günlüğe kaydeder.

Artık SceneDelegate sınıfından da aynı showReceivedUrl yöntemini çağıracağız. Çünkü kullanıcı geçiş bağlantısını tıkladığında uygulama zaten açıksa SceneDelegate içindeki geçiş bağlantısı geri çağırma işlevi çağrılır.

func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
  AppDelegate.showReceivedUrl(userActivity: userActivity)
}

Geçiş Bağlantılarını Test Etme

Yeni oluşturduğunuz Universal Links'i, uygulamanızı fiziksel bir cihazda veya simülatörde çalıştırarak test edebilirsiniz.

Universal Links'iniz için yapılandırılmış alanı kullanarak tıklanabilir bir bağlantı oluşturmanız ve ardından bu bağlantıyı tıklayarak uygulamanızı açtığından ve uygulamanızda istediğiniz ekrana yönlendirdiğinden emin olmanız gerekir.

Akıllı Uygulama Banner'larını Destekleme

Kullanıcılarınıza Firebase Dynamic Links'e benzer bir deneyim sunmak için Akıllı Uygulama Banner'larını kullanmanızı önemle tavsiye ederiz.

Akıllı uygulama banner'ları sayesinde, uygulamanız kullanıcıların cihazında yüklü değilse kullanıcılar uygulamanızın mağaza girişine yönlendirilir. İsterseniz bir parametreyi, uygulama indirilip yüklendikten sonra uygulamanıza aktaracak şekilde yapılandırarak da kullanıcılarınıza yolculuklarının devam etmesini sağlayabilirsiniz. Uygulamanız zaten yüklüyse kullanıcının tıkladığı Akıllı Uygulama Banner'ına göre uygun içeriğe yönlendirilmesine yardımcı olmak için parametreyi uygulamanıza iletilir.

Yayınlanan veya paylaşılan Firebase Dynamic Links'lerinizi App Links ile değiştirme

Taşıma işleminizin son adımı, yayınlanan veya paylaşılan Firebase Dynamic Links'i mümkün olduğunda Evrensel Bağlantılarla değiştirmek ve Geçiş Bağlantıları'nı kullanmaya devam etmek olacaktır.

Bu adımı tamamlamak, Firebase Dynamic Links'in nerede ve nasıl yayınlandığına bağlı olarak değişiklik gösterir.

Taşınacak mevcut Firebase Dynamic Links'i izlemenize yardımcı olmak için kısa bağlantı meta verilerinizi Firebase Dynamic Links'ten nasıl dışa aktaracağınızla ilgili bir kılavuz yayınlayacağız. Daha fazla güncelleme için lütfen Dinamik Bağlantılar için Destek Sonlandırma SSS dokümanımızı inceleyin.