iOS'te Dinamik Bağlantılar alma

Oluşturduğunuz Firebase Dynamic Links değerini almak için Dynamic Links SDK'sını uygulamanıza eklemeniz ve uygulamanız yüklendiğinde handleUniversalLink: ve dynamicLinkFromCustomSchemeURL: yöntemlerini çağırarak Dynamic Link içinde iletilen verileri almanız gerekir.

Ön koşullar

Başlamadan önce Firebase'i iOS projenize eklediğinizden emin olun.

Firebase'i ve Dynamic Links SDK'sını kurma

Firebase bağımlılıklarını yüklemek ve yönetmek için Swift Package Manager'ı kullanın.

Firebase SDK'larını Apple projenize eklemenin farklı yollarını öğrenmek için

1. Xcode'da uygulama projeniz açıkken File > Add Packages'a (Dosya > Paket Ekle) gidin.
2. İstendiğinde Firebase Apple platformları SDK deposunu ekleyin:

  https://github.com/firebase/firebase-ios-sdk.git

3. Dynamic Links kitaplığını seçin.
4. Hedefinizin derleme ayarlarının Other Linker Flags (Diğer Bağlayıcı İşaretleri) bölümüne -ObjC işaretini ekleyin.
5. Dynamic Links ile en iyi deneyimi yaşamak için Firebase projenizde Google Analytics etkinleştirmenizi ve Google Analytics için Firebase SDK'sını uygulamanıza eklemenizi öneririz. IDFA toplama özelliği olan veya olmayan kitaplığı seçebilirsiniz. Firebase SDK'sı için Google Analytics'daki en son modül organizasyonu ile ilgili SSS sayfamıza göz atın.
6. İşlem tamamlandığında Xcode, arka planda bağımlılıklarınızı otomatik olarak çözmeye ve indirmeye başlar.

Şimdi bazı yapılandırma adımlarını uygulayın:

1. Firebase konsolunda Dynamic Links bölümünü açın. İstenirse hizmet şartlarını kabul edin.

2. Uygulamanızın uygulama mağazası kimliğinin ve uygulama kimliği önekinizin uygulamanızın ayarlarında belirtildiğinden emin olun. Uygulamanızın ayarlarını görüntülemek ve düzenlemek için Firebase projenizin Ayarlar sayfasına gidip iOS uygulamanızı seçin.

   Firebase projenizin iOS uygulamanızda Dynamic Links kullanacak şekilde doğru yapılandırıldığını aşağıdaki URL'yi açarak onaylayabilirsiniz:

   https://your_dynamic_links_domain/apple-app-site-association

   Uygulamanız bağlıysa apple-app-site-association dosyası, uygulamanızın uygulama kimliği ön ekine ve paket kimliğine referans içerir. Örneğin:

   {"applinks":{"apps":[],"details":[{"appID":"1234567890.com.example.ios","paths":["NOT /_/*","/*"]}]}}

   details alanı boşsa uygulama kimliği ön ekinizi belirttiğinizden emin olun. Uygulama kimliği önekinizin, ekip kimliğinizle aynı olmayabileceğini unutmayın.

3. İsteğe bağlı: Dynamic Links SDK'sının iOS panosunu kullanmasını devre dışı bırakın.

   Dynamic Links SDK'sı, yükleme sonrası derin bağlantıların güvenilirliğini artırmak için varsayılan olarak panoyu kullanır. Dynamic Links, panoyu kullanarak, bir kullanıcı Dynamic Link açtığında ancak önce uygulamanızı yüklemesi gerektiğinde, yükleme işleminden sonra uygulamayı ilk kez açarken doğrudan orijinal bağlantılı içeriğe gidebilmesini sağlayabilir.

   Bu yöntemin dezavantajı, panonun kullanılmasının iOS 14 ve sonraki sürümlerde bildirim tetiklemesidir. Bu nedenle, kullanıcılar uygulamanızı ilk kez açtığında, panoda bir URL varsa uygulamanızın panoya eriştiğini belirten bir bildirim görürler. Bu durum kafa karışıklığına neden olabilir.

   Bu davranışı devre dışı bırakmak için Xcode projenizin Info.plist dosyasını düzenleyin ve FirebaseDeepLinkPasteboardRetrievalEnabled anahtarını NO olarak ayarlayın.

Uygulamanızda Dynamic Links sayfasını açın.

1. Uygulamanızın Xcode projesinin Info (Bilgi) sekmesinde, Dynamic Links için kullanılacak yeni bir URL türü oluşturun. Identifier (Tanımlayıcı) alanını benzersiz bir değere, URL scheme (URL şeması) alanını ise Dynamic Links tarafından kullanılan varsayılan URL şeması olan paket kimliğinize ayarlayın.
2. Uygulamanızın Xcode projesinin Capabilities (Özellikler) sekmesinde Associated Domains'i (İlişkili Alanlar) etkinleştirin ve Associated Domains (İlişkili Alanlar) listesine aşağıdakileri ekleyin:

   applinks:your_dynamic_links_domain

3. Dynamic Links bağlantılarını tamamen özel bir alan adıyla almak istiyorsanız Xcode projenizin Info.plist dosyasında FirebaseDynamicLinksCustomDomains adlı bir anahtar oluşturun ve bu anahtarı uygulamanızın Dynamic Links URL ön eklerine ayarlayın. Örneğin:

   FirebaseDynamicLinksCustomDomains
   
     https://example.com/promos
     https://example.com/links/share
   

4. FirebaseCore modülünü UIApplicationDelegate dosyanıza ve uygulama temsilcinizin kullandığı diğer Firebase modüllerine aktarın. Örneğin, Cloud Firestore ve Authentication kullanmak için:

   SwiftUI

   import SwiftUI
   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Swift

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Objective-C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

5. Uygulama temsilcinizin application(_:didFinishLaunchingWithOptions:) yönteminde paylaşılan bir FirebaseApp örneği yapılandırın:

   SwiftUI

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Swift

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Objective-C

   // Use Firebase library to configure APIs
   [FIRApp configure];

6. SwiftUI kullanıyorsanız bir uygulama temsilcisi oluşturmanız ve bunu UIApplicationDelegateAdaptor veya NSApplicationDelegateAdaptor aracılığıyla App yapınıza eklemeniz gerekir. Ayrıca, uygulama temsilcisi swizzling'ini de devre dışı bırakmanız gerekir. Daha fazla bilgi için SwiftUI talimatlarını inceleyin.

   SwiftUI

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

7. Ardından, application:continueUserActivity:restorationHandler: yönteminde, uygulama zaten yüklüyken Geçiş Bağlantıları olarak alınan bağlantıları işleyin:

   Swift

   Not: Bu ürün macOS, Mac Catalyst, tvOS veya watchOS hedeflerinde kullanılamaz.

   func application(_ application: UIApplication, continue userActivity: NSUserActivity,
                    restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
     let handled = DynamicLinks.dynamicLinks()
       .handleUniversalLink(userActivity.webpageURL!) { dynamiclink, error in
         // ...
       }
   
     return handled
   }

   Objective-C

   Not: Bu ürün macOS, Mac Catalyst, tvOS veya watchOS hedeflerinde kullanılamaz.

   - (BOOL)application:(UIApplication *)application
   continueUserActivity:(nonnull NSUserActivity *)userActivity
    restorationHandler:
   #if defined(__IPHONE_12_0) && (__IPHONE_OS_VERSION_MAX_ALLOWED >= __IPHONE_12_0)
   (nonnull void (^)(NSArray<id> *_Nullable))restorationHandler {
   #else
       (nonnull void (^)(NSArray *_Nullable))restorationHandler {
   #endif  // __IPHONE_12_0
     BOOL handled = [[FIRDynamicLinks dynamicLinks] handleUniversalLink:userActivity.webpageURL
                                                             completion:^(FIRDynamicLink * _Nullable dynamicLink,
                                                                          NSError * _Nullable error) {
                                                               // ...
                                                             }];
     return handled;
   }

8. Son olarak, uygulamanızın özel URL şeması aracılığıyla alınan bağlantıları application:openURL:options: içinde işleyin. Bu yöntem, uygulamanız yüklendikten sonra ilk kez açıldığında çağrılır.

   Uygulamanız ilk kez başlatıldığında Dynamic Link bulunamazsa bu yöntem, DynamicLink'nin url değeri nil olarak ayarlanmış şekilde çağrılır. Bu, SDK'nın eşleşen bir bekleyen Dynamic Link bulamadığını gösterir.

   Swift

   Not: Bu ürün macOS, Mac Catalyst, tvOS veya watchOS hedeflerinde kullanılamaz.

   @available(iOS 9.0, *)
   func application(_ app: UIApplication, open url: URL,
                    options: [UIApplication.OpenURLOptionsKey: Any]) -> Bool {
     return application(app, open: url,
                        sourceApplication: options[UIApplication.OpenURLOptionsKey
                          .sourceApplication] as? String,
                        annotation: "")
   }
   
   func application(_ application: UIApplication, open url: URL, sourceApplication: String?,
                    annotation: Any) -> Bool {
     if let dynamicLink = DynamicLinks.dynamicLinks().dynamicLink(fromCustomSchemeURL: url) {
       // Handle the deep link. For example, show the deep-linked content or
       // apply a promotional offer to the user's account.
       // ...
       return true
     }
     return false
   }

   Objective-C

   Not: Bu ürün macOS, Mac Catalyst, tvOS veya watchOS hedeflerinde kullanılamaz.

   - (BOOL)application:(UIApplication *)app
               openURL:(NSURL *)url
               options:(NSDictionary *)options {
     return [self application:app
                      openURL:url
            sourceApplication:options[UIApplicationOpenURLOptionsSourceApplicationKey]
                   annotation:options[UIApplicationOpenURLOptionsAnnotationKey]];
   }
   
   - (BOOL)application:(UIApplication *)application
               openURL:(NSURL *)url
     sourceApplication:(NSString *)sourceApplication
            annotation:(id)annotation {
     FIRDynamicLink *dynamicLink = [[FIRDynamicLinks dynamicLinks] dynamicLinkFromCustomSchemeURL:url];
   
     if (dynamicLink) {
       if (dynamicLink.url) {
         // Handle the deep link. For example, show the deep-linked content,
         // apply a promotional offer to the user's account or show customized onboarding view.
         // ...
       } else {
         // Dynamic link has empty deep link. This situation will happens if
         // Firebase Dynamic Links iOS SDK tried to retrieve pending dynamic link,
         // but pending link is not available for this device/App combination.
         // At this point you may display default onboarding view.
       }
       return YES;
     }
     return NO;
   }