Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.

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:

    • Se orienta al nivel de API 16 (Jelly Bean) o una versión posterior.
    • Usa Gradle 4.1 o una versión posterior.
    • Utiliza Jetpack (AndroidX), que incluye el cumplimiento de los siguientes requisitos de versión:
      • com.android.tools.build:gradle 3.2.1 o una versión posterior
      • compileSdkVersion 28 o una versión posterior
  • Configura un dispositivo físico o utiliza un emulador para ejecutar tu app.
    Los emuladores deben usar una imagen que cuente con 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 archivo de configuración.

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 denomina “agregarla” a tu proyecto.

  1. Dirígete 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. Agrega el archivo de configuración de Firebase para Android a la app, como se indica a continuación:

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

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

  2. Agrega el complemento de google-services a tus archivos Gradle a fin de habilitar los productos de Firebase en tu app.

    1. Agrega reglas para incluir el complemento de servicios de Google al archivo Gradle (build.gradle) de nivel de raíz (a nivel de proyecto). Además, revisa que tengas el repositorio Maven de Google.

      buildscript {
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
        }
      
        dependencies {
          // ...
      
          // Add the following line:
          classpath 'com.google.gms:google-services:4.3.4'  // Google Services plugin
        }
      }
      
      allprojects {
        // ...
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // ...
        }
      }
      
    2. En el archivo Gradle (generalmente app/build.gradle) de tu módulo (a nivel de app), aplica el complemento Gradle de los servicios de Google:

      apply plugin: 'com.android.application'
      // Add the following line:
      apply plugin: 'com.google.gms.google-services'  // Google Services plugin
      
      android {
        // ...
      }
      

Paso 4: Agrega los SDK de Firebase a tu app

  1. Usa la BoM de Firebase para Android y declara las dependencias de los productos de Firebase que quieres usar en tu app. Decláralas en el archivo Gradle (generalmente app/build.gradle) de tu módulo (nivel de app).

    Si Analytics está habilitado

    Java

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:25.12.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics'
    
      // Declare the dependencies for any other desired Firebase products
      // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth'
      implementation 'com.google.firebase:firebase-firestore'
    }
    

    Kotlin+KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:25.12.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics-ktx'
    
      // Declare the dependencies for any other desired Firebase products
      // 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'
    }
    

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

    Si Analytics está inhabilitado

    Java

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:25.12.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependencies for the desired Firebase products
      // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth'
      implementation 'com.google.firebase:firebase-firestore'
    }
    
    // Getting a "Could not find" error? Make sure that you've added
    // Google's Maven repository to your root-level build.gradle file
    

    Kotlin+KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:25.12.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependencies for the desired Firebase products
      // 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'
    }
    
    // Getting a "Could not find" error? Make sure that you've added
    // Google's Maven repository to your root-level build.gradle file
    

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

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

Listo. Puedes avanzar para ver los pasos siguientes recomendados.



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 el proyecto de Android en Android Studio y accede a Firebase Assistant:

    1. Ve a Archivo > Buscar actualizaciones para asegurarte de estar usando las versiones más recientes de Android Studio y Firebase Assistant.

    2. Ve a Herramientas > Firebase para abrir el panel Asistente.

  2. Elige un producto de Firebase para agregarlo a tu 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).

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

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

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

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



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 la BoM de Firebase para Android, no especificas las versiones de biblioteca individuales cuando declaras las dependencias de la biblioteca de Firebase en build.gradle.

Java

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

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

25.12.0
AdMob com.google.android.gms:play-services-ads 19.4.0
Analytics com.google.firebase:firebase-analytics 17.6.0
App Indexing com.google.firebase:firebase-appindexing 19.1.0
Authentication com.google.firebase:firebase-auth 19.4.0
Cloud Firestore com.google.firebase:firebase-firestore 21.7.1
SDK de cliente de Cloud Functions para Firebase com.google.firebase:firebase-functions 19.1.0
Cloud Messaging com.google.firebase:firebase-messaging 20.3.0
Cloud Storage com.google.firebase:firebase-storage 19.2.0
Crashlytics com.google.firebase:firebase-crashlytics 17.2.2
Dynamic Links com.google.firebase:firebase-dynamic-links 19.1.1
API de Firebase ML Vision com.google.firebase:firebase-ml-vision 24.1.0
API de modelo personalizado del AA de Firebase com.google.firebase:firebase-ml-model-interpreter 22.0.4
In‑App Messaging com.google.firebase:firebase-inappmessaging 19.1.1
(obligatorio)
Visualización de In-App Messaging com.google.firebase:firebase-inappmessaging-display 19.1.1
(obligatorio)
Performance Monitoring com.google.firebase:firebase-perf 19.0.9
Realtime Database com.google.firebase:firebase-database 19.5.0
Remote Config com.google.firebase:firebase-config 19.2.0
Complemento de Servicios de Google Play com.google.gms:google-services 4.3.4
Bibliotecas obsoletas
AA de Firebase: Modelo de etiquetado de imágenes com.google.firebase:firebase-ml-vision-image-label-model 20.0.2
AA de Firebase: Modelo de detección y seguimiento de objetos com.google.firebase:firebase-ml-vision-object-detection-model 19.0.6
AA de Firebase: Modelo de detección de rostro com.google.firebase:firebase-ml-vision-face-model 20.0.2
AA de Firebase: Modelo de escaneo de códigos de barras com.google.firebase:firebase-ml-vision-barcode-model 16.1.2
AA de Firebase: API de AutoML Vision Edge com.google.firebase:firebase-ml-vision-automl 18.0.6
AA de Firebase: API de Natural Language com.google.firebase:firebase-ml-natural-language 22.0.1
AA de Firebase: Modelo de identificación de idiomas com.google.firebase:firebase-ml-natural-language-language-id-model 20.0.8
AA de Firebase: Modelo de traducción com.google.firebase:firebase-ml-natural-language-translate-model 20.0.9
AA de Firebase: Modelo de respuesta inteligente com.google.firebase:firebase-ml-natural-language-smart-reply-model 20.0.8

Kotlin+KTX

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

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

25.12.0
AdMob com.google.android.gms:play-services-ads 19.4.0
Analytics com.google.firebase:firebase-analytics-ktx 17.6.0
App Indexing com.google.firebase:firebase-appindexing 19.1.0
Authentication com.google.firebase:firebase-auth-ktx 19.4.0
Cloud Firestore com.google.firebase:firebase-firestore-ktx 21.7.1
SDK de cliente de Cloud Functions para Firebase com.google.firebase:firebase-functions-ktx 19.1.0
Cloud Messaging com.google.firebase:firebase-messaging-ktx 20.3.0
Cloud Storage com.google.firebase:firebase-storage-ktx 19.2.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 17.2.2
Dynamic Links com.google.firebase:firebase-dynamic-links-ktx 19.1.1
API de Firebase ML Vision com.google.firebase:firebase-ml-vision 24.1.0
API de modelo personalizado del AA de Firebase com.google.firebase:firebase-ml-model-interpreter 22.0.4
In‑App Messaging com.google.firebase:firebase-inappmessaging-ktx 19.1.1
(obligatorio)
Visualización de In-App Messaging com.google.firebase:firebase-inappmessaging-display-ktx 19.1.1
(obligatorio)
Performance Monitoring com.google.firebase:firebase-perf-ktx 19.0.9
Realtime Database com.google.firebase:firebase-database-ktx 19.5.0
Remote Config com.google.firebase:firebase-config-ktx 19.2.0
Complemento de Servicios de Google Play com.google.gms:google-services 4.3.4
Bibliotecas obsoletas
AA de Firebase: Modelo de etiquetado de imágenes com.google.firebase:firebase-ml-vision-image-label-model 20.0.2
AA de Firebase: Modelo de detección y seguimiento de objetos com.google.firebase:firebase-ml-vision-object-detection-model 19.0.6
AA de Firebase: Modelo de detección de rostro com.google.firebase:firebase-ml-vision-face-model 20.0.2
AA de Firebase: Modelo de escaneo de códigos de barras com.google.firebase:firebase-ml-vision-barcode-model 16.1.2
AA de Firebase: API de AutoML Vision Edge com.google.firebase:firebase-ml-vision-automl 18.0.6
AA de Firebase: API de Natural Language com.google.firebase:firebase-ml-natural-language 22.0.1
AA de Firebase: Modelo de identificación de idiomas com.google.firebase:firebase-ml-natural-language-language-id-model 20.0.8
AA de Firebase: Modelo de traducción com.google.firebase:firebase-ml-natural-language-translate-model 20.0.9
AA de Firebase: Modelo de respuesta inteligente 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: