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.

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.

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.

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.