☁️ Configuración de Firebase ☁️ Firebase Setup

Guía paso a paso para habilitar funciones en la nube Step-by-step guide to enable cloud features

Prerrequisitos Prerequisites

Paso 1: Crear Proyecto Firebase Step 1: Create Firebase Project

Configuración Inicial Initial Setup

  1. Ve a Firebase Console Go to Firebase Console
  2. Haz clic en "Crear un proyecto" o "Agregar proyecto" Click "Create a project" or "Add project"
  3. Ingresa el nombre del proyecto: classicgame-dk (o tu nombre preferido) Enter project name: classicgame-dk (or your preferred name)
  4. Habilita Google Analytics (opcional) Enable Google Analytics (optional)
  5. Haz clic en "Crear proyecto" Click "Create project"

Paso 2: Habilitar Autenticación

Configurar Métodos de Autenticación

  1. En tu proyecto Firebase, ve a Authentication
  2. Haz clic en "Comenzar"
  3. Ve a la pestaña Método de inicio de sesión
  4. Habilita los siguientes proveedores:
    • Correo/Contraseña: Habilitar
    • Google: Habilitar y configurar pantalla de consentimiento OAuth

Configuración OAuth de Google

Configurar Proveedor Google

  1. Haz clic en el proveedor Google
  2. Habilita el interruptor
  3. Agrega tu correo de soporte del proyecto
  4. Guarda la configuración
  5. Anota el ID de cliente web y secreto de cliente web

Paso 3: Configurar Realtime Database

Crear Base de Datos

  1. Ve a Realtime Database en Firebase Console
  2. Haz clic en "Crear base de datos"
  3. Elige ubicación (preferiblemente la más cercana a tus usuarios)
  4. Comienza en modo de prueba (puedes asegurarlo después) Start in test mode (you can secure it later)
  5. Tu URL de base de datos será: https://tu-project-id-default-rtdb.firebaseio.com/ Your database URL will be: https://your-project-id-default-rtdb.firebaseio.com/

Paso 4: Obtener Credenciales de Configuración Step 4: Get Configuration Credentials

Clave API Web Web API Key

Obtener Clave API Get API Key

  1. Ve a Configuración del proyecto (ícono de engranaje) Go to Project settings (gear icon)
  2. En la pestaña General, desplázate a "Tus aplicaciones" In the General tab, scroll to "Your apps"
  3. Si no existe una aplicación web, haz clic en "Agregar aplicación" y selecciona el ícono web (</>) If no web app exists, click "Add app" and select the web icon (</>)
  4. Registra tu aplicación con un apodo Register your app with a nickname
  5. Copia la Clave API del objeto de configuración Copy the API Key from the configuration object

Paso 5: Configurar Variables de Entorno Step 5: Configure Environment Variables

Configurar Archivo .env Configure .env File

Copia el archivo de ejemplo de entorno: Copy the environment example file:

cp .env.example .env

Edita el archivo .env con tus credenciales: Edit the .env file with your credentials:

# Configuración Firebase# Firebase Configuration
FIREBASE_API_KEY=tu_api_key_aqui
FIREBASE_AUTH_DOMAIN=tu-project-id.firebaseapp.com
FIREBASE_DATABASE_URL=https://tu-project-id-default-rtdb.firebaseio.com/
FIREBASE_PROJECT_ID=tu-project-id
FIREBASE_STORAGE_BUCKET=tu-project-id.appspot.com
FIREBASE_MESSAGING_SENDER_ID=tu_sender_id
FIREBASE_APP_ID=tu_app_id

# OAuth de Google# Google OAuth
GOOGLE_CLIENT_ID=tu_google_client_id.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=tu_google_client_secret

Solución de Problemas Troubleshooting

Problemas Comunes Common Issues

1. "Clave API no válida" 1. "Invalid API Key"

  • Verifica tu clave API en .env Check your API key in .env
  • Comprueba si la clave API está habilitada para tu proyecto Check if the API key is enabled for your project

2. "Permiso denegado" 2. "Permission denied"

  • Verifica las reglas de seguridad de tu base de datos Check your database security rules
  • Asegúrate de que el usuario esté autenticado Make sure the user is authenticated

Funcionalidades Habilitadas Enabled Features

Leaderboards Globales Global Leaderboards

Una vez configurado Firebase, el juego automáticamente: Once Firebase is configured, the game automatically:

Guardado en la Nube Cloud Saves

Los jugadores pueden: Players can:

Conclusión Conclusion

Con Firebase configurado correctamente, tu juego Donkey Kong Classic tendrá capacidades completas en la nube, incluyendo: With Firebase properly configured, your Donkey Kong Classic game will have complete cloud capabilities, including:

Esta configuración transforma tu juego local en una experiencia conectada y social, manteniendo la simplicidad del gameplay clásico mientras agrega características modernas que los jugadores esperan. This setup transforms your local game into a connected and social experience, maintaining the simplicity of classic gameplay while adding modern features that players expect.