Buat Tautan Dinamis di iOS

Anda dapat membuat Dynamic Links pendek atau panjang dengan Firebase Dynamic Links Builder API. API ini menerima Tautan Dinamis panjang atau objek yang berisi parameter Tautan Dinamis, dan mengembalikan URL seperti contoh berikut:

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

Prasyarat

Sebelum memulai, pastikan untuk menambahkan Firebase ke proyek iOS Anda .

Siapkan Firebase dan Dynamic Links SDK

Gunakan Swift Package Manager untuk menginstal dan mengelola dependensi Firebase.

1. Di Xcode, dengan proyek aplikasi Anda terbuka, arahkan ke File > Add Packages .
2. Saat diminta, tambahkan repositori SDK platform Apple Firebase:

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

3. Pilih pustaka Tautan Dinamis.
4. Untuk pengalaman optimal dengan Dynamic Links, sebaiknya aktifkan Google Analytics di project Firebase Anda dan tambahkan Firebase SDK untuk Google Analytics ke aplikasi Anda. Anda dapat memilih perpustakaan tanpa koleksi IDFA atau dengan koleksi IDFA.
5. Setelah selesai, Xcode akan secara otomatis mulai menyelesaikan dan mengunduh dependensi Anda di latar belakang.

Sekarang, lakukan beberapa langkah konfigurasi:

1. Di konsol Firebase, buka bagian Tautan Dinamis .

2. Jika Anda belum menyetujui persyaratan layanan dan menyetel awalan URI untuk Dynamic Links Anda, lakukan saat diminta.

   Jika Anda sudah memiliki prefiks URI Dynamic Links, catatlah. Anda harus menyediakannya saat membuat Tautan Dinamis secara terprogram.

   

3. Direkomendasikan : Tentukan pola URL yang diizinkan di tautan dalam dan tautan cadangan Anda. Dengan melakukannya, Anda mencegah pihak yang tidak berwenang membuat Tautan Dinamis yang mengalihkan dari domain Anda ke situs yang tidak Anda kontrol. Lihat Mengizinkan pola URL tertentu .

4. Pastikan ID App Store aplikasi dan awalan ID Aplikasi Anda ditentukan di setelan aplikasi. Untuk melihat dan mengedit setelan aplikasi Anda, buka halaman Setelan project Firebase Anda dan pilih aplikasi iOS Anda.

   Konfirmasikan bahwa project Firebase Anda dikonfigurasi dengan benar untuk menggunakan Dynamic Links di aplikasi iOS dengan membuka file apple-app-site-association yang dihosting di domain Dynamic Links Anda. Firebase akan menyajikan file apple-app-site-association dari root domain serta subdirektori .well-known . Sebagai contoh:

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

   Jika aplikasi Anda terhubung, file apple-app-site-association berisi referensi ke awalan ID Aplikasi dan ID bundel aplikasi Anda. Sebagai contoh:

   {"applinks":{"apps":[],"details":[{"appID":"1234567890.com.example.ios","paths":["/*"]}]}}

   Jika details properti kosong, periksa kembali apakah Anda telah menentukan awalan App ID Anda. Perhatikan bahwa awalan ID Aplikasi Anda mungkin tidak sama dengan ID Tim Anda.

Tambahkan Firebase ke aplikasi Anda

1. Impor modul FirebaseCore di UIApplicationDelegate Anda, serta modul Firebase lainnya yang digunakan oleh delegasi aplikasi Anda. Misalnya, untuk menggunakan Cloud Firestore dan Authentication:

   SwiftUI

   import SwiftUI
   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Cepat

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Objective-C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. Konfigurasikan instance bersama FirebaseApp dalam metode application(_:didFinishLaunchingWithOptions:) delegasi aplikasi Anda:

   SwiftUI

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Cepat

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Objective-C

   // Use Firebase library to configure APIs
   [FIRApp configure];

3. Jika Anda menggunakan SwiftUI, Anda harus membuat delegasi aplikasi dan melampirkannya ke struktur App Anda melalui UIApplicationDelegateAdaptor atau NSApplicationDelegateAdaptor . Anda juga harus menonaktifkan swizzling delegasi aplikasi. Untuk informasi selengkapnya, lihat petunjuk SwiftUI .

   SwiftUI

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

Gunakan konsol Firebase

Jika Anda ingin membuat satu Tautan Dinamis, baik untuk tujuan pengujian, atau untuk tim pemasaran agar mudah membuat tautan yang dapat digunakan dalam sesuatu seperti postingan media sosial, cara paling sederhana adalah dengan mengunjungi konsol Firebase dan membuatnya secara manual mengikuti formulir langkah demi langkah.

Gunakan iOS Builder API

Anda dapat menggunakan API Pembuat iOS untuk membuat Tautan Dinamis dari parameter, atau untuk mempersingkat Tautan Dinamis yang panjang.

Buat Tautan Dinamis dari parameter

Untuk membuat Dynamic Link, buat objek DynamicLinkComponents baru dan tentukan parameter Dynamic Link dengan menyetel properti objek yang sesuai. Kemudian, dapatkan tautan panjang dari properti url objek atau dapatkan tautan pendek dengan memanggil shorten() .

Contoh minimal berikut membuat Tautan Dinamis panjang ke https://www.example.com/my-page yang terbuka dengan aplikasi iOS Anda di iOS dan aplikasi com.example.android di 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);

Untuk membuat Dynamic Link singkat, buat DynamicLinkComponents dengan cara yang sama, lalu panggil shorten() .

Membuat tautan pendek memerlukan panggilan jaringan, jadi alih-alih mengembalikan tautan secara langsung, shorten() menerima penangan penyelesaian, yang dipanggil saat permintaan selesai. Sebagai contoh:

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

Secara default, Tautan Dinamis pendek dibuat dengan akhiran tautan 17 karakter yang membuatnya sangat tidak mungkin seseorang dapat menebak Tautan Dinamis yang valid. Jika, untuk kasus penggunaan Anda, tidak ada salahnya seseorang berhasil menebak tautan pendek, Anda mungkin lebih suka membuat sufiks yang hanya selama diperlukan untuk menjadi unik, yang dapat Anda lakukan dengan menyetel properti 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);
}];
      

Parameter Tautan Dinamis

Anda dapat menggunakan Dynamic Link Builder API untuk membuat Dynamic Links dengan salah satu parameter yang didukung. Lihat referensi API untuk detailnya.

Contoh berikut membuat Dynamic Link dengan beberapa kumpulan parameter umum:

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

Anda dapat menyetel parameter Dynamic Link dengan objek dan properti berikut:

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

Persingkat Tautan Dinamis yang panjang

Untuk memperpendek Dynamic Link yang panjang, teruskan Dynamic Link yang panjang ke shortenURL(url:options:) bersama dengan objek DynamicLinkComponentsOptions jika Anda ingin membuat link dengan akhiran pendek:

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

Menentukan skema URL khusus untuk Tautan Dinamis

Secara default, Dynamic Links menggunakan pengidentifikasi bundel aplikasi Anda sebagai skema URL yang diperlukan untuk membuka aplikasi Anda. Kami merekomendasikan untuk tetap menggunakan nilai default ini agar penerapan Anda tetap sederhana.

Namun, pengembang yang sudah menggunakan skema URL khusus untuk tujuan lain mungkin juga ingin menggunakan skema URL khusus yang sama untuk Tautan Dinamis mereka. Jika Anda berada dalam situasi ini, Anda dapat menentukan skema URL yang berbeda untuk Firebase Dynamic Links Anda dengan mengikuti langkah berikut:

1. Saat menyiapkan aplikasi, pastikan Anda menentukan skema URL default yang akan digunakan oleh aplikasi Anda sebelum mengonfigurasi instance bersama FirebaseApp :

   Cepat

   Catatan: Produk Firebase ini tidak tersedia di target macOS, Mac Catalyst, tvOS, atau 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

   Catatan: Produk Firebase ini tidak tersedia di target macOS, Mac Catalyst, tvOS, atau 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. Setiap kali Anda membuat Dynamic Link apa pun, Anda harus menentukan skema URL khusus yang digunakan aplikasi Anda. Anda dapat melakukannya melalui konsol Firebase, menyetel customScheme di Builder API, menentukan parameter ius di URL Anda, atau mengirim parameter iosCustomScheme ke REST API

Langkah selanjutnya

Setelah membuat Dynamic Links, Anda perlu menyiapkan aplikasi untuk menerima Dynamic Links dan mengarahkan pengguna ke tempat yang tepat di aplikasi Anda setelah pengguna membukanya.

Untuk menerima Tautan Dinamis di aplikasi Anda, lihat dokumentasi untuk iOS , Android , C++ , dan Unity .