Nhận đường liên kết động trên iOS

Để nhận Firebase Dynamic Links mà bạn đã tạo, bạn phải đưa SDK Dynamic Links vào ứng dụng và gọi các phương thức handleUniversalLink: và dynamicLinkFromCustomSchemeURL: khi ứng dụng tải để nhận dữ liệu được truyền trong Dynamic Link.

Điều kiện tiên quyết

Trước khi bắt đầu, hãy nhớ thêm Firebase vào dự án iOS của bạn.

Thiết lập Firebase và SDK Dynamic Links

Sử dụng Trình quản lý gói Swift để cài đặt và quản lý các phần phụ thuộc của Firebase.

Trong Xcode, khi dự án ứng dụng của bạn đang mở, hãy chuyển đến File (Tệp) > Add Packages (Thêm gói).
Khi được nhắc, hãy thêm kho lưu trữ SDK nền tảng Apple của Firebase:

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

Chọn thư viện Dynamic Links.
Thêm cờ -ObjC vào phần Other Linker Flags (Cờ trình liên kết khác) trong chế độ cài đặt bản dựng của mục tiêu.
Để có trải nghiệm tối ưu với Dynamic Links, bạn nên bật Google Analytics trong dự án Firebase và thêm Firebase SDK cho Google Analytics vào ứng dụng. Bạn có thể chọn thư viện không thu thập IDFA hoặc có thu thập IDFA. Hãy xem Câu hỏi thường gặp của chúng tôi về cách tổ chức mô-đun mới nhất trong Google Analytics cho Firebase SDK.
Khi bạn hoàn tất, Xcode sẽ tự động bắt đầu phân giải và tải các phần phụ thuộc xuống ở chế độ nền.

Bây giờ, hãy thực hiện một số bước định cấu hình:

Trong Firebase bảng điều khiển, hãy mở phần Dynamic Links. Chấp nhận điều khoản dịch vụ nếu bạn được nhắc làm như vậy.
Đảm bảo rằng Mã App Store của ứng dụng và tiền tố Mã ứng dụng được chỉ định trong phần cài đặt của ứng dụng. Để xem và chỉnh sửa phần cài đặt của ứng dụng, hãy chuyển đến trang Cài đặt của dự án Firebase rồi chọn ứng dụng iOS.

Bạn có thể xác nhận rằng dự án Firebase được định cấu hình đúng cách để sử dụng Dynamic Links trong ứng dụng iOS bằng cách mở URL sau:
```
https://your_dynamic_links_domain/apple-app-site-association
```
Nếu ứng dụng của bạn được kết nối, thì tệp apple-app-site-association sẽ chứa một tham chiếu đến tiền tố Mã ứng dụng và mã nhận dạng gói của ứng dụng. Ví dụ:
```
{"applinks":{"apps":[],"details":[{"appID":"1234567890.com.example.ios","paths":["NOT /_/*","/*"]}]}}
```
Nếu trường details trống, hãy kiểm tra kỹ để đảm bảo rằng bạn đã chỉ định tiền tố Mã ứng dụng. Xin lưu ý rằng tiền tố Mã ứng dụng có thể không giống với Mã nhóm.
Không bắt buộc: Tắt việc sử dụng bảng tạm iOS của SDKDynamic Links

Theo mặc định, SDK Dynamic Links sử dụng bảng tạm để cải thiện độ tin cậy của đường liên kết sâu sau khi cài đặt. Bằng cách sử dụng bảng tạm, Dynamic Links có thể đảm bảo rằng khi người dùng mở một Dynamic Link nhưng cần cài đặt ứng dụng của bạn trước, thì người dùng có thể chuyển ngay đến nội dung được liên kết ban đầu khi mở ứng dụng lần đầu tiên sau khi cài đặt.

Nhược điểm của việc này là việc sử dụng bảng tạm sẽ kích hoạt một thông báo trên iOS 14 trở lên. Vì vậy, lần đầu tiên người dùng mở ứng dụng của bạn, nếu bảng tạm chứa một URL, họ sẽ thấy một thông báo cho biết ứng dụng của bạn đã truy cập vào bảng tạm. Điều này có thể gây nhầm lẫn.

Để tắt hành vi này, hãy chỉnh sửa tệp Info.plist của dự án Xcode và đặt khoá FirebaseDeepLinkPasteboardRetrievalEnabled thành NO.

Khi bạn tắt tính năng này, Dynamic Links mà bạn nhận được sẽ có matchType là weak ở mức tốt nhất. Hãy điều chỉnh logic của ứng dụng cho phù hợp.

Mở Dynamic Links trong ứng dụng

Trong thẻ Info (Thông tin) của dự án Xcode cho ứng dụng, hãy tạo một loại URL mới để dùng cho Dynamic Links. Đặt trường Identifier thành một giá trị duy nhất và trường URL scheme thành mã nhận dạng gói của bạn. Đây là lược đồ URL mặc định mà Dynamic Links sử dụng.
Trong thẻ Capabilities (Tính năng) của dự án Xcode cho ứng dụng, hãy bật Miền được liên kết và thêm nội dung sau vào danh sách Associated Domains (Miền được liên kết):
```
applinks:your_dynamic_links_domain
```
Nếu bạn muốn nhận Dynamic Links có miền tuỳ chỉnh hoàn toàn, thì trong tệp Info.plist của dự án Xcode, hãy tạo một khoá có tên là FirebaseDynamicLinksCustomDomains và đặt khoá đó thành tiền tố URL Dynamic Links của ứng dụng. Ví dụ:
```
FirebaseDynamicLinksCustomDomains

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

Nhập mô-đun FirebaseCore trong UIApplicationDelegate, cũng như mọi mô-đun Firebase khác mà đại diện ứng dụng của bạn sử dụng. Ví dụ: để sử dụng Cloud Firestore và 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;
// ...

Định cấu hình một FirebaseApp thực thể dùng chung trong phương thức application(_:didFinishLaunchingWithOptions:) của đại diện ứng dụng:

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];

Nếu đang sử dụng SwiftUI, bạn phải tạo một đại diện ứng dụng và đính kèm đại diện đó vào cấu trúc App thông qua UIApplicationDelegateAdaptor hoặc NSApplicationDelegateAdaptor. Bạn cũng phải tắt tính năng hoán đổi đại diện ứng dụng. Để biết thêm thông tin, hãy xem hướng dẫn về SwiftUI.
SwiftUI
```
@main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}
      
```

Tiếp theo, trong phương thức

application:continueUserActivity:restorationHandler:

, hãy xử lý các đường liên kết nhận được dưới dạng Đường liên kết phổ quát khi ứng dụng đã được cài đặt:

Swift

Lưu ý: Sản phẩm này không hoạt động trên các mục tiêu macOS, Mac Catalyst, tvOS hoặc 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

Lưu ý: Sản phẩm này không hoạt động trên các mục tiêu macOS, Mac Catalyst, tvOS hoặc 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> *_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;
}

Cuối cùng, trong application:openURL:options: hãy xử lý các đường liên kết nhận được thông qua lược đồ URL tuỳ chỉnh của ứng dụng. Phương thức này được gọi khi ứng dụng của bạn được mở lần đầu tiên sau khi cài đặt.

Nếu không tìm thấy Dynamic Link trong lần khởi chạy đầu tiên của ứng dụng, thì phương thức này sẽ được gọi với DynamicLink's url được đặt thành nil, cho biết rằng SDK không tìm thấy Dynamic Link đang chờ xử lý phù hợp.

Swift

Lưu ý: Sản phẩm này không hoạt động trên các mục tiêu macOS, Mac Catalyst, tvOS hoặc 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

Lưu ý: Sản phẩm này không hoạt động trên các mục tiêu macOS, Mac Catalyst, tvOS hoặc watchOS.

- (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;
}

Nhận đường liên kết động trên iOS Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Điều kiện tiên quyết

Thiết lập Firebase và SDK Dynamic Links

Mở Dynamic Links trong ứng dụng

SwiftUI

Swift

Objective-C

SwiftUI

Swift

Objective-C

SwiftUI

Swift

Objective-C

Swift

Objective-C

Nhận đường liên kết động trên iOS