Admin SDK-Migrationsanleitung

Die folgenden Versionen der Admin-SDKs führen eine begrenzte Anzahl von Breaking Changes ein:

  • Java-SDK 6.0.0
  • Wechseln Sie zu SDK 3.0.0

Die Änderung mit der größten Breitenwirkung ist die Entfernung der Java Task -Schnittstelle, die durch die ApiFuture -Schnittstelle ersetzt wird.

Darüber hinaus gibt es Änderungen an diesen Funktionen:

  • Berechtigungsnachweise für das Java SDK angeben
  • Protokollebenen der Echtzeitdatenbank konfigurieren
  • Erstellen benutzerdefinierter Token und Überprüfen von ID-Token in Go

Admin-Java-SDK (6.0.0)

Verwenden Sie ApiFuture anstelle von Task

Die veraltete Task wurde entfernt. Wenn Ihre App diese Schnittstelle verwendet, aktualisieren Sie sie so, dass sie stattdessen die ApiFutures Schnittstelle verwendet. Beispielsweise:

Vor

Task<String> customToken = FirebaseAuth.getInstance()
    .createCustomToken("uid");

Nach

String customToken = FirebaseAuth.getInstance()
    .createCustomToken("uid");

// Or

ApiFuture<String> customToken = FirebaseAuth.getInstance()
    .createCustomTokenAsync("uid");

Eine ausführliche Erläuterung dieser Änderung mit erweiterten Anwendungsbeispielen finden Sie unter Asynchronous Operations with Admin Java SDK .

Migrieren Sie FirebaseCredentials zu GoogleCredentials

FirebaseCredential und FirebaseCredentials sind nicht mehr verfügbar. Verwenden Sie stattdessen GoogleCredentials , um Autorisierungsdaten für das SDK anzugeben. Beispielsweise:

Vor

FirebaseCredential credential = FirebaseCredentials.fromCertificate(stream);
FirebaseOptions options = new FirebaseOptions.Builder()
    .setCredential(credential)
    .build();

FirebaseCredential credential = FirebaseCredentials.applicationDefault();
FirebaseOptions options = new FirebaseOptions.Builder()
    .setCredential(credential)
    .build();

Nach

GoogleCredentials credentials = GoogleCredentials.fromStream(stream);
FirebaseOptions options = new FirebaseOptions.Builder()
    .setCredentials(credentials)
    .build();

GoogleCredentials credentials = GoogleCredentials.getApplicationDefault();
FirebaseOptions options = new FirebaseOptions.Builder()
    .setCredentials(credentials)
    .build();

Verwenden Sie SLF4J, um die Protokollierung zu konfigurieren

Die API FirebaseDatabase.setLogLevel() ist nicht mehr verfügbar. Verwenden Sie SLF4J direkt, um die Protokollierung für das gesamte SDK zu konfigurieren.

Diese Änderung bedeutet, dass die Protokollierung jetzt ohne Codeänderungen konfiguriert werden kann. Weitere Informationen finden Sie unter Protokollieren in Java-Bibliotheken für Firebase und Google Cloud .

Vor

FirebaseDatabase.getInstance()
 .setLogLevel(Logger.Level.DEBUG);

Nach

  • Fügen Sie slf4j-simple.jar zum Klassenpfad des Projekts hinzu.
  • Legen Sie die -Dorg.slf4j.simpleLogger.defaultLogLevel=debug für die JVM fest.
  • Einzelheiten zur Verwendung anderer Protokollierungsframeworks wie Log4J und java.util.logging finden Sie in der SLF4J-Dokumentation.

Admin Go-SDK 3.0.0

Änderungen in auth.Client für Go

Die Methoden CustomToken und CustomTokeWithClaims verwenden jetzt ein Kontextargument, wie die meisten vorhandenen Go-APIs.

Vor

token, err := CustomToken("uid")

token, err := CustomToken("uid", claimsMap)

result, err := VerifyIDToken(idToken)

Nach

token, err := CustomToken(context.Background(), "uid")

token, err := CustomTokenWithClaims(context.Background(), "uid", claimsMap)

result, err := VerifyIDToken(context.Background(), idToken)