Firebase-Installationen verwalten

Der Firebase-Installationsdienst (FIS) stellt eine Firebase-Installations-ID (FID) für jede installierte Instanz einer Firebase-App bereit. Die Firebase-Installations-ID wird intern von diesen Firebase-Diensten verwendet:

Firebase-Dienst Firebase-Installationsfunktionalität
Firebase Cloud Messaging

Firebase Cloud Messaging verwendet Firebase-Installations-IDs, um Geräte für die Nachrichtenübermittlung auszuwählen.

Firebase Crashlytics

Firebase Crashlytics rotiert die Crashlytics-Installations-UUID basierend auf Änderungen an der Firebase-Installations-ID der App-Instanz. In Zukunft kann die Installations-ID verwendet werden, um Funktionen zu aktivieren, die Absturzberichte und Absturzverwaltungsdienste verbessern.

Firebase-In-App-Messaging

Firebase In-App Messaging verwendet Firebase-Installations-IDs, um Geräte für die Nachrichtenzustellung zu verwenden.

Firebase-Leistungsüberwachung

Die Leistungsüberwachung verwendet Firebase-Installations-IDs, um die Anzahl eindeutiger Firebase-Installationen zu berechnen, die auf Netzwerkressourcen zugreifen, um sicherzustellen, dass Zugriffsmuster ausreichend anonym sind. Es verwendet auch Firebase-Installations-IDs mit Firebase Remote Config, um die Rate der Leistungsereignisberichte zu verwalten.

Firebase-Remote-Konfiguration

Remote Config verwendet Firebase-Installations-IDs, um Konfigurationswerte auszuwählen, die an Endbenutzergeräte zurückgegeben werden sollen.

Firebase ML

Als Installationsauthentifizierungstoken bezeichnete Anmeldeinformationen werden von Firebase ML zur Geräteauthentifizierung bei der Interaktion mit App-Instanzen verwendet, um beispielsweise Entwicklermodelle an App-Instanzen zu verteilen.

Speicher für Firebase-Benutzersegmentierung

Firebase User Segmentation Storage speichert Firebase-Installations-IDs und zugehörige Attribute und Segmente, um Zielinformationen für andere Firebase-Dienste bereitzustellen, die sie verwenden.

In der Regel verwenden Firebase-Dienste den Firebase-Installationsdienst, ohne dass Entwickler direkt mit der FIS-API interagieren müssen. Es gibt jedoch Fälle, in denen App-Entwickler die FIS-API möglicherweise direkt aufrufen möchten, z. B.:

  • So löschen Sie eine Firebase-Installation und mit der Installation verknüpfte Daten.
  • Um Kennungen (Firebase-Installations-IDs) abzurufen, um auf bestimmte App-Installationen abzuzielen.
  • Zum Abrufen von Installationsauthentifizierungstoken zum Authentifizieren von Firebase-Installationen.

Um mit dem direkten Aufrufen der FIS-API zu beginnen, fügen Sie das SDK zu Ihrer App hinzu.

Fügen Sie Ihrer App das Firebase-Installations-SDK hinzu

iOS+

  1. Fügen Sie Ihrer Poddatei die Abhängigkeit für Firebase-Installationen hinzu: 
    pod 'FirebaseInstallations'
  2. Führen Sie pod install und öffnen Sie die erstellte .xcworkspace Datei.
  3. Importieren Sie das FirebaseCore Modul in Ihr UIApplicationDelegate sowie alle anderen Firebase-Module, die Ihr App-Delegierter verwendet. So verwenden Sie beispielsweise Cloud Firestore und Authentifizierung:

    SwiftUI

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

    Schnell

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Ziel c

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  4. Konfigurieren Sie eine freigegebene FirebaseApp Instanz in der Methode application(_:didFinishLaunchingWithOptions:) Ihres App-Delegaten:

    SwiftUI

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

    Schnell

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

    Ziel c

    // Use Firebase library to configure APIs
[FIRApp configure];
  5. Wenn Sie SwiftUI verwenden, müssen Sie einen Anwendungsdelegaten erstellen und ihn über UIApplicationDelegateAdaptor oder NSApplicationDelegateAdaptor an Ihre App Struktur anfügen. Sie müssen auch das Swizzling von App-Delegaten deaktivieren. Weitere Informationen finden Sie in den SwiftUI-Anweisungen .

    SwiftUI

    @main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}

Android

Fügen Sie die Abhängigkeit für das Android SDK für Firebase-Installationen zu Ihrer Modul-Gradle-Datei (auf App-Ebene) hinzu (normalerweise app/build.gradle ):

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

JavaScript

Je nachdem, wie Ihre Webanwendung gehostet wird, wird Ihre Konfiguration möglicherweise automatisch verarbeitet oder Sie müssen Ihr Firebase-Konfigurationsobjekt aktualisieren .

Wenn Ihre Abhängigkeiten beispielsweise in index.html hinzugefügt werden, fügen Sie die Abhängigkeit im <head>-Element hinzu:

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

Flattern

  1. Führen Sie im Stammverzeichnis Ihres Flutter-Projekts den folgenden Befehl aus, um das Firebase-Installations-Plugin zu installieren:

    flutter pub add firebase_app_installations

  2. Erstellen Sie Ihr Projekt neu:

    flutter run

  3. Importieren Sie das Firebase-Installations-Plugin:

    import 'package:firebase_app_installations/firebase_app_installations.dart';

Löschen Sie eine Firebase-Installation

Daten, die mit einer Firebase-Installation verbunden sind, sind im Allgemeinen nicht persönlich identifizierend. Dennoch kann es hilfreich sein, Benutzern die Möglichkeit zu geben, diese Daten zu verwalten und zu löschen.

Firebase-Installations-IDs sind für jede Installation jeder Anwendung unterschiedlich. Verschiedene Anwendungen auf demselben Gerät haben unterschiedliche Firebase-Installations-IDs. Firebase-Installations-IDs identifizieren App-Installationen und Daten, die mit diesen App-Installationen verknüpft sind.

Wenn Sie eine Installations-ID löschen, werden die mit dieser Installations-ID verknüpften Daten innerhalb von 180 Tagen aus Live- und Backup-Systemen aller Firebase-Dienste entfernt, die Firebase-Installations-IDs verwenden, um Installationen zu identifizieren. Dieser Vorgang wird in der Google- Erklärung zu Löschung und Aufbewahrung allgemein beschrieben.

Sofern Sie nicht alle FID-erzeugenden Dienste in Ihrer App deaktivieren, erstellt FIS innerhalb weniger Tage eine neue ID. Firebase betrachtet die neu erstellte ID als eine neue Firebase-Installation und verknüpft sie in keiner Weise mit der vorherigen ID oder Daten.

Löschen Sie eine FID mit einem Client-API-Aufruf

Um von Firebase-Diensten generierte FIDs zu löschen, rufen Sie die entsprechende Methode aus dem Firebase-Installations-SDK auf:

Schnell

Installations.installations().delete { error in
  if let error = error {
    print("Error deleting installation: \(error)")
    return
  }
  print("Installation deleted");
}
AppDelegate.swift

Ziel c

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

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");
        }
    }
});
MainActivity.java

Kotlin+KTX

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

JavaScript

await firebase.installations().delete();
index.js

Dart

await FirebaseInstallations.instance.delete();

Löschen Sie eine FID mit einem Server-API-Aufruf

Um eine FID mit einem Server-API-Aufruf zu löschen, fügen Sie das Firebase Admin SDK zu Ihrem Server hinzu , falls noch nicht geschehen.

Sobald das SDK hinzugefügt wurde, löschen Sie FIDs durch einen Aufruf der Löschfunktion in der Sprache Ihrer Wahl (Hinweis: Mit Ausnahme von Node.js spiegeln diese Methoden die Instanz-ID-Benennung wider. Sie alle löschen jedoch tatsächlich die FID, wenn sie mit einer aktuellen Firebase aufgerufen werden SDK).

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)

Gehen

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

Wenn Sie eine Firebase-Installations-ID mit einem Server-API-Aufruf löschen, starten die Firebase-Dienste den Prozess zum Löschen der mit dieser Installations-ID verknüpften Daten, akzeptieren im Laufe von 1–2 Tagen keine neuen Daten für diese ID und benachrichtigen dann die Client-App dass die ID gelöscht wurde. Bis Firebase die Client-App benachrichtigt, können einige der Dienste der App weiterhin auf die ID abzielen – beispielsweise kann eine Firebase-Installation weiterhin FCM-Benachrichtigungen für einige Stunden erhalten.

Wenn Sie die aktuelle Firebase-Installations-ID löschen und sofort Firebase-Dienste mit einer neuen, nicht verwandten ID verwenden möchten, verwenden Sie die Client-API, um die Löschung zu verarbeiten.

Abrufen von Client-IDs

Wenn Sie bestimmte Installationen Ihrer App identifizieren müssen, können Sie dies tun, indem Sie die Firebase-Installations-ID abrufen. Um beispielsweise Tests während der Entwicklung von Firebase In-App Messaging durchzuführen, können Sie das richtige Testgerät anhand seiner Firebase-Installations-ID identifizieren und darauf abzielen.

So rufen Sie eine Firebase-Installations-ID ab:

Schnell

Installations.installations().installationID { (id, error) in
  if let error = error {
    print("Error fetching id: \(error)")
    return
  }
  guard let id = id else { return }
  print("Installation ID: \(id)")
}
AppDelegate.swift

Ziel c

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

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");
        }
    }
});
MainActivity.java

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")
    }
}
MainActivity.kt

JavaScript

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

Dart

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

Rufen Sie Installations-Authentifizierungstoken ab

Firebase-Dienste können Firebase-Installationen mit Authentifizierungstoken authentifizieren, die von FIS abgerufen werden. Wenn Sie beispielsweise A/B-Tests für Remote Config entwerfen, können Sie ein gezieltes Testgerät mit einem Installations-Authentifizierungstoken authentifizieren.

Ein Installations-Authentifizierungstoken ist ein kurzlebiges Bearer-Token im JSON-Web-Token-Format (JWT), das die folgenden Informationen für eine Installation enthält:

  • Die Firebase-Installations-ID
  • Das zugehörige Projekt ( projectNumber )
  • Die zugeordnete Firebase-Anwendungs-ID ( appId )
  • Das Ablaufdatum des Tokens

Ein Installations-Authentifizierungstoken kann nicht widerrufen werden und bleibt bis zu seinem Ablaufdatum gültig. Die Standardlebensdauer des Tokens beträgt eine Woche.

So rufen Sie ein Installations-Authentifizierungstoken ab:

Schnell

Installations.installations().authTokenForcingRefresh(true, completion: { (result, error) in
  if let error = error {
    print("Error fetching token: \(error)")
    return
  }
  guard let result = result else { return }
  print("Installation auth token: \(result.authToken)")
})
AppDelegate.swift

Ziel 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]);
}];
ObjCSnippets.m

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");
        }
    }
});
MainActivity.java

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")
        }
    }
MainActivity.kt

JavaScript

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

Dart

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

Überwachen Sie den Lebenszyklus der Firebase-Installations-ID

Während des normalen Betriebs einer App müssen Firebase-Installations-IDs (FIDs) nicht speziell überwacht werden. Apps, die FIDs explizit abrufen und verwenden, sollten jedoch Logik hinzufügen, um das potenzielle Löschen oder Rotieren der FID zu überwachen. Hier sind einige Fälle, in denen FIDs gelöscht oder rotiert werden könnten:

  • Deinstallation oder Neuinstallation der App, beispielsweise wenn ein Endbenutzer auf einem neuen Gerät installiert.
  • Der Endbenutzer löscht den Cache der App oder des Geräts.
  • Die FID-Löschung wird im Backend aufgrund von App-Inaktivität ausgelöst (derzeit liegt die Schwelle dafür bei 270 Tagen Inaktivität).

Wenn Apps in solchen Fällen eine FID-Rotation oder -Löschung erfahren, wird ihnen eine neue FID zugewiesen. Außerdem wird das einer gelöschten FID zugeordnete Installations-Authentifizierungstoken unabhängig von seiner eigenen Fälligkeit gelöscht und durch ein neues Installations-Authentifizierungstoken ersetzt.

Apps können diese Änderungen überwachen und entsprechend reagieren.

So überwachen Sie die FID-Rotation:

Schnell

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

Ziel 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];
}];
ObjCSnippets.m

Eine NSNotification mit dem Namen NSNotificationName.InstallationIDDidChange wird immer dann an das Standard-NSNotificationCenter gesendet, wenn eine neue FID zugewiesen wird.

Android

Kotlin- und Java-Clients sollten Wiederholungslogik hinzufügen, um auf fehlgeschlagene Aufrufe zum Abrufen der neuen FID zu reagieren.

JavaScript

Web-Apps können den onIdChange Hook abonnieren.

Immer wenn eine neue FID erstellt wird, wird der abonnierte Callback ausgelöst:

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

Dart

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

Migrieren Sie von Instanz-ID zu Firebase-Installationen

Vor der Einführung von Firebase-Installationen verließ sich Firebase auf das Instanz-ID-SDK für Kennungen von App-Installationen. Firebase-Installationen bieten gegenüber der Instanz-ID erhebliche Vorteile in Bezug auf Zuverlässigkeit, Leistung und Sicherheit. Firebase-Apps, die vom Instanz-ID-SDK abhängen, sollten zu Firebase-Installationen migriert werden.

Der Migrationsprozess ist je nach App unterschiedlich:

  • Apps, die Instanz-ID-APIs nicht direkt aufrufen, können migrieren, indem sie ihre SDK-Versionen aktualisieren . Die meisten Firebase-Apps fallen in diese Kategorie.

  • Apps, die API-Aufrufe explizit an die Instanz-ID senden, müssen die SDK-Versionen aktualisieren und Codeänderungen vornehmen , um die Instanz-ID-Methoden durch ihre Firebase-Installationen oder FCM-Äquivalente zu ersetzen. Wenn Ihre App die Instanz-ID verwendet, um FCM-Registrierungstoken abzurufen, oder die Instanz-ID explizit verwendet, um auf App-Instanzen oder für andere Zwecke abzuzielen, müssen Sie Ihren Anwendungscode aktualisieren.

Derzeit ist FIS abwärtskompatibel mit der Legacy-ID Firebase Instance ID. Das Löschen einer IID ist eine alternative Methode zum Anfordern der Datenlöschung mit diesen Firebase SDKs:

  • iOS 6.14.0 und niedriger
  • Android SDKs vor dem 27. Februar 2020

Das bedeutet, dass Apps nicht zu Firebase-Installationen migrieren müssen ; dies wird jedoch dringend empfohlen.

Upgrade auf SDK-Mindestversionen für Firebase-Installationen

Um von Instanz-ID- zu Firebase-Installationen zu migrieren, stellen Sie sicher, dass Ihre Anwendungen mindestens die aufgeführten Mindestversionsnummern der folgenden Firebase-SDKs verwenden:

Firebase-SDK Minimale Android-Version Minimale iOS-Version
Firebase Cloud Messaging v20.3.0 v6.34.0
Remote-Konfig v19.2.0 v6.24.0
Google Analytics für Firebase \ (Messungs-SDK) v17.4.4 v6.18.0
In-App-Messaging v19.0.7 v6.24.0
Leistungsüberwachung v19.0.8 v6.21.0
Crashlytics v17.2.1 v6.23.0
ML-Kit v22.1.2 v6.28.0

Aktualisieren von Code, der explizit Instanz-ID-APIs aufruft

Wenn Ihre Android- oder Apple-App direkt Instanz-ID-SDK-Methoden verwendet, können Sie diese Verwendung durch identische Alternativen im Firebase-Installations-SDK oder im FCM-SDK ersetzen.

Abrufen einer Kennung

Methoden zum Abrufen von Instanz-IDs werden durch Methoden zum Abrufen einer Installations-ID ersetzt. Zum Beispiel:

Vor

Schnell

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)"
  }
}

Ziel 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)
        }

Nach

Schnell

Installations.installations().installationID { (id, error) in
  if let error = error {
    print("Error fetching id: \(error)")
    return
  }
  guard let id = id else { return }
  print("Installation ID: \(id)")
}
AppDelegate.swift

Ziel c

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

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");
        }
    }
});
MainActivity.java

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")
    }
}
MainActivity.kt

Löschen einer Kennung

Methoden zum Löschen von Instanz-IDs werden durch Methoden zum Löschen von Firebase-Installations-IDs ersetzt. Zum Beispiel:

Vor

Schnell

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

Ziel c

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

Android

FirebaseInstanceId.deleteInstanceId();

Nach

Schnell

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

Ziel 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");
        }
    }
});
MainActivity.java

Kotlin+KTX

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

Abrufen eines FCM-Registrierungstokens

Vor der Einführung von Firebase-Installationen haben FCM-Clients Registrierungstoken von der Instanz-ID abgerufen. Jetzt bietet das FCM SDK Methoden zum Abrufen des Registrierungstokens.

Vor

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()
        })

Schnell

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)"
  }
}

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

Nach

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()
})

Schnell

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)"
  }
}

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