Información sobre Firebase para Android

A medida que desarrollas tu proyecto de Android con Firebase, es posible que encuentres conceptos que no conoces o son específicos de Firebase. Esta página tiene como objetivo responder esas preguntas o dirigirte a recursos para obtener más información.

Si tienes preguntas sobre un tema que no se aborda en esta página, no dudes en visitar una de nuestras comunidades en línea. Además, actualizaremos esta página con temas nuevos de forma periódica. Vuelve a consultarla para ver si agregamos el tema sobre el que deseas aprender.

Complemento de Firebase Assistant para Android Studio

Firebase Assistant es un complemento de Android Studio que registra tu app para Android con un proyecto de Firebase y agrega los archivos de configuración, los complementos y las dependencias de Firebase necesarios al proyecto de Android, todo desde Android Studio.

Sigue las instrucciones de la página de introducción de Android para usar Firebase Assistant. Asegúrate de usar las versiones más actualizadas de Android Studio y Firebase Assistant (ve a Archivo > Buscar actualizaciones).

Cuando seleccionas productos específicos de Firebase para agregar a tu app, Firebase Assistant declara automáticamente las dependencias requeridas en tu archivo app/build.gradle. Sin embargo, para usar funciones de Firebase que superen las capacidades actuales de Firebase Assistant, recomendamos que realices algunos cambios manuales en estas dependencias:

Si deseas usar la Firebase Android BoM, actualiza las dependencias en el archivo Gradle (generalmente, app/build.gradle) del módulo (nivel de app) para importar la plataforma BoM. Además, debes quitar las versiones de cada línea de dependencia de biblioteca de Firebase.
Si deseas usar una biblioteca de extensiones de Kotlin, debes modificar la línea de dependencia agregada a tu archivo Gradle (generalmente, app/build.gradle) del módulo (nivel de app) para usar la versión ktx de la biblioteca de Firebase.

Servicios de Google: archivo de configuración y complemento

Como parte de agregar Firebase a tu proyecto de Android, debes agregar el complemento de google-services y un archivo de configuración google-services.json a tu proyecto.

Si agregas Firebase a tu proyecto de Android mediante Firebase Firebase, la API de REST de Management o Firebase CLI, debes agregar manualmente el complemento y el archivo de configuración a tu proyecto. Sin embargo, si usas Firebase Assistant, estas tareas se realizan automáticamente durante la configuración.

Consulta la documentación de Android para obtener información sobre cómo funcionan juntos el complemento de servicios de Google y el archivo de configuración.

Firebase Android BoM (Bill of Materials)

La Firebase Android BoM (Bill of Materials) te permite administrar todas las versiones de tus bibliotecas de Firebase con solo especificar una versión, la versión de BoM.

Cuando usas la Firebase BoM en tu app, la BoM extrae automáticamente las versiones de biblioteca individuales asignadas a la versión de BoM. Todas las versiones de biblioteca individuales serán compatibles. Cuando actualizas la versión de la BoM en tu app, todas las bibliotecas de Firebase que uses en la app se actualizarán a las versiones asignadas a esa versión de la BoM.

Para saber qué versiones de la biblioteca de Firebase se asignan a una versión específica de la BoM, consulta las notas de la versión correspondientes a esa versión de la BoM. Si necesitas comparar las versiones de la biblioteca asignadas a una versión de la BoM con otra versión de la BoM, usa el widget de comparación que aparece más abajo.

Obtén más información sobre la compatibilidad de Gradle con las plataformas BoM.

A continuación, se muestra cómo usar la Firebase Android BoM para declarar dependencias en tu archivo Gradle (generalmente app/build.gradle) del módulo (nivel de app). Cuando uses la BoM, no debes especificar versiones de biblioteca individuales en las líneas de dependencia.

dependencies {
  // Import the BoM for the Firebase platform
  implementation platform('com.google.firebase:firebase-bom:33.3.0')

  // Declare the dependencies for the desired Firebase products without specifying versions
  // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
  implementation 'com.google.firebase:firebase-auth'
  implementation 'com.google.firebase:firebase-firestore'
}

Estas son algunas preguntas frecuentes sobre el uso de la Firebase Android BoM:

¿Cómo uso una versión de biblioteca diferente a la designada en la BoM?

Aquí se muestra cómo anular una versión de la biblioteca designada en la BoM:

Mantén la línea para importar la plataforma BoM.

En la línea de dependencia de la biblioteca, especifica la versión deseada de la biblioteca. Por ejemplo, aquí se muestra cómo declarar dependencias si quieres usar la versión 18.0.0 de App Indexing sin importar qué versión esté designada en la BoM, pero quieres usar las versiones de la BoM para Authentication y Cloud Firestore:

dependencies {
  // Import the BoM for the Firebase platform
  implementation platform('com.google.firebase:firebase-bom:33.3.0')

  // Declare the dependency for the App Indexing library and specify a version
  // This specified library version overrides the version designated in the BoM.
  implementation 'com.google.firebase:firebase-appindexing:18.0.0'

  // Declare the dependencies for the other Firebase libraries without specifying versions
  // These libraries will use the versions designated in the BoM.
  implementation 'com.google.firebase:firebase-auth'
  implementation 'com.google.firebase:firebase-firestore'
}

¿La BoM agrega automáticamente todas las bibliotecas de Firebase a mi app?

No. Para agregar bibliotecas de Firebase a tu app y usarlas, debes declarar cada biblioteca como una línea de dependencia distinta en el archivo Gradle (generalmente, app/build.gradle) de tu módulo (nivel de app).

El uso de la BoM garantiza que las versiones de las bibliotecas de Firebase en tu app sean compatibles, pero la BoM no agrega realmente esas bibliotecas de Firebase a tu app.

¿Las bibliotecas de extensiones de Firebase para Kotlin (KTX) son compatibles con la BoM?

Sí. Cuando declares tus líneas de dependencia de biblioteca de Firebase específicas, solo usa el nombre de la biblioteca de KTX de la siguiente manera:

dependencies {
  // Import the BoM for the Firebase platform
  implementation platform('com.google.firebase:firebase-bom:33.3.0')

  // Declare the dependencies for the desired Firebase products, without specifying versions
  // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
  implementation 'com.google.firebase:firebase-auth-ktx'
  implementation 'com.google.firebase:firebase-firestore-ktx'
}

¿Puedo usar la BoM para agregar bibliotecas de Android que no sean de Firebase?

No. La Firebase Android BoM solo administra las versiones de las bibliotecas de Firebase. La única excepción es la inclusión del SDK de Google Mobile Ads porque se usa con frecuencia en las apps de Firebase.

¿Por qué la BoM es la forma recomendada de administrar las versiones de las bibliotecas de Firebase?

Aunque cada versión de la biblioteca de Firebase se controla por separado, se crean juntas para garantizar que la última versión sea compatible con las otras.

Cuando usas la BoM para administrar las versiones de las bibliotecas de Firebase de tu app, no necesitas realizar un seguimiento de qué versión de una biblioteca de Firebase es compatible con otra.

Incluso si solo usas una biblioteca de Firebase en tu app, recomendamos el uso de la BoM, ya que nunca se sabe cuándo querrás usar otra biblioteca de Firebase.

Mi app usa una versión de Gradle anterior a la 5.0. ¿Puedo usar la BoM?

Sí, puedes usar la BoM. Para Gradle 5.0 y versiones posteriores, la compatibilidad con la BoM está habilitada automáticamente. Sin embargo, para las versiones anteriores de Gradle, solo necesitas habilitar la función BoM y, luego, importar la BoM de un modo un poco diferente.

Para tu archivo settings.gradle, agrega enableFeaturePreview('IMPROVED_POM_SUPPORT').

En tu archivo Gradle (generalmente, app/build.gradle) del módulo (nivel de app), importa la BoM como una biblioteca normal (sin el modificador platform) de la siguiente manera:

dependencies {
  // Import the Firebase BoM
  implementation 'com.google.firebase:firebase-bom:33.3.0'

  // Declare the dependencies for the desired Firebase products, without specifying versions
  // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
  implementation 'com.google.firebase:firebase-auth'
  implementation 'com.google.firebase:firebase-firestore'
}

¿Cómo informo un problema o envío comentarios sobre la BoM?

Visita el repositorio del SDK de Firebase Android en GitHub.

Compara versiones de la Firebase BoM

Módulos de bibliotecas de extensiones de Kotlin (KTX)

Se agregaron las APIs de extensiones de Kotlin (KTX) a sus respectivos módulos principales. Por ejemplo, todas las APIs de firebase-perf-ktx se agregaron a firebase-perf en el paquete com.google.firebase.perf.

Este cambio significa que los desarrolladores de Kotlin ahora deben depender de los módulos principales en lugar de los módulos de KTX (cuando usen la Firebase BoM v32.5.0 o una versión posterior, o las versiones del módulo principal que se indican en la BoM v32.5.0 o una versión posterior).

Como parte de este cambio, las APIs de KTX en cada módulo de KTX ahora están obsoletas. A partir de septiembre de 2024, ya no lanzaremos módulos de KTX y, en esa fecha, también quitaremos las bibliotecas de KTX de la Firebase Android BoM.

Si usas las APIs de KTX de los módulos de KTX, 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.

Los módulos de biblioteca de extensiones de Firebase para Kotlin (KTX) son complementos pequeños para los módulos de bibliotecas principales de Firebase y puedes usarlos para escribir código de Kotlin idiomático y atractivo.

Para usar un módulo de biblioteca de KTX en tu app, cambia tu dependencia para que incluya el sufijo -ktx. Cada módulo de KTX tiene automáticamente una dependencia en el módulo de biblioteca principal, por lo que no es necesario incluir ambas dependencias en la app.

dependencies {
  // Import the BoM for the Firebase platform (learn more)
  implementation platform('com.google.firebase:firebase-bom:33.3.0')

  // Declare the main module
  implementation 'com.google.firebase:firebase-analytics'

  // Declare the KTX module instead (which automatically has a dependency on the main module)
  implementation 'com.google.firebase:firebase-analytics-ktx'
}

Cada módulo de KTX proporciona diferentes extensiones sintácticas del módulo principal. Por ejemplo, el módulo de KTX para Analytics facilita el registro de eventos:

Antes (con el módulo principal)

val analytics = FirebaseAnalytics.getInstance();
val bundle = Bundle();
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id);
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name);
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
analytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM, bundle);

Después (con el módulo de KTX)

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, id)
    param(FirebaseAnalytics.Param.ITEM_NAME, name)
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}MainActivity.kt

Todos los productos de Firebase ofrecen un módulo de KTX, excepto Firebase ML y App Indexing.

Si aún no lo has hecho, consulta los documentos de referencia de la API para las módulos de KTX.

Módulos de funciones y Play Feature Delivery

A partir de mayo de 2021 (versión 28.0.0 de la Firebase BoM), los SDK de Firebase Android pueden usarse en módulos de funciones dinámicas que se instalan por separado del módulo de aplicación base.

Para habilitar la compatibilidad con los módulos de funciones dinámicas, agrega la siguiente dependencia al archivo build.gradle del módulo base:

dependencies {
  implementation 'com.google.firebase:firebase-dynamic-module-support:16.0.0-beta03'
}

Ahora que agregaste compatibilidad con el módulo dinámico, puedes agregar dependencias del SDK de Firebase (con o sin la Firebase BoM) a los módulos de funciones de tu app y usarlos como lo harías normalmente.

Por ejemplo, si tu aplicación usa Realtime Database para potenciar una función específica en tiempo real, puedes agregar la dependencia firebase-database al build.gradle del módulo de la función en vez del módulo básico, lo cual reducirá el tamaño de descarga para la mayoría de los usuarios.

Ten en cuenta las siguientes advertencias cuando uses los SDK de Firebase en los módulos de funciones:

Es posible que productos como Dynamic Links o Firebase In-App Messaging, que dependen del evento first_open de Analytics, no detecten este evento si se usan en un módulo de funciones dinámicas.
Cuando uses Cloud Firestore y Authentication en conjunto, siempre debes incluirlos en el mismo módulo. Si esto no es posible, asegúrate de que Authentication se cargue antes que Cloud Firestore. De lo contrario, algunas operaciones de Cloud Firestore pueden tener un estado de autenticación incorrecto.
Cuando usas firebase-crashlytics-ndk como dependencia de un módulo de funciones dinámicas, debes establecer la propiedad unstrippedNativeLibsDir en el archivo build.gradle de la app, como se describe en la documentación del NDK de Crashlytics.

Para obtener más información sobre los módulos de funciones y Play Feature Delivery, consulta el artículo Descripción general de Play Feature Delivery.

Comparación entre el complemento de Gradle para los servicios de Google, los Servicios de Google Play y Google Play Store

Numerosos componentes del ecosistema de Google, Firebase y Android tienen convenciones de nombres similares. A continuación, se incluye una explicación breve de cada una:

Complemento de Gradle para los servicios de Google: Un complemento de Gradle (com.google.gms.google-services) que se ejecuta en el tiempo de compilación para garantizar que tu app tenga la configuración correcta para acceder a las APIs de Firebase y Google.; A pesar de su nombre, este complemento no tiene relación con los Servicios de Google Play (consulta la entrada siguiente) y no afecta las capacidades de tu app en el tiempo de ejecución.; Este complemento también procesa el archivo google-services.json que agregas a la app como parte de la configuración de Firebase. Obtén más información sobre el complemento de Gradle para los servicios de Google.
Servicios de Google Play: Un servicio en segundo plano invisible que se ejecuta en un dispositivo Android y proporciona varias APIs comunes de Google (como Google Maps y Acceso con Google) para apps en el dispositivo.; Mediante la centralización de estas APIs comunes en un solo servicio, reduce el tamaño de otras aplicaciones y permite que un dispositivo reciba actualizaciones de seguridad automáticas y mejoras de funciones sin una actualización del SO. Obtén más información sobre los Servicios de Google Play.
Google Play Store: Una tienda para descargar apps, películas, libros y mucho más en un dispositivo Android.; Como desarrollador, tú administras la distribución, las versiones, etc. de tu app a través de Google Play Console. Si un dispositivo tiene Google Play Store, también se ejecutan en él los Servicios de Google Play (consulta la entrada anterior). Obtén más información sobre Google Play Store para desarrolladores.
Servicios de juego de Google Play: Un conjunto de APIs para desarrolladores de juegos para dispositivos móviles.; Obtén más información sobre los Servicios de juego de Google Play y cómo integrar Firebase a tu proyecto de Servicios de juego de Google Play.

Recursos de código abierto para los SDK de Firebase Android

Firebase admite el desarrollo de código abierto, y motivamos las contribuciones y los comentarios de la comunidad.

SDK de Firebase Android

La mayoría de los SDK de Firebase Android se desarrollan como bibliotecas de código abierto en nuestro repositorio público de Firebase en GitHub. Estamos trabajando para trasladar las bibliotecas de Firebase de desarrollo privado a nuestro GitHub público.

Muestras de inicio rápido

Firebase conserva una colección de muestras de inicio rápido para la mayoría de las APIs de Firebase en Android. Consulta estas muestras en nuestro repositorio de muestras de inicio rápido de Firebase en GitHub.

Puedes abrir cada muestra como un proyecto de Android Studio y, luego, ejecutarlas en un dispositivo móvil o en un dispositivo virtual (AVD). También puedes usarlas como código de ejemplo para usar los SDK de Firebase.