Implementacja na iOS

Poniższe przykłady pomogą Ci wdrożyć identyfikator Instance ID w kliencie na iOS. Pamiętaj, że te przykłady używają zakresu GCM, który służy do zarządzania tokenami dla klienta iOS w Komunikacji w chmurze Firebase.

Konfigurowanie zależności CocoaPods

Identyfikator instancji używa CocoaPods do instalowania zależności i zarządzania nimi. Otwórz okno terminala i przejdź do lokalizacji projektu Xcode odpowiadającego Twojej aplikacji. Jeśli nie masz jeszcze pliku Podfile dla swojej aplikacji, utwórz go:

pod init

Otwórz plik Podfile utworzony dla aplikacji i dodaj:

pod 'FirebaseInstanceId'

Zapisz plik i uruchom:

pod install

Spowoduje to utworzenie pliku .xcworkspace dla Twojej aplikacji. Używaj tego pliku we wszystkich przyszłych procesach związanych z programowaniem aplikacji.

Generowanie tokena

Aby wygenerować tokeny, musisz mieć identyfikator projektu wygenerowany w Konsoli programistów Google.

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

Zarządzanie tokenami i identyfikatorami instancji

Identyfikator instancji umożliwia usuwanie i odświeżanie tokenów.

Usuwanie tokenów i identyfikatorów instancji

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

Możesz też usunąć sam identyfikator instancji. W takim przypadku przy następnym wywołaniu funkcji getInstance() zostanie wyświetlony nowy identyfikator instancji:

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

Tokeny odświeżania

Usługa Instance ID może tworzyć lub wygenerować ponownie tokeny. W takim przypadku otrzymasz powiadomienie. Możesz odsłuchać to powiadomienie, dodając obserwatora dla powiadomień o nazwie kFIRInstanceIDTokenRefreshNotification.

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

Ten obserwator musi zostać utworzony przed utworzeniem tokena, na przykład przed wywołaniem funkcji [FIRApp configure]. Ostatni token można pobrać, wywołując funkcję [[FIRInstanceID instanceID] token].

Pamiętaj, że do obserwowania generowania tokenów dla Cloud Messaging jest dostępny specjalny delegat.