Instala Flutter

Instalación de Flutter

Antes de empezar cualquier proyecto Flutter necesitas el SDK instalado y verificado en tu sistema. Esta guía cubre la instalación en macOS, Windows y Linux, y cómo confirmar que todo quedó bien configurado con flutter doctor.

Tabla de contenidos

1. Instalación de Flutter
   • macOS
   • Windows
   • Linux
2. Verificar la instalación con Flutter Doctor
3. Recursos adicionales

1. Instalación de Flutter

Flutter se instala descargando el SDK y agregándolo al PATH del sistema. A continuación el proceso para cada plataforma.

macOS

Opción A: Homebrew (recomendada)

brew install --cask flutter

Opción B: Descarga manual

1. Descarga el SDK desde flutter.dev/docs/get-started/install/macos.
2. Extrae el archivo .zip en una carpeta, por ejemplo:

cd ~/development
unzip ~/Downloads/flutter_macos_*-stable.zip

3. Agrega Flutter al PATH. Edita tu ~/.zshrc (o ~/.bash_profile si usas bash):

export PATH="$PATH:$HOME/development/flutter/bin"

4. Recarga la configuración del shell:

source ~/.zshrc

Dependencias adicionales en macOS:

# Xcode (para compilar en iOS)
xcode-select --install
sudo xcodebuild -runFirstLaunch

# CocoaPods (para dependencias nativas iOS)
sudo gem install cocoapods

Windows

1. Descarga el SDK desde flutter.dev/docs/get-started/install/windows.
2. Extrae el .zip en una carpeta que no requiera permisos de administrador, por ejemplo C:\src\flutter (evita Program Files).
3. Agrega C:\src\flutter\bin a la variable de entorno Path:
   • Busca "Editar las variables de entorno del sistema" en el menú de inicio.
   • En "Variables de usuario", selecciona Path → Editar → Nuevo.
   • Agrega la ruta C:\src\flutter\bin.
4. Cierra y vuelve a abrir la terminal (PowerShell o CMD) para que tome los cambios.

Alternativa con Winget:

winget install --id=Google.Flutter -e

Dependencias adicionales en Windows:

• Git for Windows.
• Visual Studio con la carga de trabajo "Desarrollo para el escritorio con C++" (necesario para Windows desktop).
• Android Studio si vas a compilar para Android.

Linux

1. Descarga el SDK desde flutter.dev/docs/get-started/install/linux.
2. Extrae el archivo en tu carpeta de desarrollo:

cd ~/development
tar xf ~/Descargas/flutter_linux_*-stable.tar.xz

3. Agrega Flutter al PATH. Edita tu ~/.bashrc o ~/.zshrc:

export PATH="$PATH:$HOME/development/flutter/bin"

4. Recarga la configuración:

source ~/.bashrc

Dependencias adicionales en Linux (Debian/Ubuntu):

sudo apt-get update
sudo apt-get install -y curl git unzip xz-utils zip libglu1-mesa \
  clang cmake ninja-build pkg-config libgtk-3-dev

Nota: también puedes instalar Flutter mediante snap:

sudo snap install flutter --classic

2. Verificar la instalación con Flutter Doctor

Independientemente de la plataforma, ejecuta:

flutter doctor

Este comando revisa tu entorno y te dice qué falta configurar (SDK de Android, Xcode, licencias, dispositivos conectados, etc.). Resuelve cada punto marcado con [!] o [✗] antes de continuar. Ejemplo de salida esperada:

Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.x.x, on macOS 15.x)
[✓] Android toolchain - develop for Android devices
[✓] Xcode - develop for iOS and macOS
[✓] Chrome - develop for the web
[✓] Android Studio (version 2024.x)
[✓] VS Code
[✓] Connected device
[✓] Network resources

• No issues found!

Si usas Android, acepta las licencias con:

flutter doctor --android-licenses

3. Recursos adicionales

• Documentación oficial de Flutter: Get started
• Instalación en macOS
• Instalación en Windows
• Instalación en Linux
• Con Flutter ya instalado, sigue con Golden Testing en Flutter para aprender a validar la UI de tus apps con bc_golden_plugin.