Agrega Firebase al proyecto de Android

Requisitos previos

  • Instala Android Studio o actualízalo a su versión más reciente.

  • Asegúrate de que tu proyecto cumpla con estos requisitos (ten en cuenta que algunos productos pueden tener requisitos más estrictos):

    • Se segmenta al nivel de API 21 (Lollipop) o una versión posterior.
    • Usa Android 5.0 o una versión posterior.
    • Utiliza Jetpack (AndroidX), que incluye el cumplimiento de los siguientes requisitos de versión:
      • com.android.tools.build:gradle v7.3.0 o una versión posterior
      • compileSdkVersion 28 o una versión posterior

  • Configura un dispositivo físico o usa un emulador para ejecutar tu app.
    Ten en cuenta que los SDKs de Firebase con una dependencia en Servicios de Google Play requieren que el dispositivo o el emulador tenga instalados los Servicios de Google Play.

  • Accede a Firebase con tu Cuenta de Google.

Si solo quieres probar un producto de Firebase, pero aún no tienes un proyecto de Android, puedes descargar una de estas muestras de inicio rápido.


Puedes conectar tu app para Android a Firebase mediante una de las siguientes opciones:

  • Opción 1: Usa el flujo de trabajo de configuración de Firebase console (recomendada).
  • Opción 2: Usa Firebase Assistant de Android Studio (es posible que requiera configuración adicional).


Opción 1: Agrega Firebase mediante Firebase console

Agregar Firebase a tu app implica realizar tareas en Firebase console y en tu proyecto abierto de Android (por ejemplo, descargar archivos de configuración de Firebase desde la consola y transferirlos al proyecto de Android).

Paso 1: Crea un proyecto de Firebase

Antes de poder agregar Firebase a tu app para Android, debes crear un proyecto de Firebase y conectarlo a la app. Visita Información sobre los proyectos de Firebase para obtener más detalles sobre este tema.

Paso 2: Registra tu app con Firebase

Si quieres usar Firebase en tu app para Android, debes registrar la app con el proyecto de Firebase. El registro de tu app a menudo se conoce como “agregar” la app a tu proyecto.

  1. Ve a Firebase console.

  2. En el centro de la página de descripción general del proyecto, haz clic en el ícono de Android () o en Agregar app para iniciar el flujo de trabajo de configuración.

  3. Ingresa el nombre del paquete de tu app en el campo Nombre del paquete de Android.

  4. Ingresa otra información de la app, como el sobrenombre y el certificado de firma SHA-1 de depuración (opcional).

  5. Haz clic en Registrar app.

Paso 3: Agrega un archivo de configuración de Firebase

  1. Descarga y, luego, agrega el archivo de configuración de Firebase para Android (google-services.json) a tu app:

    1. Haz clic en Descargar google-services.json a fin de obtener el archivo de configuración de Firebase para Android.

    2. Transfiere tu archivo de configuración al directorio raíz del módulo (nivel de app) de tu app.

  2. Para que los SDKs de Firebase puedan acceder a los valores de tu archivo de configuración google-services.json, necesitas el complemento de los servicios de Google para Gradle (google-services).

    1. Agrega el complemento de Google Services como dependencia en el archivo de Gradle (<project>/build.gradle.kts o <project>/build.gradle) a nivel de raíz (a nivel de proyecto):

      Kotlin 

      plugins {
  id("com.android.application") version "7.3.0" apply false
  // ...

  // Add the dependency for the Google services Gradle plugin
  id("com.google.gms.google-services") version "4.4.2" apply false
}

      Groovy 

      plugins {
  id 'com.android.application' version '7.3.0' apply false
  // ...

  // Add the dependency for the Google services Gradle plugin
  id 'com.google.gms.google-services' version '4.4.2' apply false
}

    2. Agrega el complemento de los servicios de Google en el archivo de Gradle (generalmente <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle) del módulo (nivel de app):

      Kotlin 

      plugins {
  id("com.android.application")

  // Add the Google services Gradle plugin
  id("com.google.gms.google-services")
  // ...
}

      Groovy 

      plugins {
  id 'com.android.application'

  // Add the Google services Gradle plugin
  id 'com.google.gms.google-services'
  // ...
}

Paso 4: Agrega los SDK de Firebase a tu app

  1. En el archivo Gradle (generalmente <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle) del módulo (nivel de app), agrega las dependencias de los productos de Firebase que quieras usar en tu app. Te recomendamos que uses la Firebase Android BoM para controlar las versiones de las bibliotecas.

    Analytics habilitado 

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation(platform("com.google.firebase:firebase-bom:33.6.0"))

  // When using the BoM, you don't specify versions in Firebase library dependencies

  // Add the dependency for the Firebase SDK for Google Analytics
  implementation("com.google.firebase:firebase-analytics")

  // TODO: Add the dependencies for any other Firebase products you want to use
  // See https://firebase.google.com/docs/android/setup#available-libraries
  // For example, add the dependencies for Firebase Authentication and Cloud Firestore
  implementation("com.google.firebase:firebase-auth")
  implementation("com.google.firebase:firebase-firestore")
}

    Cuando usas la Firebase Android BoM, tu app siempre usará versiones compatibles de las bibliotecas de Firebase para Android.

    ¿Buscas un módulo de biblioteca específico de Kotlin? A partir de octubre de 2023 (Firebase BoM 32.5.0), tanto los desarrolladores de Kotlin como los de Java pueden depender del módulo de la biblioteca principal (para obtener más información, consulta las Preguntas frecuentes sobre esta iniciativa).

    Analytics no habilitado 

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation(platform("com.google.firebase:firebase-bom:33.6.0"))

  // When using the BoM, you don't specify versions in Firebase library dependencies

  // TODO: Add the dependencies for Firebase products you want to use
  // See https://firebase.google.com/docs/android/setup#available-libraries
  // For example, add the dependencies for Firebase Authentication and Cloud Firestore
  implementation("com.google.firebase:firebase-auth")
  implementation("com.google.firebase:firebase-firestore")
}

    Cuando usas la Firebase Android BoM, tu app siempre usará versiones compatibles de las bibliotecas de Firebase para Android.

    ¿Buscas un módulo de biblioteca específico de Kotlin? A partir de octubre de 2023 (Firebase BoM 32.5.0), tanto los desarrolladores de Kotlin como los de Java pueden depender del módulo de la biblioteca principal (para obtener más información, consulta las Preguntas frecuentes sobre esta iniciativa).

  2. Después de agregar las dependencias de los productos que deseas usar, sincroniza tu proyecto de Android con los archivos de Gradle.

Listo. Puedes avanzar para ver los próximos pasos recomendados.

Sin embargo, si tienes problemas con la configuración, visita la página de Preguntas frecuentes y solución de problemas de Android.


Opción 2: Agrega Firebase mediante Firebase Assistant

Firebase Assistant registra tu app con un proyecto de Firebase y agrega los archivos, los complementos y las dependencias necesarios de Firebase al proyecto de Android, todo desde Android Studio.

  1. Abre tu proyecto de Android en Android Studio y asegúrate de que estás usando las versiones más recientes de este entorno de desarrollo y Firebase Assistant:

    • Windows/Linux: Ayuda > Buscar actualizaciones
    • macOS: Android Studio > Buscar actualizaciones

  2. Abre Firebase Assistant: Herramientas > Firebase.

  3. En el panel Asistente, elige un producto de Firebase para agregar a la app. Expande su sección y haz clic en el vínculo del instructivo (por ejemplo, Analytics > Registra un evento de Analytics).

    1. Haz clic en Conectarse a Firebase para conectar tu proyecto de Android con Firebase.

    2. Haz clic en el botón para agregar un producto de Firebase deseado (por ejemplo, Agrega Analytics a tu app).

  4. Sincroniza tu app para garantizar que todas las dependencias tengan las versiones necesarias.

  5. En el panel Asistente, sigue las instrucciones de configuración restantes para el producto de Firebase que selecciones.

  6. Agrega todos los demás productos de Firebase que quieras mediante Firebase Assistant.

Listo. Asegúrate de consultar los próximos pasos recomendados.

Sin embargo, si tienes problemas con la configuración, visita la página de Preguntas frecuentes y solución de problemas de Android.


Bibliotecas disponibles

En esta sección, se enumeran los productos de Firebase compatibles con Android y sus dependencias de Gradle. Obtén más información sobre estas bibliotecas de Firebase para Android:

Ten en cuenta que, cuando usas Firebase Android BoM, no especificas versiones individuales de biblioteca cuando declaras las dependencias de la biblioteca de Firebase en el archivo de configuración de compilación de Gradle.

Servicio o producto Dependencia de Gradle Última
versión		 ¿Agregar Analytics?
Firebase Android BoM
(Bill of Materials)		 com.google.firebase:firebase-bom

La versión más reciente de la Firebase BoM contiene las últimas versiones de cada biblioteca de Firebase para Android. Para saber qué versiones de la biblioteca se asignan a una versión específica de la BoM, revisa las notas de la versión de la BoM.

 33.6.0
AdMob com.google.android.gms:play-services-ads 23.5.0
Analytics com.google.firebase:firebase-analytics 22.1.2
Proveedor personalizado de App Check com.google.firebase:firebase-appcheck 18.0.0
Proveedor de depuración de App Check com.google.firebase:firebase-appcheck-debug 18.0.0
Proveedor de Play Integrity para App Check com.google.firebase:firebase-appcheck-playintegrity 18.0.0
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-beta14
API de App Distribution com.google.firebase:firebase-appdistribution-api 16.0.0-beta14
Complemento de App Distribution com.google.firebase:firebase-appdistribution-gradle 5.0.0
Authentication com.google.firebase:firebase-auth 23.1.0
Cloud Firestore com.google.firebase:firebase-firestore 25.1.1
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 21.1.0
Cloud Messaging com.google.firebase:firebase-messaging 24.1.0
Cloud Storage com.google.firebase:firebase-storage 21.0.1
Crashlytics com.google.firebase:firebase-crashlytics 19.2.1
NDK de Crashlytics com.google.firebase:firebase-crashlytics-ndk 19.2.1
Complemento de Crashlytics com.google.firebase:firebase-crashlytics-gradle 3.0.2
Compatibilidad con módulos de funciones dinámicas com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
Dynamic Links com.google.firebase:firebase-dynamic-links 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging 21.0.1
(obligatorio)
Visualización de In-App Messaging com.google.firebase:firebase-inappmessaging-display 21.0.1
(obligatorio)
Instalaciones de Firebase com.google.firebase:firebase-installations 18.0.0
API de Firebase ML Model Downloader com.google.firebase:firebase-ml-modeldownloader 25.0.1
Performance Monitoring com.google.firebase:firebase-perf 21.0.2
Complemento de Performance Monitoring com.google.firebase:perf-plugin 1.4.2
Realtime Database com.google.firebase:firebase-database 21.0.0
Remote Config com.google.firebase:firebase-config 22.0.1
Vertex AI in Firebase com.google.firebase:firebase-vertexai 16.0.2
Complemento de Servicios de Google Play com.google.gms:google-services 4.4.2
BIBLIOTECAS OBSOLETAS
Proveedor de SafetyNet para App Check com.google.firebase:firebase-appcheck-safetynet 16.1.2
App Indexing com.google.firebase:firebase-appindexing 20.0.0

Módulos de KTX para Firebase

Analytics com.google.firebase:firebase-analytics-ktx 22.1.2
Proveedor personalizado de App Check com.google.firebase:firebase-appcheck-ktx 18.0.0
API de App Distribution com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta14
Authentication com.google.firebase:firebase-auth-ktx 23.1.0
Cloud Firestore com.google.firebase:firebase-firestore-ktx 25.1.1
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions-ktx 21.1.0
Cloud Messaging com.google.firebase:firebase-messaging-ktx 24.1.0
Cloud Storage com.google.firebase:firebase-storage-ktx 21.0.1
Crashlytics com.google.firebase:firebase-crashlytics-ktx 19.2.1
Dynamic Links com.google.firebase:firebase-dynamic-links-ktx 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging-ktx 21.0.1
(obligatorio)
Visualización de In-App Messaging com.google.firebase:firebase-inappmessaging-display-ktx 21.0.1
(obligatorio)
Instalaciones de Firebase com.google.firebase:firebase-installations-ktx 18.0.0
API de Firebase ML Model Downloader com.google.firebase:firebase-ml-modeldownloader-ktx 25.0.1
Performance Monitoring com.google.firebase:firebase-perf-ktx 21.0.2
Realtime Database com.google.firebase:firebase-database-ktx 21.0.0
Remote Config com.google.firebase:firebase-config-ktx 22.0.1

Bibliotecas de ML Kit para Firebase

APIs de Firebase ML Custom Model com.google.firebase:firebase-ml-model-interpreter 22.0.4
APIs de Firebase ML Vision com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML: Modelo de etiquetado de imágenes com.google.firebase:firebase-ml-vision-image-label-model 20.0.2
Firebase ML: Modelo de detección y seguimiento de objetos com.google.firebase:firebase-ml-vision-object-detection-model 19.0.6
Firebase ML: Modelo de detección de rostros com.google.firebase:firebase-ml-vision-face-model 20.0.2
Firebase ML: Modelo de escaneo de códigos de barras com.google.firebase:firebase-ml-vision-barcode-model 16.1.2
Firebase ML: API de AutoML Vision Edge com.google.firebase:firebase-ml-vision-automl 18.0.6
Firebase ML: APIs de Natural Language com.google.firebase:firebase-ml-natural-language 22.0.1
Firebase ML: Modelo de identificación de idiomas com.google.firebase:firebase-ml-natural-language-language-id-model 20.0.8
Firebase ML: Modelo de traducción com.google.firebase:firebase-ml-natural-language-translate-model 20.0.9
Firebase ML: Modelo de respuestas inteligentes com.google.firebase:firebase-ml-natural-language-smart-reply-model 20.0.8


Próximos pasos

Agrega los servicios de Firebase a tu app:

Obtén información acerca de Firebase: