Instalar flutter correctamente implica algo más que descargar un archivo: también hay que preparar el sistema, configurar el SDK y comprobar que las herramientas para compilar estén disponibles. Esta guía explica el proceso en Windows, macOS y Linux, cómo elegir un editor y qué revisar si el comando flutter doctor muestra advertencias. El objetivo es dejar un entorno funcional para desarrollar aplicaciones sin acumular instalaciones innecesarias.
Antes de descargar Flutter, decide qué vas a desarrollar
Flutter permite crear aplicaciones para Android, iOS, web y escritorio desde una misma base de código. Sin embargo, instalar el SDK no habilita automáticamente todos esos destinos. Cada plataforma tiene requisitos propios: para compilar una app Android se necesita el Android SDK; para generar una aplicación iOS se requiere macOS y las herramientas de Apple. Conviene definir primero el destino de prueba para no instalar componentes que todavía no se van a utilizar.
Para empezar con Android, el recorrido más habitual consiste en instalar Flutter, añadir Android Studio y configurar un dispositivo virtual o conectar un teléfono. Para desarrollar en iOS, el entorno debe ejecutarse en un Mac con Xcode. En cambio, una primera prueba web puede requerir menos componentes adicionales, aunque es recomendable configurar también el editor y verificar el navegador compatible.
Antes de seguir, comprueba que el equipo tenga espacio disponible y permisos para instalar herramientas. El SDK de Flutter ocupa menos que el conjunto completo de emuladores, imágenes de sistema y herramientas de Android. Si el almacenamiento es limitado, se puede comenzar con un único destino y descargar componentes adicionales más adelante.
Instalar Flutter en Windows paso a paso
En Windows, el método más sencillo para controlar la instalación es descargar el SDK de Flutter y colocarlo en una carpeta estable. Una ubicación como C:srcflutter suele ser más práctica que el escritorio o la carpeta de descargas. Evita rutas con permisos restringidos y, si es posible, nombres con espacios o caracteres especiales: algunos procesos de compilación y herramientas auxiliares pueden manejar esas rutas con menos comodidad.
-
Descarga el paquete del SDK de Flutter para Windows y extrae su contenido en la carpeta elegida. No ejecutes el SDK directamente desde un archivo comprimido ni muevas la carpeta después de configurar las variables del sistema.
-
Añade la carpeta bin del SDK a la variable Path. Si Flutter está en C:srcflutter, la ruta que se agrega es C:srcflutterbin. Busca “Editar las variables de entorno del sistema” en Windows, abre la configuración de Path y crea una entrada nueva.
-
Cierra y vuelve a abrir PowerShell o el Símbolo del sistema. Ejecuta flutter –version para confirmar que Windows encuentra el comando. Si aparece un mensaje indicando que no se reconoce, revisa la ruta y abre una terminal nueva.
-
Instala Android Studio si el objetivo es compilar para Android. Durante la configuración, incluye Android SDK, Android SDK Platform-Tools y Android Virtual Device si se quiere usar un emulador.
-
Ejecuta flutter doctor en la terminal y sigue las indicaciones para aceptar licencias o instalar componentes pendientes.
Un error frecuente es agregar a Path la carpeta principal de Flutter en lugar de su subcarpeta bin. Otro es editar una variable de entorno y probar el comando en una terminal que ya estaba abierta: esa sesión conserva la configuración anterior y puede dar la impresión de que el cambio no funcionó.
Configurar Flutter en macOS o Linux
En macOS y Linux, el SDK puede instalarse en una carpeta de usuario o en una ubicación compartida con permisos adecuados. La recomendación principal es mantenerlo en un directorio permanente y anotar su ruta. En macOS, por ejemplo, puede quedar en una carpeta de desarrollo dentro del directorio personal. En Linux, una ubicación como ~/development/flutter permite separar el SDK de los archivos temporales.
Después de extraer el paquete correspondiente al sistema, añade la ruta de flutter/bin al PATH del shell. La forma concreta depende de si la terminal usa zsh, bash u otro intérprete. En zsh, habitual en versiones actuales de macOS, se modifica el archivo de configuración de zsh; en muchas distribuciones de Linux se usa el archivo de configuración de bash o el equivalente del shell activo. Añade la ruta al final del archivo, guarda los cambios y recarga la configuración o abre una terminal nueva.
Comprueba la instalación con flutter –version y después con flutter doctor. En macOS, para crear aplicaciones iOS, instala Xcode y abre la aplicación al menos una vez para completar su configuración inicial. También puede ser necesario instalar herramientas de línea de comandos de Apple y aceptar sus condiciones. Tener Flutter instalado en Linux no permite compilar aplicaciones iOS: esa tarea depende de Xcode y, por tanto, de macOS.
Para Android en cualquiera de estos sistemas, Android Studio proporciona el SDK y otras herramientas de desarrollo. No es obligatorio escribir el código dentro de Android Studio, pero sí puede ser necesario instalarlo para obtener el entorno de compilación y gestionar emuladores. Es posible utilizar un teléfono físico; en ese caso habrá que habilitar las opciones de desarrollador y la depuración USB en el dispositivo.
Qué revisar cuando flutter doctor informa de problemas
flutter doctor inspecciona el entorno y señala qué componentes faltan o no puede localizar. No todos los avisos bloquean todos los proyectos. Si solo se va a compilar para Android, una advertencia relacionada con Xcode no impide crear una app Android. La clave es interpretar cada línea según la plataforma que se necesita.
-
Flutter no aparece como comando: comprueba que Path incluya la carpeta bin y que la terminal se haya reiniciado. En Windows, verifica que no se haya añadido por error una ruta de ejemplo o una carpeta diferente.
-
Faltan licencias de Android: sigue la instrucción sugerida por la herramienta y revisa que Android Studio haya instalado el SDK. Aceptar licencias no sustituye la instalación de las plataformas y herramientas requeridas.
-
No aparece ningún dispositivo: inicia un emulador desde Android Studio o conecta un teléfono con depuración USB habilitada. En algunos sistemas Linux también hay que configurar permisos para que el usuario pueda acceder al dispositivo.
-
El editor no reconoce Flutter: instala la extensión de Flutter en Visual Studio Code o configura el plugin correspondiente en Android Studio. Después, comprueba que el editor apunte al mismo SDK que reconoce la terminal.
-
La instalación dejó de funcionar tras mover la carpeta: actualiza Path y la ubicación del SDK en el editor. Mantener una sola copia evita que la terminal use una versión mientras el editor utiliza otra.
Una salida con advertencias no significa necesariamente que la instalación haya fallado. Por ejemplo, un equipo puede estar listo para Android aunque todavía no tenga las herramientas necesarias para escritorio. En cambio, si el diagnóstico no encuentra el SDK de Android y se necesita generar un APK, ese problema sí debe resolverse antes de continuar.
Crear una aplicación de prueba y validar el entorno
La mejor comprobación no es solo ver un número de versión: también conviene ejecutar un proyecto pequeño. Desde la terminal, cambia a una carpeta donde tengas permiso para crear archivos y utiliza flutter create mi_app. Luego entra en el directorio del proyecto con cd mi_app y ejecuta flutter run con un emulador abierto o un dispositivo conectado.
Si hay varios destinos disponibles, Flutter puede pedir que se seleccione uno. El primer inicio puede tardar más porque se descargan dependencias y se prepara la compilación. Una demora inicial no indica por sí sola un error. Si el proceso se detiene, revisa el mensaje final de la terminal: suele identificar si falta un dispositivo, una licencia, una imagen del emulador o un componente del SDK.
Este paso también permite detectar una configuración inconsistente. Por ejemplo, flutter doctor puede localizar Android Studio, pero el proyecto fallar porque no está instalada la plataforma Android requerida. En ese caso, abre el gestor del SDK, instala una versión compatible y repite la prueba. No es necesario instalar todas las versiones disponibles: basta con elegir las que demande el proyecto o las herramientas utilizadas.
Decisiones que evitan problemas al empezar
Elegir editor sin duplicar herramientas
Visual Studio Code es ligero y funciona bien para editar proyectos Flutter con sus extensiones. Android Studio ofrece funciones más amplias para administrar el SDK y los emuladores. Se puede usar uno para programar y el otro para gestionar componentes; instalar ambos no implica que haya que escribir código en los dos. Lo esencial es que el editor encuentre el SDK correcto.
Mantener el SDK actualizado con criterio
Las actualizaciones de Flutter pueden incorporar cambios, correcciones y requisitos distintos. En un proyecto personal, actualizar cuando se necesita una función o una corrección suele ser razonable. En un proyecto de equipo, conviene acordar una versión y probar los cambios antes de actualizar todos los entornos. Cambiar de versión sin revisar dependencias puede provocar errores que no tienen relación con la instalación inicial.
Separar instalación y proyecto
El SDK es la herramienta de desarrollo; el proyecto contiene el código de la aplicación y sus dependencias. Guardarlos en carpetas separadas facilita las actualizaciones y las copias de seguridad. También ayuda a evitar que una limpieza de archivos temporales elimine por accidente el SDK o que una reinstalación borre el trabajo del proyecto.
Instalar Flutter es un proceso directo cuando se respeta el orden: colocar el SDK en una ubicación estable, añadir su carpeta bin al PATH, instalar las herramientas de la plataforma elegida y revisar el diagnóstico. Para comenzar con Android, la acción siguiente es crear un proyecto de prueba y ejecutarlo en un emulador o teléfono. Si el objetivo es iOS, primero hay que confirmar que se cuenta con un Mac y Xcode. Esa verificación evita dedicar tiempo a configurar un destino que el equipo no puede compilar.
