Preguntas frecuentes y solución de problemas de Android y Firebase

Recibo un error que indica que no se pudo resolver o encontrar la biblioteca ktx.

Es probable que este error se deba a que usas Firebase BoM y especificas un módulo de KTX como dependencia de la biblioteca de productos.

En julio de 2025, dejamos de lanzar versiones nuevas de los módulos de KTX y retiramos las bibliotecas de KTX de la Firebase Android BoM (v34.0.0).

Si usas las APIs de KTX de los módulos de KTX previamente lanzados, te recomendamos que migres tu app para usar las APIs de KTX desde los módulos principales en su lugar. Para obtener más información, consulta las preguntas frecuentes sobre esta iniciativa.

¿Debo proporcionar una clave SHA‑1 cuando agrego una app para Android a un proyecto de Firebase?

Firebase Authentication (cuando se usa el Acceso con Google o el acceso con número de teléfono) y Firebase Dynamic Links requieren información de SHA-1. Si no usas estas funciones, no necesitas proporcionar una clave SHA-1.

¿Cómo resuelvo el error “Ya existe un cliente de OAuth2 para este nombre de paquete y clave SHA-1 en otro proyecto”?

Este error aparece si detectamos que otro proyecto de Firebase o Google Cloud contiene un ID de cliente de OAuth 2.0 con el nombre de paquete y la clave SHA-1 que especificaste. Obtén más información para resolver este error.

Cuando agrego Firebase a mi proyecto de Android, aparece un error del tipo “No se pudo encontrar”.

Por lo general, este error significa que a tu app le faltan una o más referencias al repositorio Maven de Google. Asegúrate de incluir el repositorio de Maven de Google (google()) en el archivo de configuración de Gradle.

• Si tu proyecto usa la sintaxis plugins, inclúyela en la sección plugins del archivo settings.gradle.kts o settings.gradle.
• Si tu proyecto usa la sintaxis buildscript, inclúyela en las secciones buildscript y allprojects en el archivo build.gradle.kts o build.gradle a nivel de proyecto.

El Acceso con Google muestra el error “12500:” después de lanzar mi app. ¿Cómo puedo solucionarlo?

Esto podría ocurrir por dos motivos: no proporcionaste un correo electrónico de asistencia o te falta una clave SHA. Para resolver este error, asegúrate de que todas estas condiciones sean verdaderas:

• Agregaste un correo electrónico de asistencia a la configuración general de tu proyecto en Firebase console.
• Agregaste la huella digital del certificado SHA-1 de tu almacén de claves de lanzamiento o producción a tu app de Firebase para Android en Firebase console (ve a settings Configuración del proyecto, desplázate hacia abajo hasta Tus apps y selecciona tu app para Android).
• Agregaste la huella digital del certificado SHA-1 de Google Play Console a la app de Firebase para Android en Firebase console (ve a settings Configuración del proyecto, desplázate hacia abajo hasta Tus apps y selecciona tu app para Android).

¿Cómo agregar complementos de Firebase a un proyecto de Android con la sintaxis buildscript?

Firebase tiene los siguientes complementos de Gradle:

A continuación, se muestra cómo agregar un complemento de Firebase a un proyecto de Android que aún usa la sintaxis buildscript:

1. En el archivo de Gradle (<project>/build.gradle.kts o <project>/build.gradle) de nivel de raíz (nivel de proyecto), agrega el complemento como una dependencia mediante las coordenadas de Maven:

   Kotlin

   buildscript {
   
       repositories {
         // Make sure that you have the following two repositories
         google()  // Google's Maven repository
         mavenCentral()  // Maven Central repository
       }
   
       dependencies {
         ...
   
         // Add the Maven coordinates and latest version of the plugin
         classpath ("PLUGIN_MAVEN_COORDINATES:PLUGIN_VERSION")
       }
   }
   
   allprojects {
     ...
   
     repositories {
       // Make sure that you have the following two repositories
       google()  // Google's Maven repository
       mavenCentral()  // Maven Central repository
     }
   }
   

   Groovy

   buildscript {
   
       repositories {
         // Make sure that you have the following two repositories
         google()  // Google's Maven repository
         mavenCentral()  // Maven Central repository
       }
   
       dependencies {
         ...
   
         // Add the Maven coordinates and latest version of the plugin
         classpath 'PLUGIN_MAVEN_COORDINATES:PLUGIN_VERSION'
       }
   }
   
   allprojects {
     ...
   
     repositories {
       // Make sure that you have the following two repositories
       google()  // Google's Maven repository
       mavenCentral()  // Maven Central repository
     }
   }
   

2. En el archivo de Gradle (generalmente <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle) de tu módulo (a nivel de app), agrega el complemento con su ID de complemento:

   Kotlin

   plugins {
       id("com.android.application")
   
       // Add the ID of the plugin
       id("FIREBASE_PLUGIN_ID")
       ...
   }
   

   Groovy

   plugins {
       id 'com.android.application'
   
       // Add the ID of the plugin
       id 'FIREBASE_PLUGIN_ID'
       ...
   }