如需接收您创建的 Firebase 动态链接，您必须将 Dynamic Links SDK 添加到应用中，并在应用加载时调用 handleUniversalLink: 和 dynamicLinkFromCustomSchemeURL: 方法，以获取动态链接中传递的数据。
前提条件
在开始之前，请务必将 Firebase 添加到您的 iOS 项目中。
设置 Firebase 和 Dynamic Links SDK
使用 Swift Package Manager 安装和管理 Firebase 依赖项。
- 在 Xcode 中打开您的应用项目，依次点击 File（文件）> Add Packages（添加软件包）。
- 出现提示时，添加 Firebase Apple 平台 SDK 代码库：
- 选择 Dynamic Links 库。
- 为了获得最佳的 Dynamic Links 使用体验，我们建议您在 Firebase 项目中启用 Google Analytics（分析），并将 Firebase SDK for Google Analytics 添加到您的应用中。您可以选择不收集 IDFA 的库，也可以选择收集 IDFA 的库。
- 完成之后，Xcode 将会自动开始在后台解析和下载您的依赖项。
https://github.com/firebase/firebase-ios-sdk
现在，执行一些配置步骤：
- 在 Firebase 控制台中，打开 Dynamic Links 部分。如有提示，请接受服务条款。
-
确保已在您的应用的设置中指定应用的 App Store ID 和应用 ID 前缀。如需查看和修改应用的设置，请前往 Firebase 项目的“设置”页面，然后选择您的 iOS 应用。
您可以打开下面的网址，确认您的 Firebase 项目已正确配置为在 iOS 应用中使用动态链接：
https://your_dynamic_links_domain/apple-app-site-association
如果您的应用已关联，则
apple-app-site-association文件中包含对应用 ID 前缀和软件包 ID 的引用。例如：{"applinks":{"apps":[],"details":[{"appID":"1234567890.com.example.ios","paths":["NOT /_/*","/*"]}]}}如果
details字段为空，请仔细检查您是否指定了应用 ID 前缀。请注意，应用 ID 前缀可能与团队 ID 不同。 -
可选：禁止 Dynamic Links SDK 使用 iOS 粘贴板。
默认情况下，Dynamic Links SDK 使用粘贴板来提升安装后深层链接的可靠性。通过使用粘贴板，Dynamic Links 可以确保当用户打开动态链接但需要先安装您的应用时，可以在安装应用后首次打开应用时立即转到原本链接到的内容。
这样做的缺点是，在 iOS 14 及更高版本的平台上使用粘贴板会触发通知。因此，当用户第一次打开您的应用时，如果粘贴板中包含网址，他们会看到一条通知，提示您的应用已访问粘贴板，用户可能不理解为什么会收到这个通知。
如需阻止此行为，请修改 Xcode 项目的
Info.plist文件并将FirebaseDeepLinkPasteboardRetrievalEnabled键设为NO。
在您的应用中打开动态链接
- 在应用的 Xcode 项目的 Info（信息）标签页中，创建一个新的网址类型以用于动态链接。将 Identifier（标识符）字段设为一个唯一的值，将 URL scheme（网址架构）字段设为软件包标识符，即动态链接使用的默认网址架构。
- 在应用的 Xcode 项目的Capabilities（功能）标签页中，启用“Associated Domains”，并将以下内容添加到 Associated Domains（相关网域）列表中：
applinks:your_dynamic_links_domain
- 如果您想要接收带有完全自定义域名的动态链接，请在 Xcode 项目的
Info.plist文件中，创建一个名为FirebaseDynamicLinksCustomDomains的键，并将其设置为应用的动态链接网址前缀。例如：FirebaseDynamicLinksCustomDomains https://example.com/promos https://example.com/links/share - 在
UIApplicationDelegate中导入FirebaseCore模块，以及您的应用委托 (app delegate) 使用的所有其他 Firebase 模块。 例如，如需使用 Cloud Firestore 和 Authentication，请添加以下代码：SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...Swift
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...Objective-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ... - 在应用委托的
application(_:didFinishLaunchingWithOptions:)方法中配置一个FirebaseApp共享实例：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];
- 如果您使用的是 SwiftUI，则必须创建应用委托并通过
UIApplicationDelegateAdaptor或NSApplicationDelegateAdaptor将其附加到App结构体。您还必须停用应用委托调配。如需了解详情，请参阅 SwiftUI 说明。SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } } - 接下来，在
application:continueUserActivity:restorationHandler:方法中处理在已安装应用的情况下收到的通用链接形式的链接：Swift
注意：此产品不适用于 macOS、Mac Catalyst、tvOS 或 watchOS 目标。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
注意：此产品不适用于 macOS、Mac Catalyst、tvOS 或 watchOS 目标。- (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; } - 最后，在
application:openURL:options:中处理通过应用的自定义网址架构接收的链接。此方法会在应用于安装后首次打开时调用。如果应用在首次启动时未找到动态链接，系统在调用此方法时会将
DynamicLink的url设置为nil，以表明 SDK 无法找到匹配的待处理动态链接。Swift
注意：此产品不适用于 macOS、Mac Catalyst、tvOS 或 watchOS 目标。@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
注意：此产品不适用于 macOS、Mac Catalyst、tvOS 或 watchOS 目标。- (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; }