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 segmenta al nivel de API 19 (KitKat) o superior.
- Usa Android 4.4 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 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 SDK 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.
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.
Dirígete 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.
Ingresa otra información de la app, como el sobrenombre y el certificado de firma SHA-1 de depuración (opcional).
Haz clic en Registrar app.
Paso 3: Agrega un archivo de configuración de Firebase
Agrega el archivo de configuración de Firebase para Android a la app, como se indica a continuación:
Haz clic en Descargar google-services.json a fin de obtener el archivo de configuración de Firebase para Android (
).google-services.json Transfiere tu archivo de configuración al directorio del módulo (nivel de app) de tu app.
Agrega el complemento de google-services a tus archivos Gradle a fin de habilitar los productos de Firebase en tu app.
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.10' // Google Services plugin } } allprojects { // ... repositories { // Check that you have the following line (if not, add it): google() // Google's Maven repository // ... } }
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
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:30.1.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:30.1.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:30.1.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' }
Kotlin+KTX
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:30.1.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' }
Si usas la BoM de Firebase para Android, tu app siempre utilizará versiones compatibles de las bibliotecas de Firebase para Android.
Sincroniza tu app para garantizar que todas las dependencias tengan las versiones necesarias.
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.
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:
Documentación de referencia (Java | Kotlin+KTX)
Repositorio de GitHub del SDK de Firebase 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 asignan a una versión específica de la BoM, revisa las notas de la versión de la BoM. |
30.1.0 | |
AdMob | com.google.android.gms:play-services-ads | 21.0.0 | |
Analytics | com.google.firebase:firebase-analytics | 21.0.0 | |
Proveedor personalizado de la Verificación de aplicaciones | com.google.firebase:firebase-appcheck | 16.0.0 | |
Proveedor de depuración para la Verificación de aplicaciones | com.google.firebase:firebase-appcheck-debug | 16.0.0 | |
Proveedor de Play Integrity para Verificación de aplicaciones | com.google.firebase:firebase-appcheck-playintegrity | 16.0.0 | |
Proveedor de SafetyNet para la Verificación de aplicaciones | com.google.firebase:firebase-appcheck-safetynet | 16.0.0 | |
App Distribution | com.google.firebase:firebase-appdistribution | 16.0.0-beta03 | |
API de App Distribution | com.google.firebase:firebase-appdistribution-api | 16.0.0-beta03 | |
Complemento de App Distribution | com.google.firebase:firebase-appdistribution-gradle | 3.0.2 | |
Authentication | com.google.firebase:firebase-auth | 21.0.5 | |
Cloud Firestore | com.google.firebase:firebase-firestore | 24.1.2 | |
SDK cliente de Cloud Functions para Firebase | com.google.firebase:firebase-functions | 20.1.0 | |
Cloud Messaging | com.google.firebase:firebase-messaging | 23.0.5 | |
Cloud Storage | com.google.firebase:firebase-storage | 20.0.1 | |
Crashlytics | com.google.firebase:firebase-crashlytics | 18.2.11 | |
NDK de Crashlytics | com.google.firebase:firebase-crashlytics-ndk | 18.2.11 | |
Complemento de Crashlytics | com.google.firebase:firebase-crashlytics-gradle | 2.9.0 | |
Compatibilidad con módulos de funciones dinámicas | com.google.firebase:firebase-dynamic-module-support | 16.0.0-beta01 | |
Dynamic Links | com.google.firebase:firebase-dynamic-links | 21.0.1 | |
In‑App Messaging | com.google.firebase:firebase-inappmessaging | 20.1.2 | (obligatorio) |
Visualización de In‑App Messaging | com.google.firebase:firebase-inappmessaging-display | 20.1.2 | (obligatorio) |
Instalaciones de Firebase | com.google.firebase:firebase-installations | 17.0.1 | |
API de Firebase ML Model Downloader | com.google.firebase:firebase-ml-modeldownloader | 24.0.3 | |
Performance Monitoring | com.google.firebase:firebase-perf | 20.1.0 | |
Complemento de Performance Monitoring | com.google.firebase:perf-plugin | 1.4.1 | |
Realtime Database | com.google.firebase:firebase-database | 20.0.5 | |
Remote Config | com.google.firebase:firebase-config | 21.1.0 | |
Complemento de Servicios de Google Play | com.google.gms:google-services | 4.3.10 | |
Bibliotecas obsoletas | |||
App Indexing | com.google.firebase:firebase-appindexing | 20.0.0 | |
API de Firebase ML Custom Model | com.google.firebase:firebase-ml-model-interpreter | 22.0.4 | |
API de Firebase ML Vision | com.google.firebase:firebase-ml-vision | 24.1.0 | |
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 asignan a una versión específica de la BoM, revisa las notas de la versión de la BoM. |
30.1.0 | |
AdMob | com.google.android.gms:play-services-ads | 21.0.0 | |
Analytics | com.google.firebase:firebase-analytics-ktx | 21.0.0 | |
Proveedor personalizado de la Verificación de aplicaciones | com.google.firebase:firebase-appcheck | 16.0.0 | |
Proveedor de depuración para la Verificación de aplicaciones | com.google.firebase:firebase-appcheck-debug | 16.0.0 | |
Proveedor de SafetyNet para la Verificación de aplicaciones | com.google.firebase:firebase-appcheck-safetynet | 16.0.0 | |
API de App Distribution | com.google.firebase:firebase-appdistribution-api-ktx | 16.0.0-beta03 | |
Complemento de App Distribution | com.google.firebase:firebase-appdistribution-gradle | 3.0.2 | |
Authentication | com.google.firebase:firebase-auth-ktx | 21.0.5 | |
Cloud Firestore | com.google.firebase:firebase-firestore-ktx | 24.1.2 | |
SDK cliente de Cloud Functions para Firebase | com.google.firebase:firebase-functions-ktx | 20.1.0 | |
Cloud Messaging | com.google.firebase:firebase-messaging-ktx | 23.0.5 | |
Cloud Storage | com.google.firebase:firebase-storage-ktx | 20.0.1 | |
Crashlytics | com.google.firebase:firebase-crashlytics-ktx | 18.2.11 | |
NDK de Crashlytics | com.google.firebase:firebase-crashlytics-ndk | 18.2.11 | |
Complemento de Crashlytics | com.google.firebase:firebase-crashlytics-gradle | 2.9.0 | |
Compatibilidad con módulos de funciones dinámicas | com.google.firebase:firebase-dynamic-module-support | 16.0.0-beta01 | |
Dynamic Links | com.google.firebase:firebase-dynamic-links-ktx | 21.0.1 | |
In‑App Messaging | com.google.firebase:firebase-inappmessaging-ktx | 20.1.2 | (obligatorio) |
Visualización de In‑App Messaging | com.google.firebase:firebase-inappmessaging-display-ktx | 20.1.2 | (obligatorio) |
Instalaciones de Firebase | com.google.firebase:firebase-installations-ktx | 17.0.1 | |
API de Firebase ML Model Downloader | com.google.firebase:firebase-ml-modeldownloader-ktx | 24.0.3 | |
Performance Monitoring | com.google.firebase:firebase-perf-ktx | 20.1.0 | |
Complemento de Performance Monitoring | com.google.firebase:perf-plugin | 1.4.1 | |
Realtime Database | com.google.firebase:firebase-database-ktx | 20.0.5 | |
Remote Config | com.google.firebase:firebase-config-ktx | 21.1.0 | |
Complemento de Servicios de Google Play | com.google.gms:google-services | 4.3.10 | |
Bibliotecas obsoletas | |||
App Indexing | com.google.firebase:firebase-appindexing | 20.0.0 | |
API de Firebase ML Custom Model | com.google.firebase:firebase-ml-model-interpreter | 22.0.4 | |
API de Firebase ML Vision | com.google.firebase:firebase-ml-vision | 24.1.0 | |
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 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 en un fin de semana.
Prepárate para iniciar la app:
- Configura alertas de presupuesto para tu proyecto en Google Cloud Console.
- Supervisa el panel Uso y facturación en Firebase console para obtener una descripción 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.