Productos Casos de uso Precios Documentación Asistencia
Ir a la consola

Guía de migración del SDK de Admin

Las siguientes versiones de los SDK de Admin introducen una cantidad limitada de cambios:

  • Java SDK 6.0.0
  • Python SDK 3.0.0

El cambio con el impacto más amplio es la eliminación de la interfaz Task de Java, que se reemplaza por la interfaz ApiFuture.

Además, se realizarán cambios en estas funciones:

  • Especificación de las credenciales de autorización del SDK de Java
  • Configuración de los niveles de registro de Realtime Database
  • Creación de tokens personalizados y verificación de tokens de ID en Go

SDK de Admin Java (6.0.0)

Usa ApiFuture en lugar de Task

Se quitó la interfaz Task obsoleta. Si tu app utiliza esta interfaz, actualízala para que use la interfaz ApiFutures. Por ejemplo:

Antes

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

Después

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

// Or

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

Para obtener información detallada sobre este cambio con ejemplos de casos prácticos avanzados, consulta Operaciones asíncronas con el SDK de Admin Java.

Migra FirebaseCredentials a GoogleCredentials

FirebaseCredential y FirebaseCredentials ya no están disponibles. A fin de especificar credenciales de autorización para el SDK, usa GoogleCredentials. Por ejemplo:

Antes

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

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

Usa SLF4J para configurar el registro

La API de FirebaseDatabase.setLogLevel() ya no está disponible. Usa SLF4J directamente para configurar el registro del SDK completo.

Este cambio permite que ahora se pueda configurar el registro sin cambios de código. Para obtener más información, consulta Cómo registrarse en las bibliotecas de Java en Firebase y Google Cloud Platform.

Antes

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

Después

  • Agrega slf4j-simple.jar a la ruta de clase del proyecto.
  • Configura la propiedad del sistema -Dorg.slf4j.simpleLogger.defaultLogLevel=debug para JVM.
  • Consulta la documentación de SLF4J para obtener información sobre cómo usar otros marcos de trabajo de registro como Log4J y java.util.logging.

SDk de Admin Go 3.0.0

Cambios en auth.Client para Go

Los métodos CustomToken y CustomTokeWithClaims ahora consideran un argumento de contexto, como la mayoría de las API de Go existentes.

Antes

token, err := CustomToken("uid")

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

result, err := VerifyIDToken(idToken)

Después

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

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

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