Tạo đường liên kết động trên iOS

Bạn có thể tạo ngắn hoặc dài Dynamic Links bằng API Trình tạo Firebase Dynamic Links. API này chấp nhận một Dynamic Link dài hoặc một đối tượng chứa các Dynamic Link và trả về các URL như trong ví dụ sau:

https://example.com/link/WXYZ
https://example.page.link/WXYZ

Đ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.

1. 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).
2. 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

3. Chọn thư viện Dynamic Links.
4. 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.
5. Để 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 của mình. 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.
6. Khi 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:

1. Trong bảng điều khiển Firebase, hãy mở phần Dynamic Links.

2. Nếu bạn chưa chấp nhận điều khoản dịch vụ và đặt tiền tố URI cho Dynamic Links, hãy thực hiện việc này khi được nhắc.

   Nếu đã có tiền tố URI Dynamic Links, hãy ghi lại tiền tố đó. Bạn cần cung cấp tiền tố này khi tạo Dynamic Links theo phương thức lập trình.

   

3. Nên dùng: Chỉ định các mẫu URL được phép trong đường liên kết sâu và đường liên kết dự phòng. Bằng cách này, bạn sẽ ngăn các bên không được uỷ quyền tạo Dynamic Links chuyển hướng từ miền của bạn đến các trang web mà bạn không kiểm soát. Xem phần Cho phép các mẫu URL cụ thể.

4. Đả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.

   Xác nhận rằng dự án Firebase của bạn được định cấu hình đúng cách để sử dụng Dynamic Links trong ứng dụng iOS bằng cách mở tệp apple-app-site-association được lưu trữ trên miền Dynamic Links. Firebase sẽ phân phát tệp apple-app-site-association từ gốc của miền cũng như thư mục con .well-known Ví dụ:

       https://example.com/apple-app-site-association
       https://example.com/.well-known/apple-app-site-association
       

   Nếu ứng dụng của bạn được kết nối, 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":["/*"]}]}}

   Nếu thuộc tính 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.

Thêm Firebase vào ứng dụng

1. 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;
   // ...
         

2. Đị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];

3. 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()
         }
       }
     }
   }
         

Sử dụng bảng điều khiển Firebase

Nếu bạn muốn tạo một Dynamic Link duy nhất (cho mục đích thử nghiệm hoặc để nhóm tiếp thị của bạn dễ dàng tạo một đường liên kết có thể dùng trong một bài đăng trên mạng xã hội), thì cách đơn giản nhất là truy cập vào bảng điều khiển Firebase và tạo một đường liên kết theo cách thủ công bằng biểu mẫu từng bước.

Sử dụng API Trình tạo iOS

Bạn có thể sử dụng API Trình tạo iOS để tạo Dynamic Links từ các tham số hoặc để rút ngắn một Dynamic Link dài.

Tạo Dynamic Link từ các tham số

Để tạo Dynamic Link, hãy tạo một đối tượng DynamicLinkComponents mới và chỉ định các tham số Dynamic Link bằng cách đặt các thuộc tính tương ứng của đối tượng. Sau đó, lấy đường liên kết dài từ thuộc tính url của đối tượng hoặc lấy đường liên kết ngắn bằng cách gọi shorten().

Ví dụ tối thiểu sau đây tạo một Dynamic Link đến https://www.example.com/my-page mở bằng ứng dụng iOS của bạn trên iOS và ứng dụng com.example.android trên Android:

guard let link = URL(string: "https://www.example.com/my-page") else { return }
let dynamicLinksDomainURIPrefix = "https://example.com/link"
let linkBuilder = DynamicLinkComponents(link: link, domainURIPrefix: dynamicLinksDomainURIPRefix)
linkBuilder.iOSParameters = DynamicLinkIOSParameters(bundleID: "com.example.ios")
linkBuilder.androidParameters = DynamicLinkAndroidParameters(packageName: "com.example.android")

guard let longDynamicLink = linkBuilder.url else { return }
print("The long URL is: \(longDynamicLink)")

NSURL *link = [[NSURL alloc] initWithString:@"https://www.example.com/my-page"];
NSString *dynamicLinksDomainURIPrefix = @"https://example.com/link";
FIRDynamicLinkComponents *linkBuilder = [[FIRDynamicLinkComponents alloc]
                                         initWithLink:link
                                               domainURIPrefix:dynamicLinksDomainURIPrefix];
linkBuilder.iOSParameters = [[FIRDynamicLinkIOSParameters alloc]
                             initWithBundleID:@"com.example.ios"];
linkBuilder.androidParameters = [[FIRDynamicLinkAndroidParameters alloc]
                                 initWithPackageName:@"com.example.android"];

NSLog(@"The long URL is: %@", linkBuilder.url);

Để tạo một Dynamic Link ngắn, hãy tạo DynamicLinkComponents theo cùng một cách, sau đó gọi shorten().

Việc tạo một đường liên kết ngắn đòi hỏi phải có một lệnh gọi mạng. Vì vậy, thay vì trực tiếp trả về đường liên kết, shorten() sẽ chấp nhận một trình xử lý hoàn thành. Trình xử lý này được gọi khi yêu cầu hoàn tất. Ví dụ:

linkBuilder.shorten() { url, warnings, error in
  guard let url = url, error != nil else { return }
  print("The short URL is: \(url)")
}

[linkBuilder shortenWithCompletion:^(NSURL * _Nullable shortURL,
                                     NSArray<NSString *> * _Nullable warnings,
                                     NSError * _Nullable error) {
  if (error || shortURL == nil) { return; }
  NSLog(@"The short URL is: %@", shortURL);
}];
      

Theo mặc định, Dynamic Links được tạo bằng hậu tố đường liên kết gồm 17 ký tự. Điều này khiến người khác rất khó đoán được một Dynamic Link hợp lệ. Nếu trường hợp sử dụng của bạn không gây hại cho người khác khi đoán thành công một đường liên kết ngắn, thì bạn có thể muốn tạo các hậu tố chỉ dài khi cần thiết để đảm bảo tính duy nhất. Bạn có thể thực hiện việc này bằng cách đặt thuộc tính dynamicLinkComponentsOptions:

linkBuilder.options = DynamicLinkComponentsOptions()
linkBuilder.options.pathLength = .short
linkBuilder.shorten() { url, warnings, error in
  guard let url = url, error != nil else { return }
  print("The short URL is: \(url)")
}

linkBuilder.dynamicLinkComponentsOptions = [[FIRDynamicLinkComponentsOptions alloc] init];
linkBuilder.dynamicLinkComponentsOptions.pathLength = FIRShortDynamicLinkPathLengthShort;
[linkBuilder shortenWithCompletion:^(NSURL * _Nullable shortURL,
                                     NSArray<NSString *> * _Nullable warnings,
                                     NSError * _Nullable error) {
  if (error || shortURL == nil) { return; }
  NSLog(@"The short URL is: %@", shortURL);
}];
      

Dynamic Link tham số

Bạn có thể sử dụng API Trình tạo Dynamic Link để tạo Dynamic Links bằng bất kỳ tham số nào được hỗ trợ. Xem tài liệu tham khảo API để biết thông tin chi tiết.

Ví dụ sau đây tạo một Dynamic Link với một số tham số phổ biến được đặt:

guard let link = URL(string: "https://www.example.com/my-page") else { return }
let dynamicLinksDomainURIPrefix = "https://example.com/link"
let linkBuilder = DynamicLinkComponents(link: link, domainURIPRefix: dynamicLinksDomainURIPrefix)

linkBuilder.iOSParameters = DynamicLinkIOSParameters(bundleID: "com.example.ios")
linkBuilder.iOSParameters.appStoreID = "123456789"
linkBuilder.iOSParameters.minimumAppVersion = "1.2.3"

linkBuilder.androidParameters = DynamicLinkAndroidParameters(packageName: "com.example.android")
linkBuilder.androidParameters.minimumVersion = 123

linkBuilder.analyticsParameters = DynamicLinkGoogleAnalyticsParameters(source: "orkut",
                                                                       medium: "social",
                                                                       campaign: "example-promo")

linkBuilder.iTunesConnectParameters = DynamicLinkItunesConnectAnalyticsParameters()
linkBuilder.iTunesConnectParameters.providerToken = "123456"
linkBuilder.iTunesConnectParameters.campaignToken = "example-promo"

linkBuilder.socialMetaTagParameters = DynamicLinkSocialMetaTagParameters()
linkBuilder.socialMetaTagParameters.title = "Example of a Dynamic Link"
linkBuilder.socialMetaTagParameters.descriptionText = "This link works whether the app is installed or not!"
linkBuilder.socialMetaTagParameters.imageURL = "https://www.example.com/my-image.jpg"

guard let longDynamicLink = linkBuilder.url else { return }
print("The long URL is: \(longDynamicLink)")

NSURL *link = [[NSURL alloc] initWithString:@"https://www.example.com/my-page"];
NSString *dynamicLinksDomainURIPrefix = @"https://example.com/link";
FIRDynamicLinkComponents *linkBuilder = [[FIRDynamicLinkComponents alloc]
                                         initWithLink:link
                                         domainURIPrefix:dynamicLinksDomainURIPrefix];

linkBuilder.iOSParameters = [[FIRDynamicLinkIOSParameters alloc]
                             initWithBundleID:@"com.example.ios"];
linkBuilder.iOSParameters.appStoreID = @"123456789";
linkBuilder.iOSParameters.minimumAppVersion = @"1.2.3";

linkBuilder.androidParameters = [[FIRDynamicLinkAndroidParameters alloc]
                                 initWithPackageName:@"com.example.android"];
linkBuilder.androidParameters.minimumVersion = 123;

linkBuilder.analyticsParameters = [[FIRDynamicLinkGoogleAnalyticsParameters alloc]
                                   initWithSource:@"orkut"
                                           medium:@"social"
                                         campaign:@"example-promo"];

linkBuilder.iTunesConnectParameters = [[FIRDynamicLinkItunesConnectAnalyticsParameters alloc] init];
linkBuilder.iTunesConnectParameters.providerToken = @"123456";
linkBuilder.iTunesConnectParameters.campaignToken = @"example-promo";

linkBuilder.socialMetaTagParameters = [[FIRDynamicLinkSocialMetaTagParameters alloc] init];
linkBuilder.socialMetaTagParameters.title = @"Example of a Dynamic Link";
linkBuilder.socialMetaTagParameters.descriptionText = @"This link works whether the app is installed or not!";
linkBuilder.socialMetaTagParameters.imageURL = @"https://www.example.com/my-image.jpg";

NSLog(@"The long URL is: %@", linkBuilder.url);

Bạn có thể đặt các tham số Dynamic Link bằng các đối tượng và thuộc tính sau:

https://example.com/link
https://example.page.link

Rút ngắn một Dynamic Link dài

Để rút ngắn một Dynamic Link dài, hãy truyền Dynamic Link dài đến shortenURL(url:options:) cùng với đối tượng DynamicLinkComponentsOptions nếu bạn muốn tạo một đường liên kết có hậu tố ngắn:

DynamicLinkComponents.shortenURL(url: longLinkUrl, options: nil) { url, warnings, error in
  guard let url = url, error != nil else { return }
  print("The short URL is: \(url)")
}

[FIRDynamicLinkComponents shortenURL:longLinkUrl
                             options:nil
                          completion:^(NSURL * _Nullable shortURL,
                                       NSArray<NSString *> * _Nullable warnings,
                                       NSError * _Nullable error) {
  if (error || shortURL == nil) { return; }
  NSLog(@"The short URL is: %@", shortURL);
}];

Chỉ định lược đồ URL tuỳ chỉnh cho Dynamic Links

Theo mặc định, Dynamic Links sử dụng mã nhận dạng gói của ứng dụng làm lược đồ URL cần thiết để mở ứng dụng của bạn. Bạn nên giữ nguyên giá trị mặc định này để việc triển khai được đơn giản.

Tuy nhiên, những nhà phát triển đã sử dụng lược đồ URL tuỳ chỉnh cho các mục đích khác có thể muốn sử dụng cùng một lược đồ URL tuỳ chỉnh này cho Dynamic Links của họ. Nếu bạn đang ở trong tình huống này, bạn có thể chỉ định một lược đồ URL khác cho Firebase Dynamic Links bằng cách làm theo các bước sau:

1. Khi thiết lập ứng dụng, hãy nhớ chỉ định lược đồ URL mặc định mà ứng dụng của bạn sẽ sử dụng trước khi định cấu hình thực thể dùng chung FirebaseApp:

   Swift

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

   func application(_ application: UIApplication,
                    didFinishLaunchingWithOptions launchOptions: [UIApplication
                      .LaunchOptionsKey: Any]?) -> Bool {
     // Set deepLinkURLScheme to the custom URL scheme you defined in your
     // Xcode project.
     FirebaseOptions.defaultOptions()?.deepLinkURLScheme = customURLScheme
     FirebaseApp.configure()
   
     return true
   }

   Objective-C

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

   - (BOOL)application:(UIApplication *)application
       didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
     // Set deepLinkURLScheme to the custom URL scheme you defined in your
     // Xcode project.
     [FIROptions defaultOptions].deepLinkURLScheme = CUSTOM_URL_SCHEME;
     [FIRApp configure];
   
     return YES;
   }

2. Bất cứ khi nào tạo Dynamic Link, bạn sẽ cần chỉ định lược đồ URL tuỳ chỉnh mà ứng dụng của bạn sử dụng. Bạn có thể thực hiện việc này thông qua bảng điều khiển Firebase, đặt customScheme trong API Trình tạo, chỉ định tham số ius trong URL hoặc gửi tham số iosCustomScheme đến API REST

Các bước tiếp theo

Bây giờ bạn đã tạo Dynamic Links, bạn cần thiết lập ứng dụng để nhận Dynamic Links và gửi người dùng đến đúng vị trí trong ứng dụng sau khi người dùng mở các đường liên kết đó.

Để nhận Dynamic Links trong ứng dụng, hãy xem tài liệu dành cho iOS, Android, C++, và Unity.