Gérer les installations Firebase

Le service d'installations Firebase (FIS) fournit un ID d'installation Firebase (FID) pour chaque instance installée d'une application Firebase. L'ID d'installation Firebase est utilisé en interne par ces services Firebase:

Service Firebase Fonctionnalité d'installation Firebase
Firebase Cloud Messaging

Firebase Cloud Messaging utilise les ID d'installation Firebase pour cibler les appareils pour la diffusion des messages.

Firebase Crashlytics

Firebase Crashlytics fait pivoter l'UUID d'installation Crashlytics en fonction des modifications apportées à l'ID d'installation Firebase de l'instance d'application. À l'avenir, l'ID d'installation pourra être utilisé pour activer des fonctionnalités qui améliorent les services de gestion et de création de rapports sur les plantages.

Firebase In-App Messaging

Firebase In-App Messaging utilise les ID d'installation Firebase pour cibler les appareils pour la diffusion des messages.

Firebase Performance Monitoring

Performance Monitoring utilise les ID d'installation Firebase pour calculer le nombre d'installations Firebase uniques qui accèdent aux ressources réseau, afin de s'assurer que les modèles d'accès sont suffisamment anonymes. Il utilise également des ID d'installation Firebase avec Firebase Remote Config pour gérer le taux de création de rapports sur les événements de performances.

Firebase Remote Config

Remote Config utilise les ID d'installation Firebase pour sélectionner les valeurs de configuration à renvoyer aux appareils des utilisateurs finaux.

Firebase ML

Les identifiants appelés jetons d'authentification d'installation sont utilisés par Firebase ML pour l'authentification des appareils lors de l'interaction avec les instances d'application, par exemple pour distribuer des modèles de développeur aux instances d'application.

Stockage de segmentation des utilisateurs Firebase

Le stockage de la segmentation des utilisateurs de Firebase stocke les ID d'installation Firebase, ainsi que les attributs et segments associés, pour fournir des informations de ciblage aux autres services Firebase qui les utilisent.

En règle générale, les services Firebase utilisent le service d'installations Firebase sans que les développeurs aient besoin d'interagir directement avec l'API FIS. Toutefois, il peut arriver que les développeurs d'applications souhaitent appeler directement l'API FIS, par exemple:

  • Pour supprimer une installation Firebase et les données associées.
  • Pour récupérer des identifiants (ID d'installation Firebase) afin de cibler des installations d'applications spécifiques.
  • Pour récupérer des jetons d'authentification d'installation afin d'authentifier les installations Firebase.

Pour commencer à appeler directement l'API FIS, ajoutez le SDK à votre application.

Ajouter le SDK d'installations Firebase à votre application

iOS+

  1. Ajoutez la dépendance pour les installations Firebase à votre Podfile :
    pod 'FirebaseInstallations'
  2. Exécutez pod install et ouvrez le fichier .xcworkspace créé.
  3. Importez le module FirebaseCore dans votre UIApplicationDelegate, ainsi que tous les autres modules Firebase utilisés par votre délégué d'application. Par exemple, pour utiliser Cloud Firestore et Authentication:

    SwiftUI

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

    Swift

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objective-C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  4. Configurez une instance partagée FirebaseApp dans la méthode application(_:didFinishLaunchingWithOptions:) de votre délégué d'application:

    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];
  5. Si vous utilisez SwiftUI, vous devez créer un délégué d'application et l'associer à votre struct App via UIApplicationDelegateAdaptor ou NSApplicationDelegateAdaptor. Vous devez également désactiver le mélange des délégués d'application. Pour en savoir plus, consultez les instructions SwiftUI.

    SwiftUI

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

Android

Ajoutez la dépendance du SDK Android pour les installations Firebase à votre fichier Gradle (généralement app/build.gradle) de votre module (au niveau de l'application):

implementation 'com.google.firebase:firebase-installations:18.0.0'

JavaScript

Selon la façon dont votre application Web est hébergée, votre configuration peut être gérée automatiquement ou vous devrez peut-être mettre à jour votre objet de configuration Firebase.

Par exemple, si vos dépendances sont ajoutées dans index.html, ajoutez la dépendance dans l'élément <head> :

<script src="/__/firebase/11.0.2/firebase-installations.js"></script>

Flutter

  1. À partir du répertoire racine de votre projet Flutter, exécutez la commande suivante pour installer le plug-in d'installation Firebase:

    flutter pub add firebase_app_installations
    
  2. Recréez votre projet:

    flutter run
    
  3. Importez le plug-in d'installation Firebase:

    import 'package:firebase_app_installations/firebase_app_installations.dart';
    

Supprimer une installation Firebase

Les données associées à une installation Firebase ne permettent généralement pas d'identifier personnellement l'utilisateur. Il peut toutefois être utile de donner aux utilisateurs la possibilité de gérer et de supprimer ces données.

Les ID d'installation Firebase sont différents pour chaque installation de chaque application. Les différentes applications sur le même appareil ont des ID d'installation Firebase différents. Les ID d'installation Firebase identifient les installations d'applications et les données associées à ces installations.

Lorsque vous supprimez un ID d'installation, les données associées à cet ID d'installation sont supprimées des systèmes en ligne et de sauvegarde de tous les services Firebase qui utilisent des ID d'installation Firebase pour identifier les installations dans un délai de 180 jours. Ce processus est décrit dans les grandes lignes dans la déclaration de Google concernant la suppression et la conservation des données.

Sauf si vous désactivez tous les services générant un FID dans votre application, FIS crée un nouvel ID dans un délai de quelques jours. Firebase considère l'ID nouvellement créé comme une nouvelle installation Firebase et ne l'associe en aucun cas à l'ID ou aux données précédents.

Supprimer un FID avec un appel d'API client

Pour supprimer les FID générés par les services Firebase, appelez la méthode appropriée à partir du SDK d'installations Firebase:

Swift

do {
  try await Installations.installations().delete()
  print("Installation deleted");
} catch {
  print("Error deleting installation: \(error)")
}

Objective-C

[[FIRInstallations installations] deleteWithCompletion:^(NSError *error) {
   if (error != nil) {
     NSLog(@"Error deleting Installation %@", error);
     return;
   }
   NSLog(@"Installation deleted");
}];

Java

FirebaseInstallations.getInstance().delete()
        .addOnCompleteListener(new OnCompleteListener<Void>() {
    @Override
    public void onComplete(@NonNull Task<Void> task) {
        if (task.isSuccessful()) {
            Log.d("Installations", "Installation deleted");
        } else {
            Log.e("Installations", "Unable to delete Installation");
        }
    }
});

Kotlin+KTX

FirebaseInstallations.getInstance().delete().addOnCompleteListener { task ->
    if (task.isComplete) {
        Log.d("Installations", "Installation deleted")
    } else {
        Log.e("Installations", "Unable to delete Installation")
    }
}

JavaScript

await firebase.installations().delete();

Dart

await FirebaseInstallations.instance.delete();

Supprimer un FID avec un appel d'API de serveur

Pour supprimer un FID à l'aide d'un appel d'API de serveur, ajoutez le SDK Admin Firebase à votre serveur, si ce n'est pas déjà fait.

Une fois le SDK ajouté, supprimez les FID en appelant la fonction de suppression dans la langue de votre choix (remarque: à l'exception de Node.js, ces méthodes reflètent la dénomination des ID d'instance. Toutefois, ils suppriment tous le FID lorsqu'ils sont appelés avec un SDK Firebase actuel.

Node.js

// An FIDsent from a client service SDK
const idToDelete = 'eyJhbGciOiJFUzI1N_iIs5';

admin.installations().deleteInstallation(idToDelete);

Java

// An FID sent from a client service SDK
String idToDelete = "eyJhbGciOiJFUzI1N_iIs5";

FirebaseInstanceId.getInstance().deleteInstanceIdAsync(idToDelete).get();

Python

  from firebase_admin import instance_id

  # An FID sent from a client service SDK
  id_to_delete = 'eyJhbGciOiJFUzI1N_iIs5'

  instance_id.delete_instance_id(id_to_delete)

Accéder

client, err := app.InstanceId(ctx)
if err != nil {
  log.Fatalln("error initializing client", err)
}

iidToDelete := "eyJhbGciOiJFUzI1N_iIs5"
if err := client.DeleteInstanceId(ctx, iidToDelete); err != nil {
  log.Fatalln("error deleting FID", err)
}

Lorsque vous supprimez un ID d'installation Firebase à l'aide d'un appel d'API de serveur, les services Firebase lancent le processus de suppression des données associées à cet ID d'installation, cessent d'accepter de nouvelles données pour cet ID au cours de 1 à 2 jours, puis informent l'application cliente que l'ID a été supprimé. Tant que Firebase n'a pas informé l'application cliente, certains des services de l'application peuvent toujours cibler l'ID. Par exemple, une installation Firebase peut continuer à recevoir des notifications FCM pendant quelques heures.

Si vous souhaitez supprimer l'ID d'installation Firebase actuel et utiliser immédiatement les services Firebase avec un nouvel ID sans rapport, utilisez l'API client pour gérer la suppression.

Récupérer les identifiants client

Si vous devez identifier des installations particulières de votre application, vous pouvez le faire en récupérant l'ID d'installation Firebase. Par exemple, pour créer des segments d'installations d'applications à importer dans BigQuery ou pour effectuer des tests lors du développement de Firebase In-App Messaging, vous pouvez identifier et cibler les appareils appropriés à l'aide des ID d'installation Firebase correspondants.

Pour récupérer un ID d'installation Firebase:

Swift

do {
  let id = try await Installations.installations().installationID()
  print("Installation ID: \(id)")
} catch {
  print("Error fetching id: \(error)")
}

Objective-C

[[FIRInstallations installations] installationIDWithCompletion:^(NSString *identifier, NSError *error) {
  if (error != nil) {
    NSLog(@"Error fetching Installation ID %@", error);
    return;
  }
  NSLog(@"Installation ID: %@", identifier);
}];

Java

FirebaseInstallations.getInstance().getId()
        .addOnCompleteListener(new OnCompleteListener<String>() {
    @Override
    public void onComplete(@NonNull Task<String> task) {
        if (task.isSuccessful()) {
            Log.d("Installations", "Installation ID: " + task.getResult());
        } else {
            Log.e("Installations", "Unable to get Installation ID");
        }
    }
});

Kotlin+KTX

FirebaseInstallations.getInstance().id.addOnCompleteListener { task ->
    if (task.isSuccessful) {
        Log.d("Installations", "Installation ID: " + task.result)
    } else {
        Log.e("Installations", "Unable to get Installation ID")
    }
}

JavaScript

const installationId = await firebase.installations().getId();
console.log(installationId);

Dart

String id = await FirebaseInstallations.instance.getId();

Récupérer les jetons d'autorisation d'installation

Les services Firebase peuvent authentifier les installations Firebase à l'aide de jetons d'authentification récupérés dans FIS. Par exemple, lorsque vous concevez des tests A/B pour Remote Config, vous pouvez authentifier un appareil de test ciblé à l'aide d'un jeton d'autorisation d'installation.

Un jeton d'autorisation d'installation est un jeton de support de courte durée au format jeton Web JSON (JWT) contenant les informations suivantes pour une installation:

  • ID d'installation Firebase
  • Projet associé (projectNumber)
  • ID de l'application Firebase associé (appId)
  • Date d'expiration du jeton

Un jeton d'autorisation d'installation ne peut pas être révoqué et reste valide jusqu'à sa date d'expiration. La durée de vie par défaut du jeton est d'une semaine.

Pour récupérer un jeton d'authentification d'installation:

Swift

do {
  let result = try await Installations.installations()
    .authTokenForcingRefresh(true)
  print("Installation auth token: \(result.authToken)")
} catch {
  print("Error fetching token: \(error)")
}

Objective-C

[[FIRInstallations installations] authTokenForcingRefresh:true
                                               completion:^(FIRInstallationsAuthTokenResult *result, NSError *error) {
  if (error != nil) {
    NSLog(@"Error fetching Installation token %@", error);
    return;
  }
  NSLog(@"Installation auth token: %@", [result authToken]);
}];

Java

FirebaseInstallations.getInstance().getToken(/* forceRefresh */true)
        .addOnCompleteListener(new OnCompleteListener<InstallationTokenResult>() {
    @Override
    public void onComplete(@NonNull Task<InstallationTokenResult> task) {
        if (task.isSuccessful() && task.getResult() != null) {
            Log.d("Installations", "Installation auth token: " + task.getResult().getToken());
        } else {
            Log.e("Installations", "Unable to get Installation auth token");
        }
    }
});

Kotlin+KTX

val forceRefresh = true
FirebaseInstallations.getInstance().getToken(forceRefresh)
    .addOnCompleteListener { task ->
        if (task.isSuccessful) {
            Log.d("Installations", "Installation auth token: " + task.result?.token)
        } else {
            Log.e("Installations", "Unable to get Installation auth token")
        }
    }

JavaScript

const installationToken = await firebase.installations()
    .getToken(/* forceRefresh */ true);
console.log(installationToken);

Dart

String token = await FirebaseInstallations.instance.getToken();

Surveiller le cycle de vie des ID d'installation Firebase

Lors du fonctionnement normal d'une application, les ID d'installation (FID) Firebase ne nécessitent pas de surveillance particulière. Toutefois, les applications qui récupèrent et utilisent explicitement des FID doivent ajouter une logique pour surveiller la suppression ou la rotation potentielle du FID. Voici quelques cas où les FID peuvent être supprimés ou remplacés:

  • Désinstallation ou réinstallation de l'application, par exemple lorsqu'un utilisateur final l'installe sur un nouvel appareil.
  • L'utilisateur final vide le cache de l'application ou de l'appareil.
  • La suppression du FID est déclenchée dans le backend en raison de l'inactivité de l'application (actuellement, le seuil est de 270 jours d'inactivité).

Dans ce cas, un nouvel FID est attribué aux applications lorsque leur FID est supprimé ou qu'il est remplacé. De plus, le jeton d'autorisation d'installation associé à un FID supprimé est supprimé, quelle que soit sa propre maturité, et est remplacé par un nouveau jeton d'autorisation d'installation.

Les applications peuvent surveiller ces modifications et y répondre en conséquence.

Pour surveiller la rotation des FID:

Swift

installationIDObserver = NotificationCenter.default.addObserver(
        forName: .InstallationIDDidChange,
        object: nil,
        queue: nil
) { (notification) in
  // Fetch new Installation ID
  Task {
    await self.fetchInstallationToken()
  }
}

Objective-C

__weak __auto_type weakSelf = self;
self.installationIDObserver = [[NSNotificationCenter defaultCenter]
        addObserverForName: FIRInstallationIDDidChangeNotification
                    object:nil
                     queue:nil
                usingBlock:^(NSNotification * _Nonnull notification) {
    // Fetch new Installation ID
    [weakSelf fetchInstallationsID];
}];

Une NSNotification nommée NSNotificationName.InstallationIDDidChange est publiée dans le NSNotificationCenter par défaut chaque fois qu'un nouveau FID est attribué.

Android

Les clients Kotlin et Java doivent ajouter une logique de nouvelle tentative pour répondre aux appels ayant échoué afin de récupérer le nouveau FID.

JavaScript

Les applications Web peuvent s'abonner au hook onIdChange.

Chaque fois qu'un FID est créé, le rappel souscrit est déclenché:

await firebase.installations().onIdChange((newId) => {
  console.log(newId);
  // TODO: Handle new installation ID.
});

Dart

FirebaseInstallations.instance.onIdChange.listen((token) {
  print('FID token: $token');
});

Migrer de l'ID d'instance vers les installations Firebase

Avant l'introduction des installations Firebase, Firebase s'appuyait sur le SDK d'ID d'instance pour les identifiants des installations d'applications. Les installations Firebase offrent des avantages significatifs par rapport à l'ID d'instance en termes de fiabilité, de performances et de sécurité. Les applications Firebase qui dépendent du SDK Instance ID doivent migrer vers les installations Firebase.

Le processus de migration varie selon votre application:

  • Les applications qui n'appellent pas directement les API Instance ID peuvent migrer en mettant à jour leurs versions de SDK. La plupart des applications Firebase appartiennent à cette catégorie.

  • Les applications qui effectuent explicitement des appels d'API à l'ID d'instance doivent mettre à jour les versions du SDK et apporter des modifications au code pour remplacer les méthodes d'ID d'instance par leurs installations Firebase ou leurs équivalents FCM. Si votre application utilise l'ID d'instance pour récupérer des jetons d'enregistrement FCM ou utilise explicitement l'ID d'instance pour cibler des instances d'application ou à toute autre fin, vous devez mettre à jour le code de votre application.

Actuellement, FIS est rétrocompatible avec l'ancien identifiant Firebase Instance ID. La suppression d'un IID est une autre méthode permettant de demander la suppression de données avec ces SDK Firebase:

  • iOS 6.14.0 ou version antérieure
  • SDK Android antérieurs au 27 février 2020

Cela signifie que les applications ne sont pas obligatoires pour migrer vers les installations Firebase. Toutefois, il est vivement recommandé de le faire.

Passer à des versions minimales du SDK pour les installations Firebase

Pour passer de l'ID d'instance aux installations Firebase, assurez-vous que vos applications utilisent au moins les numéros de version minimale indiqués pour les SDK Firebase suivants:

SDK Firebase Version Android minimale Version minimale d'iOS
Firebase Cloud Messaging v20.3.0 v6.34.0
Remote Config v19.2.0 v6.24.0
Google Analytics pour Firebase (SDK de mesure) v17.4.4 v6.18.0
Messagerie dans l'application v19.0.7 v6.24.0
Performance Monitoring v19.0.8 v6.21.0
Crashlytics v17.2.1 v6.23.0
ML Kit v22.1.2 v6.28.0

Mettre à jour le code qui appelle explicitement les API Instance ID

Si votre application Android ou Apple utilise directement les méthodes du SDK Instance ID, vous pouvez remplacer cette utilisation par des alternatives identiques dans le SDK d'installation Firebase ou le SDK FCM.

Récupérer un identifiant

Les méthodes permettant d'obtenir des ID d'instance sont remplacées par des méthodes permettant d'obtenir un ID d'installation. Exemple :

Avant

Swift

Messaging.messaging().token { token, error in
  if let error = error {
    print("Error fetching remote FCM registration token: \(error)")
  } else if let token = token {
    print("Remote instance ID token: \(token)")
    self.remoteFCMTokenMessage.text = "Remote FCM registration token: \(token)"
  }
}

Objective-C

[[FIRMessaging messaging] tokenWithCompletion:^(NSString * _Nullable token, NSError * _Nullable error) {
   if (error != nil) {
     NSLog(@"Error fetching the remote FCM registration token: %@", error);
   } else {
     NSLog(@"Remote FCM registration token: %@", token);
     NSString* message =
       [NSString stringWithFormat:@"FCM registration token: %@", token];
     self.remoteFCMTokenMessage.text = message;
   }
 }];

Java

FirebaseInstanceId.getInstance().getInstanceId()
        .addOnCompleteListener(new OnCompleteListener<InstanceIdResult>() {
            @Override
            public void onComplete(@NonNull Task<InstanceIdResult> task) {
                Log.d("IID_TOKEN", task.getResult().getToken());
            }
        });

Kotlin+KTX

FirebaseInstanceId.getInstance().instanceId
        .addOnSuccessListener { result ->
            Log.d("IID_TOKEN", result.token)
        }

Après

Swift

do {
  let id = try await Installations.installations().installationID()
  print("Installation ID: \(id)")
} catch {
  print("Error fetching id: \(error)")
}

Objective-C

[[FIRInstallations installations] installationIDWithCompletion:^(NSString *identifier, NSError *error) {
  if (error != nil) {
    NSLog(@"Error fetching Installation ID %@", error);
    return;
  }
  NSLog(@"Installation ID: %@", identifier);
}];

Java

FirebaseInstallations.getInstance().getId()
        .addOnCompleteListener(new OnCompleteListener<String>() {
    @Override
    public void onComplete(@NonNull Task<String> task) {
        if (task.isSuccessful()) {
            Log.d("Installations", "Installation ID: " + task.getResult());
        } else {
            Log.e("Installations", "Unable to get Installation ID");
        }
    }
});

Kotlin+KTX

FirebaseInstallations.getInstance().id.addOnCompleteListener { task ->
    if (task.isSuccessful) {
        Log.d("Installations", "Installation ID: " + task.result)
    } else {
        Log.e("Installations", "Unable to get Installation ID")
    }
}

Supprimer un identifiant

Les méthodes permettant de supprimer des ID d'instance sont remplacées par des méthodes permettant de supprimer des ID d'installation Firebase. Exemple :

Avant

Swift

InstanceID.instanceID().deleteID { error in
  if let error = error {
    print("Error deleting instance ID: \(error)")
  }
}

Objective-C

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

Android

FirebaseInstanceId.deleteInstanceId();

Après

Swift

func delete(completion: @escaping (Error?) -> Void)

Objective-C

- (void)deleteWithCompletion:(nonnull void (^)(NSError *_Nullable))completion;

Java

FirebaseInstallations.getInstance().delete()
        .addOnCompleteListener(new OnCompleteListener<Void>() {
    @Override
    public void onComplete(@NonNull Task<Void> task) {
        if (task.isSuccessful()) {
            Log.d("Installations", "Installation deleted");
        } else {
            Log.e("Installations", "Unable to delete Installation");
        }
    }
});

Kotlin+KTX

FirebaseInstallations.getInstance().delete().addOnCompleteListener { task ->
    if (task.isComplete) {
        Log.d("Installations", "Installation deleted")
    } else {
        Log.e("Installations", "Unable to delete Installation")
    }
}

Récupérer un jeton d'enregistrement FCM

Avant l'introduction des installations Firebase, les clients FCM récupéraient les jetons d'enregistrement à partir de l'ID d'instance. Le SDK FCM fournit désormais des méthodes pour récupérer le jeton d'enregistrement.

Avant

Java

FirebaseInstanceId.getInstance().getInstanceId()
        .addOnCompleteListener(new OnCompleteListener<InstanceIdResult>() {
            @Override
            public void onComplete(@NonNull Task<InstanceIdResult> task) {
                if (!task.isSuccessful()) {
                    Log.w(TAG, "getInstanceId failed", task.getException());
                    return;
                }

                // Get new Instance ID token
                String token = task.getResult().getToken();

                // Log and toast
                String msg = getString(R.string.msg_token_fmt, token);
                Log.d(TAG, msg);
                Toast.makeText(MainActivity.this, msg, Toast.LENGTH_SHORT).show();
            }
        });

Kotlin+KTX

FirebaseInstanceId.getInstance().instanceId
        .addOnCompleteListener(OnCompleteListener { task ->
            if (!task.isSuccessful) {
                Log.w(TAG, "getInstanceId failed", task.exception)
                return@OnCompleteListener
            }

            // Get new Instance ID token
            val token = task.result?.token

            // Log and toast
            val msg = getString(R.string.msg_token_fmt, token)
            Log.d(TAG, msg)
            Toast.makeText(baseContext, msg, Toast.LENGTH_SHORT).show()
        })

Swift

Messaging.messaging().token { token, error in
  if let error = error {
    print("Error fetching remote FCM registration token: \(error)")
  } else if let token = token {
    print("Remote instance ID token: \(token)")
    self.remoteFCMTokenMessage.text = "Remote FCM registration token: \(token)"
  }
}

Objective-C

[[FIRMessaging messaging] tokenWithCompletion:^(NSString * _Nullable token, NSError * _Nullable error) {
   if (error != nil) {
     NSLog(@"Error fetching the remote FCM registration token: %@", error);
   } else {
     NSLog(@"Remote FCM registration token: %@", token);
     NSString* message =
       [NSString stringWithFormat:@"FCM registration token: %@", token];
     self.remoteFCMTokenMessage.text = message;
   }
 }];

Après

Java

FirebaseMessaging.getInstance().getToken()
    .addOnCompleteListener(new OnCompleteListener<String>() {
        @Override
        public void onComplete(@NonNull Task<String> task) {
          if (!task.isSuccessful()) {
            Log.w(TAG, "Fetching FCM registration token failed", task.getException());
            return;
          }

          // Get new FCM registration token
          String token = task.getResult();

          // Log and toast
          String msg = getString(R.string.msg_token_fmt, token);
          Log.d(TAG, msg);
          Toast.makeText(MainActivity.this, msg, Toast.LENGTH_SHORT).show();
        }
    });

Kotlin+KTX

FirebaseMessaging.getInstance().token.addOnCompleteListener(OnCompleteListener { task ->
    if (!task.isSuccessful) {
        Log.w(TAG, "Fetching FCM registration token failed", task.exception)
        return@OnCompleteListener
    }

    // Get new FCM registration token
    val token = task.result

    // Log and toast
    val msg = getString(R.string.msg_token_fmt, token)
    Log.d(TAG, msg)
    Toast.makeText(baseContext, msg, Toast.LENGTH_SHORT).show()
})

Swift

Messaging.messaging().token { token, error in
  if let error = error {
    print("Error fetching FCM registration token: \(error)")
  } else if let token = token {
    print("FCM registration token: \(token)")
    self.fcmRegTokenMessage.text  = "Remote FCM registration token: \(token)"
  }
}

Objective-C

[[FIRMessaging messaging] tokenWithCompletion:^(NSString *token, NSError *error) {
  if (error != nil) {
    NSLog(@"Error getting FCM registration token: %@", error);
  } else {
    NSLog(@"FCM registration token: %@", token);
    self.fcmRegTokenMessage.text = token;
  }
}];