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 app para Android satisfaga estas condiciones:

  • Se orienta al nivel de API 16 (Jelly Bean) o superior.
  • Usa Gradle 4.1 o una versión más reciente.

• Configura un dispositivo o emulador para ejecutar la app.

  • Los emuladores deben usar una imagen de emulador 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 app para Android, puedes descargar uno de nuestros ejemplos 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 (se requiere 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

A fin de poder agregar Firebase a tu app para Android, debes crear un proyecto de Firebase y conectarlo a la app. Consulta la Información sobre los proyectos de Firebase para obtener detalles acerca del tema.

Crea un proyecto de Firebase

1. En Firebase console, haz clic en Agregar proyecto y selecciona o ingresa el Nombre del proyecto.

   Si ya tienes un proyecto de Google Cloud Platform (GCP) existente, puedes seleccionarlo del menú desplegable Nombre del proyecto. De lo contrario, ingresa un nombre de proyecto nuevo.

2. (Opcional) Edita el ID del proyecto.

   Firebase asignará de manera automática un ID único a tu proyecto de Firebase. Consulta la Información sobre los proyectos de Firebase para obtener detalles sobre cómo usa Firebase el ID del proyecto.

3. Sigue los pasos de configuración restantes en Firebase console y, luego, haz clic en Crear proyecto (o Agregar Firebase si usas un proyecto de Google existente).

Firebase aprovisiona los recursos para tu proyecto de forma automática. Cuando finalice, verás la página de descripción general del proyecto en Firebase console.

Paso 2: Registra tu app con Firebase

Cuando tengas un proyecto de Firebase, podrás agregarle tu app para Android.

Revisa la Información sobre los proyectos de Firebase a fin de obtener detalles sobre las recomendaciones y consideraciones para agregar apps a un proyecto de Firebase, incluido cómo manejar diversas variantes de compilación.

1. En el centro de la página de descripción general del proyecto en Firebase console, haz clic en el ícono de Android para iniciar el flujo de trabajo de configuración.

   Si ya agregaste una app a tu proyecto de Firebase, haz clic en Agregar app para que se muestren las opciones de plataforma.

2. Ingresa el ID de aplicación de tu app en el campo Nombre del paquete de Android.

   • A veces, nos referimos al ID de aplicación como un nombre de paquete.

   • Encuentra este ID de aplicación en el archivo Gradle, generalmente app/build.gradle (ejemplo de ID: com.yourcompany.yourproject) de tu módulo (de nivel de la app).

3. (Opcional) Ingresa otra información de la app si el flujo de trabajo de configuración lo solicita.

   El sobrenombre es un identificador interno y conveniente, y solo tú puedes verlo en Firebase console.

4. 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).

      • Puedes volver a descargar el archivo de configuración de Firebase para Android cuando quieras.
      • Asegúrate de que no se hayan agregado caracteres adicionales, como (2), al nombre del archivo de configuración.

   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 Google Services al archivo Gradle (build.gradle) de nivel de raíz (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.2.0'  // 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 (nivel de app), agrega una línea al final del archivo.

      apply plugin: 'com.android.application'
      
      android {
        // ...
      }
      
      // Add the following line to the bottom of the file:
      apply plugin: 'com.google.gms.google-services'  // Google Play services Gradle plugin
      

Paso 4: Agrega los SDK de Firebase a tu app

Puedes agregar cualquiera de los productos de Firebase admitidos a tu app para Android. Te recomendamos comenzar con el SDK principal de Firebase (com.google.firebase:firebase-core), que ofrece funciones de Google Analytics para Firebase.

1. En el archivo Gradle (generalmente app/build.gradle) de tu módulo (nivel de app), agrega la dependencia para el SDK principal de Firebase, como se muestra a continuación:

   dependencies {
    // ...
    implementation 'com.google.firebase:firebase-core:17.0.0'
   
    // Getting a "Could not find" error? Make sure that you've added
    // Google's Maven repository to your root-level build.gradle file
   }
   

2. (Opcional) Agrega las dependencias de las otras bibliotecas de Firebase que deseas usar.

   Algunos SDK de Firebase para Android ofrecen una biblioteca de extensiones de Kotlin alternativa.

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

4. Ejecuta la app para enviar la verificación a Firebase de que lo integraste correctamente.

   En los registros de tu dispositivo, se mostrará la verificación de Firebase que indica que se completó la inicialización. Si ejecutaste tu app en un emulador que tiene acceso a redes, Firebase console notificará que se completó la conexión de tu app.

Listo. Puedes avanzar a los pasos siguientes.

Opción 2: Agrega Firebase mediante Firebase Assistant

Firebase Assistant registra tu app con un proyecto de Firebase y agrega los archivos y el código necesarios del servicio a tu proyecto de Android, todo desde Android Studio.

Recuerda que para conectar tu app con Firebase, la opción que recomendamos es usar el flujo de trabajo de configuración de Firebase console.

1. Abre tu proyecto de Android en Android Studio.

2. Selecciona Herramientas > Firebase para abrir la ventana del Asistente.

3. Haz clic para expandir uno de los productos de Firebase que aparecen (por ejemplo, Analytics) y, luego, haz clic en el vínculo del instructivo que se proporciona (por ejemplo, Registrar un evento de Analytics).

4. Haz clic en Conectar a Firebase a fin de registrar tu app con un proyecto de Firebase nuevo o existente y para agregar automáticamente los archivos y el código necesarios al proyecto de Android.

5. Comprueba que las versiones de tus complementos y bibliotecas sean las más recientes:

   • Comprueba que la versión de tu complemento de Google Services sea la más reciente (com.google.gms:google-services:4.2.0) en el archivo Gradle (build.gradle) de nivel de raíz (nivel de proyecto):

   • En el archivo Gradle (generalmente app/build.gradle) de tu módulo (nivel de app), comprueba que las versiones de las bibliotecas de Firebase para Android sean las más recientes.

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

7. Ve a la Configuración del proyecto en Firebase console a fin de establecer la configuración para compartir datos en Analytics.
   A fin de usar productos como Firebase Predictions o Firebase A/B Testing se debe habilitar la función para compartir datos de Analytics con otros productos de Firebase.

8. Ejecuta la app para enviar la verificación a Firebase de que lo integraste correctamente.

   En los registros de tu dispositivo, se mostrará la verificación de Firebase que indica que se completó la inicialización. Si ejecutaste tu app en un emulador que tiene acceso a redes, Firebase console notificará que se completó la conexión de tu app.

Bibliotecas disponibles

Las siguientes bibliotecas de Android están disponibles para los distintos productos de Firebase.

Algunos SDK de Firebase para Android ofrecen una biblioteca de extensiones de Kotlin alternativa.

Servicio o producto	Línea de dependencia de Gradle
Complemento de Servicios de Google Play	com.google.gms:google-services:4.2.0
AdMob	com.google.firebase:firebase-ads:18.0.0
Analytics	com.google.firebase:firebase-core:17.0.0
App Indexing	com.google.firebase:firebase-appindexing:19.0.0
Authentication	com.google.firebase:firebase-auth:18.0.0
Cloud Firestore	com.google.firebase:firebase-firestore:20.0.0
SDK de cliente de Cloud Functions para Firebase	com.google.firebase:firebase-functions:18.0.0
Cloud Messaging	com.google.firebase:firebase-messaging:19.0.0
Cloud Storage	com.google.firebase:firebase-storage:18.0.0
Crashlytics	com.crashlytics.sdk.android:crashlytics:2.10.1
Dynamic Links	com.google.firebase:firebase-dynamic-links:18.0.0
In-App Messaging	com.google.firebase:firebase-inappmessaging:18.0.0
Visualización de In-App Messaging	com.google.firebase:firebase-inappmessaging-display:18.0.0
Kit de AA: API de Vision	com.google.firebase:firebase-ml-vision:21.0.0
Kit de AA: Modelo de etiquetado de imágenes	com.google.firebase:firebase-ml-vision-image-label-model:18.0.0
Kit de AA: Modelo de detección de rostro	com.google.firebase:firebase-ml-vision-face-model:18.0.0
Kit de AA: Modelo de detección y seguimiento de objetos	com.google.firebase:firebase-ml-vision-object-detection-model:17.0.0
Kit de AA: API de Natural Language	com.google.firebase:firebase-ml-natural-language:20.0.0
Kit de AA: Modelo de identificación de idiomas	com.google.firebase:firebase-ml-natural-language-language-id-model:20.0.0
Kit de AA: Modelo de traducción	com.google.firebase:firebase-ml-natural-language-translate-model:20.0.0
Kit de AA: Modelo de Respuesta inteligente	com.google.firebase:firebase-ml-natural-language-smart-reply-model:20.0.0
Kit de AA: API de Custom Model	com.google.firebase:firebase-ml-model-interpreter:20.0.0
Kit de AA: API de AutoML Vision Edge	com.google.firebase:firebase-ml-vision-automl:17.0.0
Performance Monitoring	com.google.firebase:firebase-perf:18.0.0
Realtime Database	com.google.firebase:firebase-database:18.0.0
Remote Config	com.google.firebase:firebase-config:18.0.0

Controla las versiones de las bibliotecas con listas de materiales (BoM) de Firebase (experimental)

Considera importar una lista de materiales (BoM) de Firebase para facilitar la administración de versiones de bibliotecas.

Agrega los SDK de Firebase a tu app mediante una BoM de Firebase

Con la función de Gradle de listas de materiales (BoM) en Firebase, puedes configurar la versión de la plataforma de Firebase como unidad global. Cada versión de BoM de Firebase contiene versiones compatibles de las bibliotecas de Firebase. Revisa las notas de la versión de las versiones de las bibliotecas asignadas a versiones de BoM específicas.

Si actualizas a la versión de BoM más reciente se actualizarán todas las bibliotecas de Firebase para Android a las versiones más recientes que estén disponibles cuando se libere la BoM.

Para agregar los SDK de Firebase a tu app mediante una BoM de Firebase sigue estos pasos:

• Para Gradle 5.0 y versiones posteriores, las BoM están habilitadas automáticamente. Configura las dependencias en el archivo Gradle del módulo (generalmente app/build.gradle):

  dependencies {
    // Import the platform
    implementation platform('com.google.firebase:firebase-bom:20.0.0')
  
    // When using a BoM, dependencies don't require a specified version
    // If you do specify a version, it overrides the library version specified in the BoM
    implementation 'com.google.firebase:firebase-core'
    implementation 'com.google.firebase:firebase-auth'
    implementation 'com.google.firebase:firebase-firestore'
  }
  

• Para versiones anteriores de Gradle, debes habilitar la característica de BoM:
  1. Agrega enableFeaturePreview('IMPROVED_POM_SUPPORT') a tu archivo settings.gradle.
  2. Importa la BoM como una biblioteca normal (sin el modificador platform).

Después de agregar firebase-bom a tus dependencias, puedes declarar las bibliotecas de Firebase sin tener que especificar sus versiones. Cuando quieras actualizar las versiones de las bibliotecas de Firebase, solo debes actualizar la versión de la BoM de Firebase.

Visita el repositorio del SDK de Firebase Android en GitHub si necesitas informar un problema o enviar tus comentarios sobre las BoM de Firebase.

Próximos pasos

Obtén información acerca de Firebase:

• Consulta la Información sobre los proyectos de Firebase a fin de obtener detalles acerca del tema y también recomendaciones para los proyectos.

• Explora las apps de muestra de Firebase.

• Obtén experiencia personal con el Codelab de Firebase para Android.

• Obtén más información con el curso Firebase en un fin de semana.

• Prepárate para iniciar tu app:

  • Configura alertas de facturación.
  • Revisa la Lista de tareas para el lanzamiento de Firebase.

Agrega funciones de Firebase a la app:

• Obtén estadísticas sobre el comportamiento de los usuarios con Analytics.

• Configura un flujo de autenticación de usuarios con Authentication.

• Almacena datos, como la información del usuario, con Cloud Firestore o Realtime Database.

• Almacena archivos, como fotos y videos, con Cloud Storage.

• Activa código de backend que se ejecuta en un entorno seguro con Cloud Functions.

• Envía notificaciones con Cloud Messaging.

• Usa Crashlytics para descubrir cómo y por qué falla la app.