Documentación Técnica | Snake Islands

Stack Tecnológico

Selección de herramientas para rendimiento nativo y escalabilidad.

⚡ Core Framework

Flutter 3.28.9 para renderizado UI de alto rendimiento y compilación nativa en ARM64.

🎮 Game Engine

Flame Engine. Implementación de Game Loop, ECS (Entity Component System) y física 2D.

💰 Monetización

Integración híbrida: Google Mobile Ads (Interstitial/Reward) + In-App Purchases.

🌐 Multiplataforma

Código base único desplegado en Android, iOS, macOS y Windows con adaptación de inputs.

Dependencias Clave

Librerías esenciales utilizadas en pubspec.yaml.

flame

flame_audio

google_mobile_ads

in_app_purchase

shared_preferences

flutter_native_splash

games_services

flutter_localization

package_info_plus

url_launcher

animate_do

intl

liquid_glass_renderer

flutter_displaymode

cupertino_icons

Arquitectura del Proyecto

Estructura modular separando la lógica del juego (Flame) de la interfaz de usuario (Flutter Widgets).

lib/
├── main.dart // Punto de entrada e inyección de dependencias
├── game/ // Núcleo del Game Loop (Flame)
│   ├── components/ // Entidades: Player, Enemies, Items, Backgrounds
│   └── managers/ // Lógica: GameManager, SpawnManager, ScoreManager
├── screens/ // UI Layer (Widgets): Menu, Settings, GameOver
├── services/ // Servicios externos: Storage, Audio, Ads, IAP
└── l10n/ // Archivos de internacionalización (ARB)
                

Patrones de Diseño

Component-Based: Uso extensivo de componentes de Flame para composición de entidades.
Service Locator: GetIt (implícito) o Singletons para gestión de audio y preferencias.
State Management: Gestión de estado reactivo para UI híbrida (Game widget + Flutter overlays).

Optimización

Object Pooling: Reutilización de enemigos y proyectiles para evitar Garbage Collection spikes.
Sprite Batching: Renderizado eficiente de elementos repetitivos.
Display Mode: Soporte para pantallas de alta tasa de refresco (90Hz/120Hz).

Ficha Técnica

Motor de física 2D personalizado sobre Flame.
Sistema de Audio Engine posicional.
Persistencia de datos local encriptada.
Soporte de localización dinámica (i18n).

Integración de Leaderboards nativos (Game Center / Play Games).
Pipeline de assets optimizado (.webp / .ogg).
Control de versiones con Git + GitHub Actions (CI/CD).
Arquitectura Scalable Folder Structure.

Arquitectura Técnica