onlinces/hackathon-acapulquitos-boys-c201275836cb46a5a486451f9caa83f5

Fork 0

Table of Contents

Requisitos Previos

🐍 Python 3.10+

Verificar instalación
Instalar (si no lo tienes)

🦋 Flutter 3.44 (o 3.22 LTS)

Verificar instalación
Instalar Flutter

📦 FVM (Flutter Version Manager) — RECOMENDADO

Instalar FVM
Configurar en el proyecto
Usar FVM en comandos
Configurar IDE para usar FVM

☕ Java JDK 17 (para Android)

Verificar instalación
Por qué Java 17 (y NO 21)
Instalar Java 17
Verificar que Gradle use Java 17

📱 Android Studio

Descargar e instalar
Configurar después de instalar
Aceptar licencias

🔧 Git

Verificar instalación
Instalar (si no lo tienes)
Configurar credenciales (primera vez)

🌐 Postman o Thunder Client (opcional)
✅ Verificar que todo funciona

Backend (Python)
Flutter
FVM (si lo instalaste)
Java
Git

🚨 Problemas comunes

"flutter: command not found"
"JAVA_HOME is not set"
"Android licenses not accepted"
FVM no encuentra Flutter

Siguiente paso

Requisitos Previos

Antes de empezar, asegúrate de tener todo esto instalado y configurado.

🐍 Python 3.10+

Verificar instalación

python --version
# Debe mostrar: Python 3.10.x o superior

Instalar (si no lo tienes)

Linux/macOS:

sudo apt update && sudo apt install python3 python3-pip  # Ubuntu/Debian
# o
brew install python@3.10  # macOS con Homebrew

Windows: Descarga desde python.org e instala con "Add to PATH" marcado.

🦋 Flutter 3.44 (o 3.22 LTS)

Verificar instalación

flutter --version
# Debe mostrar: Flutter 3.44.0 o Flutter 3.22.0 (si bajaron versión)

Instalar Flutter

Sigue la guía oficial: flutter.dev/get-started/install

Linux/macOS rápido:

git clone https://github.com/flutter/flutter.git -b stable
export PATH="$PATH:`pwd`/flutter/bin"
flutter doctor

Windows: Descarga el ZIP desde flutter.dev, descomprime y agrega flutter\bin al PATH.

📦 FVM (Flutter Version Manager) — RECOMENDADO

FVM permite que todos usen exactamente la misma versión de Flutter sin conflictos.

Instalar FVM

dart pub global activate fvm

Configurar en el proyecto

cd basura_app
fvm install 3.44.0      # o 3.22.0 según decisión del equipo
fvm use 3.44.0

Esto crea .fvm/fvm_config.json en el repo (debe commitearse).

Usar FVM en comandos

Prefija todos los comandos con fvm:

fvm flutter pub get
fvm flutter run
fvm flutter build apk

Configurar IDE para usar FVM

Android Studio:

Settings → Languages & Frameworks → Flutter
Flutter SDK path: <tu-proyecto>/.fvm/flutter_sdk

VS Code:

Abre .vscode/settings.json

Agrega:

{
  "dart.flutterSdkPath": ".fvm/flutter_sdk"
}

☕ Java JDK 17 (para Android)

Verificar instalación

java -version
# Debe mostrar: openjdk version "17.x.x"

Por qué Java 17 (y NO 21)

Java 21 puede causar problemas con Android Gradle. Java 17 es el estándar recomendado para Flutter + Android.

Instalar Java 17

Linux:

sudo apt install openjdk-17-jdk
sudo update-alternatives --config java  # selecciona Java 17

macOS:

brew install openjdk@17
# Agregar al PATH según instrucciones de Homebrew

Windows: Descarga desde Adoptium e instala.

Verificar que Gradle use Java 17

cd basura_app/android
./gradlew --version
# Debería mostrar JVM: 17.x.x

📱 Android Studio

Necesario para:

Android SDK
Emuladores
Gradle
Plugin de Flutter/Dart

Descargar e instalar

developer.android.com/studio

Configurar después de instalar

Abrir Android Studio
Settings → Plugins → instalar Flutter y Dart
SDK Manager → instalar Android SDK Platform API 34 (mínimo)
AVD Manager → crear un emulador (Pixel 6 / API 34)

Aceptar licencias

flutter doctor --android-licenses
# Escribe "y" a todo

🔧 Git

Verificar instalación

git --version
# Debe mostrar: git version 2.x.x

Instalar (si no lo tienes)

Linux:

sudo apt install git

macOS:

brew install git

Windows: Descarga desde git-scm.com

Configurar credenciales (primera vez)

git config --global user.name "Tu Nombre"
git config --global user.email "tu@email.com"

🌐 Postman o Thunder Client (opcional)

Para probar endpoints del backend sin Flutter.

Postman: postman.com/downloads
Thunder Client: Extensión de VS Code (más ligero)

✅ Verificar que todo funciona

Backend (Python)

python --version
pip --version

Flutter

flutter doctor -v
# Todo debe estar en [✓] excepto opcionales como Xcode (si no estás en macOS)

FVM (si lo instalaste)

fvm --version
fvm list

Java

java -version
# Confirmar que es Java 17

Git

git --version

🚨 Problemas comunes

"flutter: command not found"

Asegúrate que flutter/bin esté en tu PATH
Reinicia la terminal después de editar .bashrc o .zshrc

"JAVA_HOME is not set"

# Linux/macOS
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
# (ajusta la ruta según tu instalación)

# Windows (PowerShell)
$env:JAVA_HOME = "C:\Program Files\Java\jdk-17"

"Android licenses not accepted"

flutter doctor --android-licenses

FVM no encuentra Flutter

# Reinstalar FVM
dart pub global deactivate fvm
dart pub global activate fvm

# Reinstalar versión
fvm install 3.44.0

Siguiente paso

Una vez que todo esté instalado: