Android Academy · Lección

Configuración de Firebase

Conecte su aplicación a un proyecto de Firebase

Configuración de Firebase es una lección gratuita de Android Academy en CoddyKit. Esta es la lección 1 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Android Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Android Academy incluye 4 lecciones en total.

¿Qué es Firebase?

Firebase es la plataforma de desarrollo de aplicaciones de Google. Proporciona a su aplicación de Android un backend ya preparado, para que no tenga que crear y alojar sus propios servidores.

En este curso conectará una aplicación a Firebase y utilizará tres de sus servicios más populares:

Authentication — iniciar sesión con correo electrónico o Google
Cloud Firestore — una base de datos NoSQL en tiempo real
Cloud Messaging (FCM) — notificaciones push

Esta primera lección trata sobre la configuración: crear un proyecto e integrarlo en su aplicación de Android.

Crear un proyecto de Firebase

Todo comienza en la consola de Firebase, en console.firebase.google.com.

Haga clic en Add project y asígnele un nombre.
Cada proyecto de Firebase se corresponde internamente con un proyecto de Google Cloud.
Un proyecto de Firebase puede contener varias aplicaciones (Android, iOS y web).

Dentro del proyecto, registre su aplicación específica de Android mediante su application ID (nombre del paquete), por ejemplo com.coddykit.demo. Este ID permite a Firebase saber de qué aplicación procede cada solicitud.

El archivo google-services.json

Cuando registra su aplicación de Android, Firebase genera un archivo de configuración llamado google-services.json.

Descárguelo y colóquelo en la carpeta raíz del módulo de su aplicación (junto a build.gradle.kts, dentro del directorio app/).

Este archivo JSON contiene el ID del proyecto, las claves de API y los datos de registro de la aplicación. Las herramientas de compilación lo leen automáticamente; casi nunca tendrá que abrirlo manualmente.

// File location in your project:
// app/google-services.json

// It is generated for you and looks roughly like:
{
  "project_info": {
    "project_id": "my-demo-app",
    "storage_bucket": "my-demo-app.appspot.com"
  },
  "client": [
    { "client_info": { "mobilesdk_app_id": "1:1234567890:android:abc123" } }
  ]
}

Añadir el plugin de Google Services

Para que Gradle lea google-services.json, añada el plugin de Gradle de Google Services.

El enfoque moderno utiliza el bloque plugins con catálogos de versiones. Declare el plugin en el archivo de compilación raíz (con apply false) y aplíquelo después en el archivo de compilación del módulo.

// Root build.gradle.kts (project level)
plugins {
    id("com.android.application") version "8.5.0" apply false
    id("org.jetbrains.kotlin.android") version "2.0.0" apply false
    id("com.google.gms.google-services") version "4.4.2" apply false
}

Aplicar el plugin en el módulo

En el build.gradle.kts del módulo app, aplique el plugin para que procese el archivo de configuración durante la compilación.

Sin esta línea, la inicialización de Firebase fallará durante la ejecución, aunque todo lo demás sea correcto.

// app/build.gradle.kts (module level)
plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    id("com.google.gms.google-services")
}

La Firebase BoM

Firebase cuenta con muchas bibliotecas (Auth, Firestore, Messaging, Analytics...). Mantener sus versiones sincronizadas es sencillo con la Bill of Materials (BoM).

Declare la BoM una sola vez y añada después cada dependencia de Firebase sin una versión — la BoM elegirá por usted versiones compatibles.

// app/build.gradle.kts -> dependencies { }
dependencies {
    // One BoM controls all Firebase versions
    implementation(platform("com.google.firebase:firebase-bom:33.1.0"))

    // No version numbers here - the BoM decides
    implementation("com.google.firebase:firebase-auth")
    implementation("com.google.firebase:firebase-firestore")
    implementation("com.google.firebase:firebase-messaging")
}

Inicialización automática

Podría esperar tener que llamar a algo como Firebase.initialize() en su clase Application. Con el SDK moderno, normalmente no es necesario.

El plugin de Google Services genera automáticamente un proveedor de inicialización que se ejecuta al iniciar la aplicación utilizando google-services.json. Cuando se inicia su Activity, Firebase ya está listo.

// You normally do NOT need this anymore:
// FirebaseApp.initializeApp(context)

// Firebase is initialized automatically on app launch.
// You can just start using a service:
import com.google.firebase.Firebase
import com.google.firebase.firestore.firestore

val db = Firebase.firestore   // ready to use

El estilo Kotlin KTX

Firebase ofrece accessors idiomáticos de Kotlin mediante el objeto Firebase. En lugar de FirebaseFirestore.getInstance(), puede escribir Firebase.firestore.

Estas extensiones resultan más naturales de leer y son el estilo recomendado en el código moderno de Android.

import com.google.firebase.Firebase
import com.google.firebase.auth.auth
import com.google.firebase.firestore.firestore
import com.google.firebase.messaging.messaging

val auth = Firebase.auth          // FirebaseAuth
val db = Firebase.firestore       // FirebaseFirestore
val fcm = Firebase.messaging      // FirebaseMessaging

// Equivalent old style:
// val auth = FirebaseAuth.getInstance()

Añadir el permiso de Internet

Firebase se comunica con los servidores de Google, por lo que su aplicación necesita acceso a la red. Declare el permiso INTERNET en el manifiesto.

Es un permiso normal, que se concede automáticamente durante la instalación; no es necesario solicitarlo durante la ejecución.

<!-- AndroidManifest.xml -->
<manifest xmlns:android="http://schemas.android.com/apk/res/android">

    <uses-permission android:name="android.permission.INTERNET" />

    <application ... >
        <!-- activities, services -->
    </application>
</manifest>

Verificar la conexión

Una forma rápida de confirmar que la configuración funciona consiste en leer un valor o comprobar la aplicación actual de Firebase. Si Firebase no se hubiera inicializado, acceder a un servicio produciría una excepción.

Muchos desarrolladores también añaden temporalmente la dependencia de Analytics y buscan un evento en la consola como prueba rápida, pero acceder simplemente a un servicio desde el código ya demuestra que la integración funciona.

import android.util.Log
import com.google.firebase.Firebase
import com.google.firebase.firestore.firestore

fun verifyFirebase() {
    val app = Firebase.firestore.app
    Log.d("Firebase", "Connected to project: ${app.options.projectId}")
}

Errores comunes de configuración

Si Firebase no funciona, compruebe primero lo siguiente:

Nombre de paquete incorrecto — el applicationId de la aplicación debe coincidir con el que registró.
Falta google-services.json — debe estar en la carpeta app/.
Se olvidó aplicar el plugin en el archivo de compilación del módulo.
Falta el permiso INTERNET en el manifiesto.
No se ha añadido la huella SHA-1 — será necesaria más adelante para iniciar sesión con Google.

Comprobación rápida

¿Cuál es la finalidad del archivo google-services.json?

Resumen: configuración completada

Ha conectado una aplicación de Android a Firebase. Pasos principales:

Cree un proyecto en la consola de Firebase y registre su aplicación mediante el nombre del paquete.
Añada google-services.json a la carpeta app/.
Aplique el plugin de Google Services y añada la Firebase BoM, además de las bibliotecas que necesite.
Firebase se inicializa automáticamente — acceda a los servicios mediante Firebase.auth, Firebase.firestore, etc.
No olvide el permiso INTERNET.

A continuación: iniciar sesión con Firebase Authentication.

Preguntas frecuentes

¿La lección «Configuración de Firebase» es gratis?

Sí — el texto completo de «Configuración de Firebase» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Android Academy, actualiza a CoddyKit PRO. El curso de Android Academy incluye 4 lecciones en total.

¿Qué aprenderé en «Configuración de Firebase»?

Conecte su aplicación a un proyecto de Firebase Practicas Android Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar Android Academy?

No se requiere experiencia previa. Android Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 1 de 4.

¿Cuánto tiempo toma la lección «Configuración de Firebase»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de Android Academy?

Sí. Cada lección de Android Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

← Volver a Android Academy