Oluşturduğunuz Firebase Dynamic Links'i almak için Dynamic Links SDK'yı uygulamanıza dahil etmeniz ve Dynamic Link'te iletilen verileri almak için uygulamanız yüklendiğinde handleUniversalLink:
ve dynamicLinkFromCustomSchemeURL:
yöntemlerini çağırmanız gerekir.
Önkoşullar
Başlamadan önce, Firebase'i iOS projenize eklediğinizden emin olun.
Firebase ve Dinamik Bağlantılar SDK'sını kurun
Firebase bağımlılıklarını kurmak ve yönetmek için Swift Paket Yöneticisi'ni kullanın.
- Xcode'da, uygulama projeniz açıkken File > Add Packages seçeneğine gidin.
- İstendiğinde, Firebase Apple platformları SDK deposunu ekleyin:
- Dinamik Bağlantılar kitaplığını seçin.
- Dynamic Links ile optimum bir deneyim için Firebase projenizde Google Analytics'i etkinleştirmenizi ve Google Analytics için Firebase SDK'yı uygulamanıza eklemenizi öneririz. Kütüphaneyi IDFA koleksiyonu olmadan veya IDFA koleksiyonu ile seçebilirsiniz.
- Bittiğinde, Xcode otomatik olarak arka planda bağımlılıklarınızı çözmeye ve indirmeye başlayacaktır.
https://github.com/firebase/firebase-ios-sdk
Şimdi, bazı yapılandırma adımlarını gerçekleştirin:
- Firebase konsolunda Dinamik Bağlantılar bölümünü açın. Sizden istenirse hizmet şartlarını kabul edin.
Uygulamanızın App Store ID'sinin ve App ID ö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 gidin ve iOS uygulamanızı seçin.
Aşağıdaki URL'yi açarak, Firebase projenizin iOS uygulamanızda Dinamik Bağlantıları kullanacak şekilde doğru şekilde yapılandırıldığını doğrulayabilirsiniz:
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 bir 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ğinizi tekrar kontrol edin. Uygulama Kimliği ön ekinizin Ekip Kimliğinizle aynı olmayabileceğini unutmayın.İsteğe bağlı : Dynamic Links SDK'nın iOS çalışma alanını kullanmasını devre dışı bırakın.
Varsayılan olarak Dynamic Links SDK, yükleme sonrası derin bağlantıların güvenilirliğini artırmak için çalışma alanını kullanır. Dinamik Bağlantılar çalışma alanını kullanarak, bir kullanıcı bir Dinamik Bağlantı açtığında ancak önce uygulamanızı yüklemesi gerektiğinde, kullanıcının uygulamayı kurulumdan sonra ilk kez açarken hemen orijinal bağlantılı içeriğe gidebilmesini sağlayabilir.
Bunun dezavantajı, çalışma alanı kullanımının iOS 14 ve sonrasında bir bildirimi tetiklemesidir. Bu nedenle, kullanıcılar uygulamanızı ilk açtığında, çalışma alanında bir URL varsa, uygulamanızın çalışma alanına eriştiğine dair bir bildirim görecek ve bu da 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 Dinamik Bağlantıları açın
- Uygulamanızın Xcode projesinin Bilgi sekmesinde, Dinamik Bağlantılar için kullanılacak yeni bir URL türü oluşturun. Tanımlayıcı alanını benzersiz bir değere ve URL şeması alanını, Dinamik Bağlantılar tarafından kullanılan varsayılan URL şeması olan paket tanımlayıcınız olarak ayarlayın.
- Uygulamanızın Xcode projesinin Yetenekler sekmesinde İlişkili Etki Alanlarını etkinleştirin ve aşağıdakileri İlişkili Etki Alanları listesine ekleyin:
applinks:your_dynamic_links_domain
- Tamamen özel bir etki alanına sahip Dinamik Bağlantılar almak istiyorsanız Xcode projenizin
Info.plist
dosyasındaFirebaseDynamicLinksCustomDomains
adlı bir anahtar oluşturun ve bunu uygulamanızın Dinamik Bağlantılar URL öneklerine ayarlayın. Örneğin:FirebaseDynamicLinksCustomDomains https://example.com/promos https://example.com/links/share -
UIApplicationDelegate
uygulamanızaFirebaseCore
modülünü ve uygulama temsilcinizin kullandığı diğer Firebase modüllerini içe aktarın. Örneğin, Cloud Firestore ve Authentication'ı kullanmak için:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Süratli
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Amaç-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Uygulama temsilcinizin
application(_:didFinishLaunchingWithOptions:)
yönteminde birFirebaseApp
paylaşılan örneği yapılandırın:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Süratli
// Use Firebase library to configure APIs FirebaseApp.configure()
Amaç-C
// Use Firebase library to configure APIs [FIRApp configure];
- SwiftUI kullanıyorsanız, bir uygulama temsilcisi oluşturmalı ve bunu
UIApplicationDelegateAdaptor
veyaNSApplicationDelegateAdaptor
aracılığıylaApp
yapınıza eklemelisiniz. Uygulama temsilcisi swizzling'i de devre dışı bırakmalısınız. Daha fazla bilgi için SwiftUI talimatlarına bakın.SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
- Ardından,
application:continueUserActivity:restorationHandler:
yönteminde, uygulama zaten yüklendiğinde Evrensel Bağlantılar olarak alınan bağlantıları işleyin:Süratli
Not: Bu ürün macOS, Mac Catalyst, tvOS veya watchOS hedeflerinde mevcut değildir.func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool { let handled = DynamicLinks.dynamicLinks() .handleUniversalLink(userActivity.webpageURL!) { dynamiclink, error in // ... } return handled }
Amaç-C
Not: Bu ürün macOS, Mac Catalyst, tvOS veya watchOS hedeflerinde mevcut değildir.- (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:
uygulamanızın özel URL şeması aracılığıyla alınan bağlantıları işleyin. Bu yöntem, kurulumdan sonra uygulamanız ilk kez açıldığında çağrılır.Dinamik Bağlantı, uygulamanızın ilk başlatılışında bulunmazsa, bu yöntem,
DynamicLink
url
nil
olarak ayarlanarak çağrılacak ve bu, SDK'nın bekleyen bir eşleşen Dinamik Bağlantı bulamadığını gösterecektir.Süratli
Not: Bu ürün macOS, Mac Catalyst, tvOS veya watchOS hedeflerinde mevcut değildir.@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 }
Amaç-C
Not: Bu ürün macOS, Mac Catalyst, tvOS veya watchOS hedeflerinde mevcut değildir.- (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; }