Esta guía está diseñada para principiantes que desean instalar Flutter y Dart para desarrollar aplicaciones multiplataforma. Flutter es un framework de código abierto de Google que permite crear aplicaciones para iOS, Android, web, desktop y más con un solo código base. Dart, el lenguaje de programación de Flutter, está incluido en el SDK de Flutter, pero también se puede instalar de forma independiente para proyectos como scripts CLI o servidores.

La guía está organizada en secciones claras con pasos numerados, requisitos específicos por plataforma, consejos prácticos, advertencias y soluciones a problemas comunes. Cubre la instalación en Windows, macOS y Linux, incluyendo el uso de Chocolatey en Windows para una instalación simplificada. Se basa en la versión estable más reciente de Flutter (hasta septiembre de 2025, como Flutter 3.35 o superior). Verifica siempre la documentación oficial en docs.flutter.dev para actualizaciones.

---

Requisitos Generales

Antes de instalar Flutter o Dart, asegúrate de cumplir con estos requisitos comunes:

• Sistema operativo: 64 bits (Windows 10+, macOS 13+, Ubuntu 20.04+ u otra distribución Linux compatible).
• RAM: Mínimo 4 GB (recomendado 8 GB o más para mejor rendimiento).
• Espacio en disco:
  • Flutter SDK: ~2 GB.
  • Dart SDK (independiente, si aplica): ~200 MB.
  • Herramientas adicionales (Android Studio, Xcode): 3-5 GB.
• Conexión a internet: Necesaria para descargas y dependencias.
• Git: Requerido para Flutter. Descarga desde git-scm.com.
• Java Development Kit (JDK): Versión 11 o superior para Android. Descarga desde oracle.com.
• Permisos: Acceso de administrador para configurar variables de entorno.

Advertencia: En China, usa mirrors locales debido a restricciones de red. Consulta la documentación oficial para detalles.

Consejo práctico: Usa una terminal con privilegios elevados (PowerShell como administrador en Windows, sudo en macOS/Linux si es necesario) para evitar problemas de permisos.

---

Instalación de Dart (Opcional)

Dart está incluido en el SDK de Flutter, por lo que no es necesario instalarlo por separado si solo usarás Flutter. Sin embargo, si planeas usar Dart para proyectos independientes (como aplicaciones de consola o servidores), sigue estos pasos.

Requisitos

• Igual que los requisitos generales (sección 1).
• Plataformas soportadas: Windows, macOS, Linux (64 bits).

Instalación manual

1. Descargar Dart SDK:

   • Visita dart.dev/get-dart.
   • Descarga la versión estable más reciente (ej: Dart 3.5.x):
     • Windows: ZIP (ej: dart-sdk-windows-x64-release.zip).
     • macOS/Linux: ZIP o TAR (ej: dart-sdk-macos-x64-release.zip o dart-sdk-linux-x64-release.tar.gz).

2. Extraer el archivo:

   • Windows: Extrae el ZIP en C:\tools\dart-sdk.
   • macOS:

     unzip ~/Downloads/dart-sdk-macos-x64-release.zip -d ~/development/dart-sdk
     

   • Linux:

     tar -xzf ~/Downloads/dart-sdk-linux-x64-release.tar.gz -C ~/development/dart-sdk
     

3. Configurar PATH:

   • Windows:
     • Busca “Variables de entorno” en el menú de inicio.
     • Edita “Path” en “Variables de usuario” y agrega: C:\tools\dart-sdk\bin.
     • Reinicia la terminal.
   • macOS:
     • Edita ~/.zshrc:

       nano ~/.zshrc
       

     • Agrega: export PATH="$PATH:$HOME/development/dart-sdk/bin".
     • Guarda y aplica: source ~/.zshrc.
   • Linux:
     • Edita ~/.bashrc:

       nano ~/.bashrc
       

     • Agrega: export PATH="$PATH:$HOME/development/dart-sdk/bin".
     • Aplica: source ~/.bashrc.

4. Verificar instalación:

   • Ejecuta:

     dart --version
     

   • Deberías ver: Dart SDK version: 3.5.0 (stable).

Gestores de paquetes

• Windows (con Chocolatey, ver sección 3.1):

  choco install dart-sdk
  

• macOS (con Homebrew):

  brew tap dart-lang/dart
  brew install dart
  

• Linux (Debian/Ubuntu con apt):
  • Agrega el repositorio:

    sudo apt-get update
    sudo apt-get install apt-transport-https
    wget -qO- https://dl-ssl.google.com/linux/linux_signing_key.pub | sudo gpg --dearmor -o /usr/share/keyrings/dart.gpg
    echo 'deb [signed-by=/usr/share/keyrings/dart.gpg arch=amd64] https://storage.googleapis.com/download.dartlang.org/linux/debian stable main' | sudo tee /etc/apt/sources.list.d/dart_stable.list
    

  • Instala:

    sudo apt-get update
    sudo apt-get install dart
    

Solución de Problemas

• Comando dart no reconocido: Verifica PATH con echo %PATH% (Windows) o echo $PATH (macOS/Linux).
• Versión antigua: Actualiza con dart pub global activate dart.
• Conflictos con Flutter: La versión de Dart de Flutter tiene prioridad. Usa flutter dart para comandos específicos.

Consejo práctico: Omite esta sección si solo usarás Flutter, ya que Dart está incluido.

---

Instalación de Flutter

Flutter incluye Dart, por lo que esta sección instala ambos. Ofrecemos métodos manuales para todas las plataformas y una opción con Chocolatey para Windows.

Windows

Requisitos Específicos

• Windows 10+ (64 bits).
• PowerShell 5.0+ (preinstalado).
• Git para Windows (git-scm.com).
• JDK 11+ para Android (oracle.com).

Opción 1: Instalación Manual

1. Descargar Flutter SDK:

   • Visita docs.flutter.dev/get-started/install/windows.
   • Descarga el ZIP estable (ej: flutter_windows_3.x.x-stable.zip).
   • Extrae en C:\src\flutter (evita C:\Program Files).

2. Configurar PATH:

   • Busca “Variables de entorno” en el menú de inicio.
   • Edita “Path” en “Variables de usuario” y agrega: C:\src\flutter\bin.
   • Reinicia la terminal.

3. Verificar instalación:

   • Ejecuta:

     flutter doctor
     

   • Acepta licencias Android si es necesario:

     flutter doctor --android-licenses
     

Opción 2: Instalación con Chocolatey

Chocolatey simplifica la instalación y actualización en Windows.

1. Instalar Chocolatey:

   • Abre PowerShell como administrador (Inicio > “PowerShell” > Ejecutar como administrador).
   • Ejecuta:

     Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
     

   • Verifica:

     choco --version
     

2. Instalar Flutter:

   • Ejecuta:

     choco install flutter
     

   • Chocolatey configura el PATH automáticamente.

3. Verificar instalación:

   • Ejecuta flutter doctor y resuelve errores.

Configuración Adicional

• Instalar Android Studio:
  • Descarga desde developer.android.com/studio.
  • Selecciona “Android SDK” y “Android Virtual Device” durante la instalación.
  • Configura el SDK: Herramientas > SDK Manager.
  • Instala plugin Flutter: Archivo > Configuración > Plugins > “Flutter”.
• Configurar editor:
  • VS Code: Descarga desde code.visualstudio.com. Instala extensiones “Flutter” y “Dart”.
  • Android Studio: Listo tras instalar el plugin.

Emuladores y Dispositivos

• Emuladores: Crea un dispositivo virtual en AVD Manager (Android Studio).
• Dispositivos físicos: Habilita depuración USB (Ajustes > Acerca del teléfono > Toca “Número de compilación” 7 veces > Opciones de desarrollador).
• Verifica: flutter devices.

Instalación en macOS

Requisitos

• macOS 13 (Ventura) o superior.
• Xcode 14+ (desde App Store).
• ~2.8 GB de espacio libre.

Pasos

1. Descargar Flutter SDK:

   • Visita docs.flutter.dev/get-started/install/macos.
   • Descarga el ZIP estable (ej: flutter_macos_3.x.x-stable.zip).
   • Extrae:

     unzip ~/Downloads/flutter_macos_3.x.x-stable.zip -d ~/development
     

2. Configurar PATH:

   • Edita ~/.zshrc:

     nano ~/.zshrc
     

   • Agrega: export PATH="$PATH:$HOME/development/flutter/bin".
   • Guarda y aplica: source ~/.zshrc.

3. Verificar instalación:

   • Ejecuta:

     flutter doctor
     

   • Instala CocoaPods si es necesario:

     sudo gem install cocoapods
     

Configuración Adicional

• Xcode:
  • Acepta términos: sudo xcodebuild -license.
  • Instala command-line tools: sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer.
• Android Studio: Como en Windows.
• Editor: VS Code con extensiones Flutter y Dart.

Emuladores y Dispositivos

• iOS Simulator: Abre desde Xcode > Open Developer Tool > Simulator.
• Android Emulator: Usa AVD Manager (Android Studio).
• Dispositivos físicos: Conecta vía USB; para iOS, confía en el equipo desde Ajustes.