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 posteriorcompileSdkVersion
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.
Crea un proyecto de Firebase
-
En la consola de Firebase, haz clic en Agregar proyecto.
-
Para agregar recursos de Firebase a un proyecto existente de Google Cloud, ingresa el nombre del proyecto o selecciónalo en el menú desplegable.
-
Para crear un proyecto nuevo, ingresa el nombre que quieras. También puedes editar el ID del proyecto que aparece debajo del nombre.
-
-
Si se te solicita, revisa y acepta las Condiciones de Firebase.
-
Haz clic en Continuar.
-
Opcional: Configura Google Analytics para tu proyecto para tener una experiencia óptima con cualquiera de los siguientes productos de Firebase:
Selecciona un nombre de usuario existente Cuenta de Google Analytics o para crear una cuenta nueva.
Si creas una cuenta nueva, selecciona la ubicación de los informes de Analytics. Luego, acepta la configuración de uso compartido de datos y las condiciones de Google Analytics para tu proyecto.
-
Haz clic en Crear proyecto (o Agregar Firebase si usas un proyecto de Google Cloud 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
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.
Ve a Firebase console.
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.Ingresa el nombre del paquete de tu app en el campo Nombre del paquete de Android.
¿Qué es un nombre de paquete y dónde puedes encontrarlo?
Un nombre de paquete identifica de forma única tu app en el dispositivo y en Google Play Store.
Por lo general, el nombre de paquete suele referirse al ID de aplicación.
Busca el nombre de paquete de tu app en el archivo Gradle, generalmente
app/build.gradle
(por ejemplo:com.yourcompany.yourproject
), de tu módulo (a nivel de la app).Ten en cuenta que, en esta app de Firebase para Android, el valor del nombre del paquete distingue mayúsculas de minúsculas, y no se puede cambiar después de registrarlo en el proyecto de Firebase.
Ingresa otra información de la app, como el sobrenombre y el certificado de firma SHA-1 de depuración (opcional).
¿Cómo se usan el sobrenombre de la app y el certificado de firma SHA-1 de depuración en Firebase?
Sobrenombre de la app: Es un identificador interno y conveniente que solo tú puedes ver en Firebase console.
Certificado de firma SHA-1 de depuración: Firebase Authentication (cuando se usa el Acceso con Google o el acceso con número de teléfono) y Firebase Dynamic Links requieren de un hash SHA-1.
Haz clic en Registrar app.
Paso 3: Agrega un archivo de configuración de Firebase
Descarga y, luego, agrega el archivo de configuración de Firebase para Android (
) a tu app:google-services.json Haz clic en Descargar google-services.json a fin de obtener el archivo de configuración de Firebase para Android.
Transfiere tu archivo de configuración al directorio raíz del módulo (nivel de app) de tu app.
¿Qué necesitas saber sobre este archivo de configuración?
El archivo de configuración de Firebase contiene identificadores únicos pero no secretos para el proyecto. Para obtener más información sobre este archivo de configuración, consulta la Información sobre los proyectos de Firebase.
Puedes volver a descargar el archivo de configuración de Firebase en cualquier momento.
Asegúrate de que no se hayan agregado caracteres adicionales, como
(2)
, al nombre del archivo de configuración.
Para que los SDKs de Firebase puedan acceder a los valores de tu archivo de configuración
, necesitas el complemento de los servicios de Google para Gradle (google-services.json google-services
).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):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 }
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 }
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):plugins { id("com.android.application") // Add the Google services Gradle plugin id("com.google.gms.google-services") // ... }
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
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.dependencies { // ... // Import the Firebase BoM implementation(platform("com.google.firebase:firebase-bom:33.9.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).
dependencies { // ... // Import the Firebase BoM implementation(platform("com.google.firebase:firebase-bom:33.9.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).
Después de agregar las dependencias de los productos que deseas usar, sincroniza tu proyecto de Android con los archivos de Gradle.
¿Se produce una falla de compilación respecto a la compatibilidad entre invocación y personalización y la habilitación de la expansión de sintaxis? Aquí te explicamos cómo solucionarla.
Las compilaciones de Gradle que usan la versión 4.2 o versiones anteriores del complemento de Android para Gradle (AGP) deben habilitar la compatibilidad con Java 8. De lo contrario, se produce una falla de compilación en estos proyectos de Android cuando se agrega un SDK de Firebase.
Para solucionar esta falla de compilación, puedes seguir una de estas dos opciones:
- Agrega las
compileOptions
que se indican en el mensaje de error al archivobuild.gradle.kts
obuild.gradle
a nivel de la app. - Aumenta la
minSdk
de tu proyecto de Android a 26 o una versión posterior.
Obtén más información sobre esta falla de compilación en esta sección de Preguntas frecuentes.
- Agrega las
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.
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
Abre Firebase Assistant: Herramientas > Firebase.
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 ).Haz clic en Conectarse a Firebase para conectar tu proyecto de Android con Firebase.
¿Qué hace este flujo de trabajo?
Este flujo de trabajo crea automáticamente una nueva app de Firebase para Android con el nombre del paquete de tu app. Puedes crear esta app de Firebase para Android nueva en un proyecto de Firebase existente o uno nuevo.
Aquí encontrarás algunas sugerencias para configurar tu proyecto de Firebase:
Consulta nuestras prácticas recomendadas para agregar apps a un proyecto de Firebase, incluido cómo manejar múltiples variantes.
Si creas un proyecto nuevo, te recomendamos que configures Google Analytics para él, ya que te permitirá tener una experiencia óptima con muchos productos de Firebase.
Este flujo de trabajo también agrega el archivo de configuración de Android (
) del proyecto de Firebase al directorio del módulo (nivel de app) de tu app.google-services.json
Haz clic en el botón para agregar un producto de Firebase deseado (por ejemplo,
Agrega Analytics a tu app ).
Sincroniza tu app para garantizar que todas las dependencias tengan las versiones necesarias.
En el panel Asistente, sigue las instrucciones de configuración restantes para el producto de Firebase que selecciones.
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:
Repositorio de GitHub del SDK de Firebase 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.9.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
AdMob | com.google.android.gms:play-services-ads | 23.6.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Analytics | com.google.firebase:firebase-analytics | 22.2.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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.1.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Authentication | com.google.firebase:firebase-auth | 23.2.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Cloud Firestore | com.google.firebase:firebase-firestore | 25.1.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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.4.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
NDK de Crashlytics | com.google.firebase:firebase-crashlytics-ndk | 19.4.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Complemento de Crashlytics | com.google.firebase:firebase-crashlytics-gradle | 3.0.3 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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.4 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Vertex AI in Firebase | com.google.firebase:firebase-vertexai | 16.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Bibliotecas de ML Kit para Firebase
|
Próximos pasos
Agrega los servicios de Firebase a tu 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 cuándo y por qué falla la app.
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 prácticas recomendadas para los proyectos.
Visita Más información sobre Android y Firebase si tienes preguntas sobre conceptos que no conoces o que son específicos para el desarrollo de Firebase y Android.
Explora las apps de muestra de Firebase.
Obtén experiencia práctica con el Codelab de Firebase para Android.
Obtén más información con el curso Firebase in a Weekend.
Prepárate para iniciar tu app:
- Establece alertas de presupuesto para tu proyecto en la consola de Google Cloud.
- Supervisa el panel Uso y facturación en Firebase console para obtener un panorama general del uso de tu proyecto en varios servicios de Firebase.
- Revisa la Lista de tareas para el lanzamiento de Firebase.
¿Tienes problemas con Firebase y tu proyecto de Android? Visita la página de Preguntas frecuentes y solución de problemas de Android.