Podane niżej przykłady pomogą Ci wdrożyć identyfikator instancji w kliencie iOS. Pamiętaj, że w tych przykładach korzystasz z zakresu GCM, którego używasz do zarządzania tokenami klienta na iOS na potrzeby Komunikacji w chmurze Firebase.
Skonfiguruj zależności CocoaPods
Do instalacji zależności i zarządzania nimi identyfikator instancji wykorzystuje CocoaPods. Otwórz okno terminala i przejdź do lokalizacji projektu Xcode Twojej aplikacji. Jeśli nie masz jeszcze pliku Podfile dla swojej aplikacji, utwórz go teraz:
pod init
Otwórz plik Podfile utworzony dla Twojej aplikacji i dodaj:
pod 'FirebaseInstanceId'
Zapisz plik i uruchom:
pod install
Spowoduje to utworzenie pliku .xcworkspace
dla aplikacji. Używaj go we wszystkich przyszłych procesach programowania aplikacji.
Generowanie tokena
Generowanie tokenów wymaga identyfikatora projektu wygenerowanego w 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) {
// ...
}];
Zarządzanie tokenami i identyfikatorami instancji
Identyfikator instancji pozwala usuwać i odświeżać tokeny.
Usuń tokeny i identyfikatory 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()
otrzymasz nowy identyfikator instancji:
[FIRInstanceID instanceID] deleteIDWithHandler:^(NSError *error) {
if error != nil {
NSLog(@"Error deleting instance ID: %@", error);
}
}];
Odśwież tokeny
Usługa identyfikatora instancji może tworzyć i ponownie generować tokeny. W takim przypadku
zostanie wysłane powiadomienie. Możesz odsłuchać powiadomienia, dodając
serwer obserwatora 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]
. Najnowszy token można pobrać, wywołując funkcję [[FIRInstanceID instanceID] token]
.
Pamiętaj, że do obserwowania generowania tokenów dla Komunikacji w chmurze dostępna jest konkretna delegacja.