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

Bạn có thể tạo các Đường liên kết động ngắn hoặc dài bằng API Trình tạo đường liên kết động của Firebase. API này chấp nhận một Liên kết động dài hoặc một đối tượng chứa Liên kết động tham số và trả về các URL như các 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 iOS của bạn dự án.

Thiết lập Firebase và SDK liên kết động

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

1. Trong Xcode, khi dự án ứng dụng của bạn đang mở, hãy chuyển đến Tệp > 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 Đường liên kết động.
4. Thêm cờ -ObjC vào mục 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 Đường liên kết động, 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 bạn. Bạn có thể hãy chọn thư viện không thu thập IDFA hoặc có thu thập IDFA.
6. Khi hoàn tất, Xcode sẽ tự động bắt đầu phân giải và tải xuống các phần phụ thuộc trong 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 của Firebase, hãy mở mục Đường liên kết động.

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 Liên kết động của bạn, hãy làm như vậy khi được nhắc.

   Nếu bạn đã có tiền tố URI Liên kết động, hãy ghi lại tiền tố đó. Bạn cần khi bạn tạo Liên kết động theo phương thức lập trình.

   

3. Đề xuất: 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 làm như vậy, bạn sẽ ngăn chặn các bên không được phép tạo Liên kết động chuyển hướng từ miền của bạn đến các trang web bạn không kiểm soát. Xem phần Cho phép cụ thể Mẫu URL.

4. Đảm bảo rằng Mã App Store và tiền tố Mã ứng dụng của bạn là được chỉ định trong phần cài đặt của ứng dụng. Để xem và chỉnh sửa các chế độ cài đặt của ứng dụng, hãy truy cập với dự án Firebase của bạn Cài đặt và chọn ứng dụng iOS của bạn.

   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 Liên kết động trong ứng dụng iOS của bạn bằng cách mở apple-app-site-association tệp được lưu trữ trên Miền Liên kết động. Firebase sẽ phân phát apple-app-site-association từ gốc của tệp cũng như thư mục con .well-known. Cho 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 tệp đối chiếu vào tiền tố Mã ứng dụng và mã 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ỹ xem bạn đã chỉ định chưa tiền tố Mã ứng dụng của bạn. Xin lưu ý rằng tiền tố Mã ứng dụng có thể không giống với Mã nhóm của bạn.

Thêm Firebase vào ứng dụng của bạn

1. Nhập mô-đun FirebaseCore trong UIApplicationDelegate cũng như bất kỳ tên nào khác Các mô-đun Firebase mà người được uỷ quyền sử dụng. Ví dụ: Cách sử dụng Cloud Firestore và Xác thực:

   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:):

   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 ứng dụng uỷ quyền và đính kèm nó đến cấu trúc App của bạn thông qua UIApplicationDelegateAdaptor hoặc NSApplicationDelegateAdaptor. Bạn cũng phải tắt tính năng uỷ quyền ứng dụng. Cho hãy xem hướng dẫn về SwiftUI để biết thêm thông tin.

   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 của Firebase

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

Sử dụng iOS Builder API

Bạn có thể sử dụng iOS Builder API để tạo Liên kết động từ các thông số hoặc để rút ngắn một Liên kết động dài.

Tạo Liên kết động từ các thông số

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

Ví dụ tối giản sau đây sẽ tạo một Liên kết động dài tới https://www.example.com/my-page mở cùng với ứng dụng iOS của bạn đang bật 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 Đường liên kết động ngắn, hãy tạo một DynamicLinkComponents theo cùng một cách rồi gọi shorten().

Việc tạo đường liên kết ngắn đòi hỏi phải có 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. đượ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, các Đường liên kết động ngắn được tạo kèm theo hậu tố của đường liên kết gồm 17 ký tự khiến ai đó khó đoán được Liên kết động hợp lệ. Nếu, đối với trường hợp sử dụng của bạn, sẽ không có hại nếu ai đó đoán được một đường liên kết ngắn, bạn có thể muốn tạo hậu tố chỉ khi cần thiết mà bạn có thể thực hiện 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);
}];
      

Thông số liên kết động

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

Ví dụ sau đây sẽ tạo một Đường liên kết động với một vài thông số phổ biến đặ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 thông số Liên kết động với 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 đường liên kết động dài

Để rút ngắn một Liên kết động dài, hãy chuyển Liên kết động dài tới shortenURL(url:options:) cùng với DynamicLinkComponentsOptions nếu bạn muốn tạo một 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 Đường liên kết động

Theo mặc định, Đường liên kết động sử dụng giá trị nhận dạng gói ứng dụng của bạn làm lược đồ URL cần thiết để mở . Bạn nên giữ nguyên giá trị mặc định này để đơn giản hoá quá trình triển khai.

Tuy nhiên, những nhà phát triển đang sử dụng lược đồ URL tuỳ chỉnh cho các mục đích khác có thể vẫn muốn sử dụng lược đồ URL tuỳ chỉnh tương tự này cho Đường liên kết động của họ. Nếu bạn rơi vào trường hợp này, bạn có thể chỉ định một lược đồ URL khác cho Liên kết động Firebase của bạn bằng cách làm theo các bước sau:

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

   Swift

   Lưu ý: Sản phẩm Firebase này không hoạt động trên các mục tiêu của 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 hoạt động trên các mục tiêu của 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. Mỗi khi tạo một Đường liên kết động bất kỳ, bạn sẽ cần chỉ định lược đồ URL tùy chỉnh mà bạn ứng dụng sử dụng. Bạn có thể thực hiện việc này thông qua bảng điều khiển của Firebase bằng cách đặt customScheme trong Builder API, chỉ định thông số ius trong URL của bạn hoặc gửi thông số iosCustomScheme đến API REST

Các bước tiếp theo

Giờ đây, bạn đã tạo Liên kết động, bạn cần thiết lập ứng dụng của mình để nhận Liên kết động và chuyển người dùng đến đúng vị trí trong ứng dụng của bạn sau khi người dùng mở các liên kết đó.

Để nhận được Liên kết động trong ứng dụng của bạn, hãy xem tài liệu cho iOS, Android, C++ và Unity.