Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Admin-SDK-Migrationsleitfaden

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

  • Java-SDK 6.0.0
  • Go SDK 3.0.0

Die Änderung mit den breitesten Auswirkungen ist die Entfernung von der Java - Task - Schnittstelle, die durch die ersetzt ApiFuture Schnittstelle.

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

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

Admin-Java-SDK (6.0.0)

Verwenden ApiFuture statt Task

Die veraltete Task - Schnittstelle wurde entfernt. Wenn Ihre App diese Schnittstelle verwendet, aktualisieren sie die verwenden ApiFutures stattdessen Schnittstelle. Zum Beispiel:

Vor

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

Nach

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

// Or

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

Für eine ausführliche Diskussion dieser Änderung mit erweiterten Anwendungsfallbeispiele finden Sie asynchrone Operationen mit Admin Java SDK .

Migrate FirebaseCredentials zu GoogleCredentials

FirebaseCredential und FirebaseCredentials sind nicht mehr verfügbar. Um Berechtigungsnachweise für das SDK angeben, verwendet GoogleCredentials statt. Zum Beispiel:

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 FirebaseDatabase.setLogLevel() API ist nicht mehr verfügbar. Verwenden SLF4J direkt zu konfigurieren Protokollierung für das gesamte SDK.

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

Vor

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

Nach

  • In slf4j-simple.jar das Projekt Classpath.
  • Stellen Sie die -Dorg.slf4j.simpleLogger.defaultLogLevel=debug Systemeigenschaft für die JVM.
  • Siehe SLF4J Dokumentation für Details über die Verwendung von anderem Logging - Frameworks wie Log4J und java.util.logging .

Admin Go SDK 3.0.0

Änderungen im auth.Client für Go

Die CustomToken und CustomTokeWithClaims Methoden nehmen nun ein Kontext Argument, wie die Mehrheit der bestehenden 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)