Penerapan iOS

Contoh berikut akan membantu Anda menerapkan ID Instance pada klien iOS. Perlu diperhatikan bahwa contoh ini menggunakan cakupan GCM, yang dapat Anda gunakan untuk mengelola token bagi klien iOS untuk Firebase Cloud Messaging.

Menyiapkan dependensi CocoaPods Anda

ID Instance menggunakan CocoaPods untuk menginstal dan mengelola dependensi. Buka jendela terminal dan arahkan ke lokasi project Xcode untuk aplikasi Anda. Jika Anda belum membuat Podfile untuk aplikasi Anda, buat satu sekarang:

pod init

Buka Podfile yang dibuat untuk aplikasi Anda dan tambahkan hal berikut:

pod 'FirebaseInstanceId'

Simpan file dan jalankan:

pod install

Tindakan ini akan membuat file .xcworkspace untuk aplikasi Anda. Gunakan file ini untuk semua pengembangan aplikasi Anda pada masa mendatang.

Membuat token

Pembuatan token memerlukan ID Project yang dibuat oleh Google Developers Console.

NSString *authorizedEntity = PROJECT_ID;
String *scope = kFIRInstanceIDScopeFirebaseMessaging;
NSDictionary *options = @{
  @"apns_token" : <APNS Token data>,
  // 1 if APNS sandbox token else 0
  @"apns_sandbox" : @(1),
};
[[FIRInstanceID instanceID] tokenWithAuthorizedEntity:authorizedEntity
                                                scope:scope
                                              options:options
                                              handler:
                  ^(NSString * _Nullable token, NSError * _Nullable error) {
                      // ...
}];

Mengelola token dan ID Instance

ID Instance memungkinkan Anda menghapus dan memuat ulang token.

Menghapus token dan ID Instance

NSString *authorizedEntity = PROJECT_ID; // Project ID
String *scope = kFIRInstanceIDScopeFirebaseMessaging;
FIRInstanceIDDeleteTokenHandler handler = ^void(NSError *error) {
  if (error) {
    // Failed to delete the token. Check error and do an exponential
    // backoff to retry again.
  } else {
    // Successfully deleted the token.
  }
};
[[FIRInstanceID instanceID]
    deleteTokenWithAuthorizedEntity:authorizedEntity
                              scope:scope
                            handler:handler];

Anda juga dapat menghapus ID Instance itu sendiri. Dalam hal ini, jika Anda memanggil getInstance() di lain waktu, Anda akan mendapatkan ID Instance baru:

[FIRInstanceID instanceID] deleteIDWithHandler:^(NSError *error) {
      if error != nil {
        NSLog(@"Error deleting instance ID: %@", error);
      }
    }];

Token refresh

Layanan ID Instance dapat membuat atau membuat ulang token. Ketika ini terjadi, notifikasi akan dikirim. Anda dapat mendengarkan notifikasi ini dengan menambahkan pengamat untuk notifikasi yang bernama kFIRInstanceIDTokenRefreshNotification.

[[NSNotificationCenter defaultCenter] addObserver:self
         selector:@selector(tokenRefreshNotification:) 
         name:kFIRInstanceIDTokenRefreshNotification object:nil];

Observer ini harus dibuat sebelum token dibuat, misalnya sebelum memanggil [FIRApp configure]. Token terbaru dapat diambil dengan memanggil [[FIRInstanceID instanceID] token].

Perlu diperhatikan bahwa untuk mengamati pembuatan token untuk Cloud Messaging, tersedia delegasi tertentu.