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

Bu taşıma kılavuzu, Uygulama Bağlantıları ve Evrensel Bağlantıları kullanmaya, isteğe bağlı olarak uygulama-site ilişkilendirme dosyalarınızı barındırmak için Firebase Hosting'i kullanmaya odaklanmaktadı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 başka Firebase Dynamic Links özelliklerine ihtiyacınız varsa Dynamic Links desteğinin sonlandırılmasıyla ilgili SSS dokümanındaki diğer taşıma senaryolarına bakın.

Şuna benzer bir Firebase Dynamic Link'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

Şu şekilde görünen Uygulama Bağlantısı / Geçiş Bağlantısı 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üyse tıklayarak uygulamanızı açabilecekleri bir derin bağlantı
• Uygulamanız açıldığında kullanıcı yolculuklarına devam ederek onları uygulamanızın belirli bir bölümüne yönlendirme

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

• Kullanıcıları, uygulamanızı indirmek ve yüklemek için cihazlarına uygun mağazaya yönlendirme
• Uygulamayı indirip yükledikten ve ilk kez açtıktan sonra kullanıcı yolculuklarına devam etmelerini sağlama

Bu uygulama bağlantılarının / evrensel bağlantıların davranış ve işlevselliği ile ilgili yukarıdaki tabloda belirtilen Firebase Dynamic Links'e kıyasla farklılıkları göz önünde bulundurun.

Başlamadan önce

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

Bu kılavuzda, Firebase Dynamic Links'i yeni App Links / Universal Links taşıma çözümüne taşırken Firebase Hosting'i kullanarak Firebase Dynamic Links'in sağladığı işlevselliğin bu bölümünü değiştirmek için kendi App Links ve Universal Links'inizi nasıl oluşturacağınız açıklanmaktadır.

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

• Taşımayı planladığınız Firebase Dynamic Links bağlantıları
• Dinamik bağlantılarınıza eklenen derin bağlantı URL'si parametreleri
• Önceki Firebase Dynamic Links alanınızın yerine 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ı sağlayın (kullanmak istediğiniz bir alan adınız yoksa).

2. Uygulama Bağlantısı / Evrensel Bağlantı yapılandırma dosyalarınızı oluşturup 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. Derin bağlantıları almak için Android / iOS uygulamalarınızı ve uygulama kodunuzu güncelleyin.

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

6. Yayınlanmış veya paylaşılmış Firebase Dynamic Links'lerinizi uygulama bağlantıları ve geçiş bağlantılarıyla değiştirin.

İlk adım, Uygulama Bağlantıları veya Geçiş Bağlantısı taşıma akışlarının her ikisinde de ortaktır. Geri kalan adımlar 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 Uygulama Bağlantıları 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ırmak için yeni bir alan sağlama

Bir alan adı seçin

İ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 alan, kullanıcılarınızla paylaşacağınız yeni bağlantılar için kullanılacak alan olacaktır.

Firebase Hosting kullanıyorsanız your-project-domain.web.app veya your-project-domain.firebaseapp.com biçimindeki proje alt alanları otomatik olarak ve ücretsiz olarak sağlanır. İsteğe bağlı olarak, App Link / Evrensel Bağlantı yapılandırma dosyalarınızı barındırmak için Firebase Hosting ile veya Firebase Hosting olmadan özel bir alan adı da kullanabilirsiniz.

Firebase Hosting'i ayarlayın

Ardından, Firebase Hosting örneğinizi ayarlayıp yapılandırmanız gerekir.

Firebase Hosting örneğinizi ayarlamayı tamamladığınızda your-project-domain.web.app` alanına benzer bir alanınız veya isterseniz özel alanınız olur.

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şturma ve barındırma

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 oluşturmaya 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şleyebilen yetkili uygulamaların listesini sağlamamıza olanak tanır. assetlinks.json dosyasının kendisi, web alanının kök dizininde şu yol altında barındırılmalıdır: /.well-known.

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

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

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

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

   [{
     "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'yi ifade eder.
   • sha256_cert_fingerprints, uygulamayı imzalamak için kullandığınız anahtar deposu dosyasının SHA-256 parmak izini ifade eder.

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

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

   Bu adımı tamamlama hakkında daha fazla talimat için Uygulama Bağlantıları dokümanlarının bu bölümüne bakın.

   Alternatif olarak, assetlinks.json dosya içeriklerini oluşturmak ve uygulamanızı App Links'i işleyecek şekilde yapılandırmak için Android Studio'daki App Links Asistanı'nı da kullanabilirsiniz.

4. Barındırma için dosyayı dizine eklemek üzere firebase.json dosyanızı 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ı gerektiğini unutmayın.

   firebase deploy --only hosting
   

6. Şuraya giderek assetlinks.json dosyasını doğrulayın: 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 uygulama bağlantıları oluşturun.

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

Örneğin, aşağıdaki Firebase Dynamic Link'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 için uygulama bağlantısı parametresi olarak kullanırsınız.

Uygulama Bağlantıları / Evrensel Bağlantılar kullanmaya geçirmek istediğiniz her Firebase Dinamik Bağlantısı 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ı, derin bağlantı parametreleri ve taşınan derin bağlantı değerleri grubuna bakın:

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

Derin bağlantıları almak için Android uygulamanızı ve uygulama kodunuzu güncelleme

Bir alan adı seçtikten, derin bağlantı şeması belirledikten ve Firebase Dynamic Links'lerinizi uygulama bağlantılarına taşıdıktan sonraki adım, yeni derin bağlantıları almak için Android uygulamanızı ve uygulama kodunuzu güncellemek olacaktır.

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

1. Hangi etkinliklerin ilgili derin bağlantıları işlemesi gerektiğini belirleme
2. AndroidManifest.xml dosyanıza bu etkinlikler için bir Intent filtresi ekleme
3. Etkinliklerinizin uygulama kodunda derin bağlantıyı alma

Bazı derin bağlantılarınızı işlemek için MainActivity'nizi kullanmak istediğinizi varsayalım. Bunu yapmak için AndroidManifest.xml dosyanızdaki MainActivity'ye aşağıdaki Intent Filtresi'ni 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, MainActivity'nin wxample.web.app alanından gelen ve /welcome yol önekini içeren derin bağlantıların işleneceği hedef olduğunu belirtiyorsunuz. Ayrıca, uygulamanızı bu bağlantı türü için varsayılan işleyici olarak belirlemenize olanak tanıyan android:autoVerify="true" özelliğini de belirtmeniz gerektiğini unutmayın.

Son olarak, derin bağlantı verilerini almak ve uygulamanızda derin bağlantı deneyimini yönlendirmek için MainActivity'nize 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.

App Links için yapılandırılan alan adını kullanarak tıklanabilir bir bağlantı oluşturmanız ve ardından bu bağlantıyı tıklayarak uygulamanızda açıldığından ve sizi amaçlanan 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 yapılandırdığınız bir uygulama bağlantısı URL'si için aşağıdaki komutu kullanarak eşleşen etkinliğin doğru şekilde başlatıldığından emin olabilirsiniz:

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

Yayınlanmış veya paylaşılmış Firebase Dynamic Links'lerinizi uygulama bağlantılarıyla değiştirme

Taşıma işleminizin son adımı, yayınlanmış veya paylaşılmış Firebase Dynamic Links'lerinizi mümkün olan her yerde uygulama bağlantılarıyla değiştirmek ve bundan sonra uygulama bağlantılarını kullanmaya devam etmektir.

Bu adımı tamamlama şekliniz, Firebase Dynamic Links'lerinizi nerede ve nasıl yayınladığınıza bağlı olarak değişir. Ancak hangilerinin mevcut olduğunu izlemenize yardımcı olmak için mevcut Firebase Dynamic Link meta verilerinizi dışa aktarabilirsiniz. Dinamik Bağlantı Meta Verilerini Dışa Aktarma Kılavuzu'na bakın.

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

Yeni barındırma alanınızda geçiş bağlantısı yapılandırma dosyalarınızı oluşturma ve barındırma

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 oluşturmaya 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ı, web alanının kök dizininde şu yol altında barındırılmalıdır: /.well-known.

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

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

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

3. Aşağıdaki içeriği apple-app-site-association dosyanıza kopyalayın. Aşağıdaki her alanın anlamını not edin:

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

   • $TEAM_ID.BundleId: Bağlantıları işlemek için yetkilendirilmiş tam nitelikli uygulama adı

4. Barındırma için dosyayı dizine eklemek üzere firebase.json dosyanızı güncelleyin.

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

5. AASA dosyasını oluşturduktan sonra değişiklikleri barındırmak için firebase deploy komutunu çalıştırı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, Firebase Dynamic Links'teki derin bağlantıları, Evrensel Bağlantılarınız için oluşturduğunuz yeni alanla eşleşen normal derin bağlantı URL'lerini kullanarak yeniden oluşturacaksınız.

Örneğin, aşağıdaki Firebase Dynamic Link'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ı / Evrensel Bağlantılar kullanmaya geçirmek istediğiniz her Firebase Dinamik Bağlantısı 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ı, derin bağlantı parametreleri ve taşınan derin bağlantı değerleri grubuna bakın:

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

Derin bağlantıları almak için iOS uygulamanızı ve uygulama kodunuzu güncelleyin

Bir alan adı seçtikten, derin bağlantı şeması belirledikten ve Firebase Dynamic Links'lerinizi Evrensel Bağlantılar'a taşıdıktan sonraki adım, yeni derin bağlantıları almak için iOS uygulamanızı ve uygulama kodunuzu güncellemek olacaktır.

Uygulamanızı derin bağlantıları işleyecek şekilde yapılandırma konusunda buradaki tam Geçiş Bağlantıları dokümanını incelemenizi öneririz. Ancak temel adımlar şunlardır:

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

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

Uygulamanızın derin bağlantıları işleyebilmesi için proje yapılandırmanızı güncellemek üzere, artık apple-app-site-associate dosyanızı barındırmak için kullanmayı planladığınız alan adı için Xcode'daki projenize ek bir İlişkili Alan adı eklemeniz gerekir.

Bu işlem için:

1. Xcode'u açma
2. Dosya Gezgini'nde projenizi seçme
3. Proje ayarlarınızın İmzalama ve Özellikler sekmesine gitme
4. Aşağı kaydırarak İlişkili Alanlar bölümüne gidin.
5. + düğmesini tıklayarak ek alanı projenize "applinks:" biçiminde ekleyin.

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

Bunu yapmak için öncelikle AppDelegate.swift dosyasını aşağıdaki kodu ekleyerek 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 aynı showReceivedUrl yöntemini SceneDelegate sınıfından da ç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ğırması ç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 evrensel bağlantıları, uygulamanızı fiziksel bir cihazda veya simülatörde çalıştırarak test edebilirsiniz.

Evrensel Bağlantılarınız için yapılandırılan alanı kullanarak tıklanabilir bir bağlantı oluşturmanız ve ardından bu bağlantıyı tıklayarak uygulamanızda açıldığından ve sizi uygulamanızdaki amaçlanan 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ı kullanıldığında, uygulamanız cihazlarında yüklü değilse kullanıcılarınız uygulamanızın mağaza girişi için App Store'a yönlendirilir. Ayrıca, kullanıcılarınıza yolculuklarına devam etme imkanı sunmak için uygulamanız indirildikten ve yüklendikten sonra iletilecek bir parametreyi isteğe bağlı olarak yapılandırabilirsiniz. Uygulamanız zaten yüklüyse, kullanıcınızı tıkladığı akıllı uygulama banner'ına göre uygun içeriğe yönlendirmek için parametreyi uygulamanıza ileterek açılır.

Yayınlanmış veya paylaşılmış Firebase Dynamic Links'lerinizi uygulama bağlantılarıyla değiştirme

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

Bu adımı tamamlama süresi, Firebase Dinamik Bağlantılarınızı nerede ve nasıl yayınladığınıza bağlı olarak değişir.

Mevcut Firebase Dynamic Links'leri izleyip taşımaya yardımcı olmak için kısa bağlantı meta verilerinizi Firebase Dynamic Links'ten nasıl dışa aktaracağınıza dair bir kılavuz yayınlayacağız. Daha fazla güncelleme için lütfen Dinamik Bağlantıların Kullanımdan Kaldırılmasıyla İlgili SSS Dokümanımızı tekrar kontrol edin.