Oluşturduğunuz Firebase Dynamic Links'i almak için uygulamanıza Dynamic Links SDK'sını dahil etmeniz ve uygulamanız yüklendiğinde Dynamic Link'te iletilen verileri almak için handleUniversalLink:
ile dynamicLinkFromCustomSchemeURL:
yöntemlerini çağırmanız gerekir.
Ön koşullar
Başlamadan önce Firebase'i iOS projenize eklediğinizden emin olun.
Firebase ve Dynamic Links SDK'sını ayarlar
Firebase bağımlılıklarını yükleyip yönetmek için Swift Package Manager'ı kullanın.
- Xcode'da, uygulamanız açıkken File > Add Packages'a (Dosya > Paket Ekle) gidin.
- İstendiğinde Firebase Apple platformlar SDK deposunu ekleyin:
- Dynamic Links kitaplığını seçin.
-ObjC
işaretini, hedefinizin derleme ayarlarındaki Diğer Bağlayıcı İşaretleri bölümüne ekleyin.- Dynamic Links ile optimum bir deneyim elde etmek için Firebase projenizde Google Analytics'i etkinleştirmenizi ve Google Analytics için Firebase SDK'sını uygulamanıza eklemenizi öneririz. IDFA toplama olmayan veya IDFA toplamalı kitaplığı seçebilirsiniz.
- İşlem tamamlandığında Xcode, arka planda bağımlılıklarınızı otomatik olarak çözümlemeye ve indirmeye başlar.
https://github.com/firebase/firebase-ios-sdk.git
Şimdi bazı yapılandırma adımlarını uygulayın:
- Firebase konsolunda Dinamik Bağlantılar bölümünü açın. İstendiğinde hizmet şartlarını kabul edin.
-
Uygulamanızın App Store Kimliği ve Uygulama Kimliği ön ekinizin, 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.
Aşağıdaki URL'yi açarak Firebase projenizin iOS uygulamanızda Dynamic Links'i kullanacak şekilde doğru şekilde yapılandırıldığını 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 önekine ve paket kimliğine referans içerir. Örnek:{"applinks":{"apps":[],"details":[{"appID":"1234567890.com.example.ios","paths":["NOT /_/*","/*"]}]}}
details
alanı boşsa Uygulama Kimliği ön ekinizi belirttiğinizi tekrar kontrol edin. Uygulama kimliği ön ekinizin, Ekip Kimliğinizle aynı olmayabileceğini unutmayın. -
İsteğe bağlı: Dynamic Links SDK'sının iOS yapıştırma panosu kullanımını devre dışı bırakın.
Varsayılan olarak Dynamic Links SDK'sı, yükleme sonrası derin bağlantıların güvenilirliğini artırmak için yapıştırma panosunu kullanır. Dinamik Bağlantılar, yapıştırma panosunu kullanarak bir kullanıcı bir Dinamik Bağlantı açtığında ancak önce uygulamanızı yüklemesi gerektiğinde, uygulamayı yükledikten sonra ilk kez açarken hemen orijinal bağlantılı içeriğe gitmesini sağlayabilir.
Bunun olumsuz tarafı, yapıştırma panosu kullanımının iOS 14 ve sonraki sürümlerde bir bildirimi tetiklemesidir. Dolayısıyla kullanıcılar uygulamanızı ilk kez açtıklarında, yapıştırma panosunda bir URL varsa uygulamanızın yapıştırma panosuna eriştiğine dair bir bildirim görürler. Bu durum karışıklığa neden olabilir.
Bu davranışı devre dışı bırakmak için Xcode projenizin
Info.plist
dosyasını düzenleyin veFirebaseDeepLinkPasteboardRetrievalEnabled
anahtarınıNO
olarak ayarlayın.
Uygulamanızda Dynamic Links'i açın
- Uygulamanızın Xcode projesinin Info sekmesinde, Dynamic Links için kullanılacak yeni bir URL türü oluşturun. Tanımlayıcı alanını benzersiz bir değere, URL şeması alanını ise Dynamic Links tarafından kullanılan varsayılan URL şeması olan paket tanımlayıcınız olacak şekilde ayarlayın.
- Uygulamanızın Xcode projesinin Capabilities (Özellikler) sekmesinde,
Associated Domains'i (İlişkili Alanlar) etkinleştirin ve aşağıdakileri Associated Domains (İlişkili
Alanlar) listesine ekleyin:
applinks:your_dynamic_links_domain
- Tümüyle özel bir alan adına sahip Dynamic Links almak istiyorsanız Xcode projenizin
Info.plist
dosyasındaFirebaseDynamicLinksCustomDomains
adında bir anahtar oluşturun ve bunu uygulamanızın Dynamic Links URL öneklerine ayarlayın. Örneğin:FirebaseDynamicLinksCustomDomains https://example.com/promos https://example.com/links/share FirebaseCore
modülünüUIApplicationDelegate
uygulamanıza ve yetki verdiğiniz kullanıcının kullandığı diğer tüm Firebase modüllerini içe aktarın. Örneğin, Cloud Firestore ve Authentication'ı kullanmak için:Hızlı Kullanıcı Arayüzü
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Swift
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Objective-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Uygulama yetkilinizin
application(_:didFinishLaunchingWithOptions:)
yöntemindeFirebaseApp
paylaşılan bir örnek yapılandırın:Hızlı Kullanıcı Arayüzü
// 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];
- SwiftUI kullanıyorsanız bir uygulama temsilcisi oluşturmanız ve
UIApplicationDelegateAdaptor
veyaNSApplicationDelegateAdaptor
aracılığıylaApp
yapınıza eklemeniz gerekir. Uygulama yetkilendirmesi kaydırmayı da devre dışı bırakmanız gerekir. Daha fazla bilgi için SwiftUI talimatlarına bakın.Hızlı Kullanıcı Arayüzü
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
- Daha sonra,
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<UIUserActivityRestoring>> *_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; }
- Son olarak,
application:openURL:options:
içinde, uygulamanızın özel URL şeması üzerinden alınan bağlantıları işleyin. Bu yöntem, uygulamanız yükleme işleminden sonra ilk kez açıldığında çağrılır.Uygulamanızın ilk kez başlatılmasında Dinamik Bağlantı bulunamazsa bu yöntem,
DynamicLink
öğesininurl
değerinil
olarak ayarlanmış şekilde çağrılır. Bu, SDK'nın bekleyen bir Dinamik Bağlantı 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<NSString *, id> *)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; }