Agrega Firebase a tu proyecto de Android

Requisitos previos

• Un dispositivo que ejecute los siguientes componentes:
  • Android 4.1 (nivel de API 16, Jelly Bean) o posterior
  • Servicios de Google Play 15.0.0 o posterior
• La versión más reciente de Android Studio

Si aún no tienes un proyecto de Android Studio y simplemente quieres probar una función de Firebase, puedes descargar una de las muestras de inicio rápido. Si estás usando un inicio rápido, recuerda obtener el ID de la aplicación desde el archivo build.gradle que se encuentra en la carpeta del módulo de tu proyecto (por lo general, app/), ya que necesitarás el nombre de este paquete para el siguiente paso.

Agrega Firebase a la app

Si usas la versión 2.2 de Android Studio o una posterior, Firebase Assistant es la manera más simple de conectar tu app a Firebase. Este asistente puede conectar tu proyecto o crear uno nuevo por ti con todas las dependencias de Gradle necesarias.

Si estás usando una versión más antigua de Android Studio o tienes una configuración de proyecto más compleja, puedes agregar Firebase a tu app de forma manual.

Cómo usar Firebase Assistant

Para abrir Firebase Assistant en Android Studio, haz lo siguiente:

• Haz clic en Herramientas > Firebase para abrir la ventana de Assistant.
• Haz clic para expandir una de las funciones que se muestran (por ejemplo, Analytics), y haz clic en el vínculo del instructivo proporcionado (por ejemplo, Registrar un evento de Analytics).
• Haz clic en el botón para conectarte a Firebase y agregar el código necesario a tu app.

Eso es todo. Puedes avanzar a los pasos siguientes.

Cómo agregar Firebase de forma manual

Es hora de agregar Firebase a tu app. Primero, necesitarás un proyecto y un archivo de configuración de Firebase para la app.

Para crear un proyecto de Firebase:

1. Dirígete a Firebase console.

2. Haz clic en Agregar proyecto, luego selecciona o ingresa un Nombre del proyecto.

   • Si hay un proyecto de Google existente asociado con tu app, selecciónalo desde el menú desplegable Nombre del proyecto.
   • Si no hay un proyecto de Google existente, ingresa un nuevo Nombre del proyecto.

3. (Opcional) Edita el ID del proyecto.

   Firebase asignará de manera automática un ID único a tu proyecto de Firebase. Este identificador se muestra en los servicios de Firebase visibles de forma pública, por ejemplo:

   • URL predeterminada de Realtime Database: your-project-id.firebaseio.com
   • Nombre predeterminado del depósito de Cloud Storage: your-project-id.appspot.com
   • Subdominio predeterminado de Hosting: your-project-id.firebaseapp.com

4. Sigue los pasos de configuración restantes 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. Este proceso suele tardar algunos minutos. Cuando finalice, verás la página de descripción general del proyecto en Firebase console.

Ahora que tienes un proyecto, puedes agregar tu app para Android:

1. Haz clic en Agrega Firebase a tu app para Android y sigue los pasos de la configuración. Si importas un proyecto de Google existente, es posible que esto ocurra de forma automática y solo tengas que descargar el archivo de configuración.

2. Ingresa el nombre del paquete de la app cuando se te solicite. Es importante que ingreses el ID del paquete que usa la app. Esta configuración solo puede hacerse cuando agregas la app al proyecto de Firebase.

3. 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.

   2. Traslada el archivo de configuración al mismo directorio en donde se ubica el archivo build.gradle del nivel de raíz.

4. Después de agregar el código de inicialización, ejecuta tu app para verificar con la consola que instalaste Firebase correctamente.

Agrega el SDK

Si quieres integrar las bibliotecas de Firebase a uno de tus proyectos, debes completar algunos pasos básicos para preparar tu proyecto de Android Studio. Es posible que ya lo hayas hecho en el proceso de agregar Firebase a tu app.

Primero, agrega reglas a tu archivo build.gradle de nivel de raíz para incluir el complemento de google-services y el repositorio Maven de Google:

buildscript {
    // ...
    dependencies {
        // ...
        classpath 'com.google.gms:google-services:4.2.0' // google-services plugin
    }
}

allprojects {
    // ...
    repositories {
        google() // Google's Maven repository
        // ...
    }
}

Luego, en el archivo Gradle de tu módulo (generalmente, app/build.gradle), agrega la línea apply plugin en la parte inferior del archivo para habilitar el complemento de Gradle:

apply plugin: 'com.android.application'

android {
  // ...
}

dependencies {
  // ...
  implementation 'com.google.firebase:firebase-core:16.0.7'

  // Getting a "Could not find" error? Make sure you have
  // added the Google maven respository to your root build.gradle
}

// ADD THIS AT THE BOTTOM
apply plugin: 'com.google.gms.google-services'

También debes agregar las dependencias para los SDK de Firebase que deseas usar. Te recomendamos comenzar con com.google.firebase:firebase-core, que proporciona la función de Google Analytics para Firebase. Consulta la lista de bibliotecas disponibles.

Bibliotecas disponibles

Las siguientes bibliotecas están disponibles para las distintas funciones de Firebase:

Próximos pasos

Obtén información acerca de Firebase:

• 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 in a Weekend (Firebase en un fin de semana).

Agrega funciones de Firebase a tu app:

• Obtén estadísticas sobre el comportamiento de los usuarios con Analytics.
• Configura la autenticación de usuarios con Authentication.
• Almacena información de los usuarios con Realtime Database o datos BLOB con Cloud Storage.
• Envía notificaciones a los usuarios con Cloud Messaging.
• Descubre cuándo y por qué la app falla con Crashlytics.