¿Cómo instalar Flutter y configurar tu entorno de desarrollo?

Instalar Flutter significa descargar el SDK oficial, configurar Android Studio y verificar que todo funcione con el comando flutter doctor.

Requisitos previos

Antes de instalar, confirma que tu computadora cumple estos requisitos mínimos:

Si tu equipo tiene menos de 8 GB de RAM, Flutter funcionará, pero Android Studio será lento.

Paso 1: Descargar el Flutter SDK

El Flutter SDK es el conjunto de herramientas que necesitas para compilar, ejecutar y depurar tus apps.

Sigue estos pasos:

1. Entra a flutter.dev y haz clic en "Get Started".
2. Selecciona tu sistema operativo (Windows o macOS).
3. Descarga el archivo .zip del SDK estable más reciente.
4. Extrae el archivo en una carpeta sin espacios ni caracteres especiales.

Ejemplo en Windows: Extrae el SDK en C:\flutter. No uses C:\Program Files\flutter porque la ruta tiene un espacio.

Ejemplo en macOS: Extrae el SDK en ~/development/flutter. Evita rutas con acentos como ~/Código/flutter.

Agregar Flutter al PATH

El PATH es la variable del sistema que le dice a tu terminal dónde encontrar los comandos de Flutter.

En Windows:

1. Busca "Variables de entorno" en el menú de inicio.
2. Edita la variable Path del usuario.
3. Agrega la ruta C:\flutter\bin.
4. Guarda y reinicia tu terminal.

En macOS (con zsh): Abre la terminal y ejecuta:

echo 'export PATH="$PATH:~/development/flutter/bin"' >> ~/.zshrc
source ~/.zshrc

Verifica que Flutter esté disponible con:

flutter --version

Deberías ver algo como: Flutter 3.x.x • channel stable.

Paso 2: Instalar Android Studio

Android Studio es el IDE oficial de Google para desarrollar apps Android y es la herramienta recomendada para Flutter.

1. Descarga Android Studio desde developer.android.com/studio.
2. Ejecuta el instalador y sigue el asistente de configuración.
3. En la pantalla "Install Type", elige "Standard" para instalar el Android SDK automáticamente.
4. Acepta todas las licencias de los componentes del SDK.

La descarga total puede superar los 4 GB. Si tienes internet de TELMEX con velocidad básica, puede tardar entre 30 y 60 minutos.

Instalar el plugin de Flutter y Dart

Dentro de Android Studio:

1. Ve a File → Settings (Windows) o Android Studio → Preferences (macOS).
2. Selecciona Plugins en el menú izquierdo.
3. Busca "Flutter" en el Marketplace.
4. Haz clic en Install. Android Studio instalará el plugin de Dart automáticamente.
5. Reinicia Android Studio cuando te lo solicite.

Dato importante: Si no instalas el plugin de Dart, Android Studio no reconocerá la sintaxis de tus archivos .dart.

Paso 3: Crear un emulador de Android

Un emulador es una máquina virtual que simula un teléfono Android en tu computadora.

1. En Android Studio, abre el Device Manager (ícono de teléfono en la barra lateral derecha).
2. Haz clic en "Create Device".
3. Elige un modelo de teléfono, por ejemplo Pixel 6.
4. Descarga la imagen del sistema API 33 (Android 13).
5. Finaliza la configuración y presiona el botón Play para iniciar el emulador.

El emulador consume mucha RAM. Cierra otras aplicaciones mientras lo usas.

Paso 4: Verificar la instalación con flutter doctor

flutter doctor es el comando que revisa tu entorno y te dice exactamente qué falta por configurar.

Ejecuta en tu terminal:

flutter doctor

Verás una lista de verificaciones con símbolos:

Ejemplo de salida exitosa:

Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.19.0)
[✓] Android toolchain - develop for Android devices
[✓] Android Studio (version 2023.1)
[✓] Connected device (1 available)
[✓] Network resources

Si ves todos los símbolos en verde, tu entorno está listo para crear apps.

Configuración adicional en macOS para iOS

En macOS, puedes crear apps para iPhone además de Android. Necesitas instalar Xcode.

1. Descarga Xcode desde la App Store (es gratis, pero pesa más de 10 GB).
2. Abre Xcode y acepta los términos de licencia.
3. En la terminal, ejecuta:

sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -runFirstLaunch

4. Instala CocoaPods con:

sudo gem install cocoapods

Después de esto, flutter doctor debería mostrar el ítem de Xcode en verde.

Errores comunes

Error 1: "flutter" no se reconoce como comando

Causa: El PATH no se configuró correctamente o la terminal no se reinició.

Solución en Windows: Cierra y vuelve a abrir PowerShell. Verifica que C:\flutter\bin aparezca en tus variables de entorno.

Solución en macOS: Ejecuta source ~/.zshrc o abre una nueva ventana de terminal. Confirma con echo $PATH que la ruta de Flutter aparece en la lista.

Error 2: Android toolchain - licenses not accepted

Causa: No aceptaste las licencias del Android SDK durante la instalación.

Solución: Ejecuta este comando y acepta todas las licencias:

flutter doctor --android-licenses

Escribe y y presiona Enter para cada licencia que aparezca.

Error 3: El emulador no arranca o es extremadamente lento

Causa: Tu procesador no tiene virtualización habilitada en la BIOS, o tu equipo tiene poca RAM disponible.

Solución A: Reinicia tu computadora, entra a la BIOS y habilita Intel VT-x o AMD-V.

Solución B: En lugar del emulador, conecta tu teléfono Android físico mediante USB. Habilita las opciones de desarrollador y la depuración USB en tu teléfono. Flutter detectará el dispositivo automáticamente cuando ejecutes flutter doctor.

Error 4: CocoaPods no instalado (macOS)

Causa: Ruby del sistema en macOS moderno no incluye permisos para instalar gems globales.

Solución: Instala CocoaPods con Homebrew en lugar de Ruby:

brew install cocoapods

Tu primera verificación completa

Una vez que flutter doctor muestre todo en verde, crea tu primer proyecto de prueba:

flutter create app_prueba
cd app_prueba
flutter run

Flutter compilará una app de contador por defecto. Si se abre en el emulador o en tu teléfono, tu entorno está correctamente configurado.

Esta app de contador es el punto de partida estándar de Flutter. En las siguientes lecciones la modificarás para construir tu propia interfaz.

Resumen de pasos de instalación

Seguir este orden reduce la posibilidad de errores durante la instalación.