Guide de migration du SDK d'administration

Les versions suivantes des SDK Admin introduisent un nombre limité de modifications avec rupture :

  • SDK Java 6.0.0
  • Passez au SDK 3.0.0

Le changement ayant l'impact le plus large est la suppression de l'interface Java Task , qui est remplacée par l'interface ApiFuture .

De plus, des modifications ont été apportées à ces fonctionnalités :

  • Spécification des identifiants d'autorisation pour le SDK Java
  • Configuration des niveaux de journalisation de la base de données en temps réel
  • Création de jetons personnalisés et vérification des jetons d'identification dans Go

SDK Java d'administration (6.0.0)

Utiliser ApiFuture au lieu de Task

L'interface de Task obsolète a été supprimée. Si votre application utilise cette interface, mettez-la à jour pour utiliser l'interface ApiFutures à la place. Par example:

Avant de

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

Après

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

// Or

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

Pour une discussion détaillée de cette modification avec des exemples de cas d'utilisation avancés, consultez Opérations asynchrones avec Admin Java SDK .

Migrer FirebaseCredentials vers GoogleCredentials

FirebaseCredential et FirebaseCredentials ne sont plus disponibles. Pour spécifier les identifiants d'autorisation pour le SDK, utilisez plutôt GoogleCredentials . Par example:

Avant de

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

Après

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

Utiliser SLF4J pour configurer la journalisation

L'API FirebaseDatabase.setLogLevel() n'est plus disponible. Utilisez SLF4J directement pour configurer la journalisation pour l'ensemble du SDK.

Cette modification signifie que la journalisation peut désormais être configurée sans modification du code. Pour plus d'informations, consultez Journalisation dans les bibliothèques Java pour Firebase et Google Cloud .

Avant de

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

Après

  • Ajoutez slf4j-simple.jar au chemin de classe du projet.
  • Définissez la propriété système -Dorg.slf4j.simpleLogger.defaultLogLevel=debug pour la JVM.
  • Reportez-vous à la documentation SLF4J pour plus de détails sur l'utilisation d'autres infrastructures de journalisation telles que Log4J et java.util.logging .

Admin Go SDK 3.0.0

Changements dans auth.Client pour Go

Les méthodes CustomToken et CustomTokeWithClaims prennent désormais un argument de contexte, comme la majorité des API Go existantes.

Avant de

token, err := CustomToken("uid")

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

result, err := VerifyIDToken(idToken)

Après

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

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

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