Instalación de Flutter

Antes de aprender a crear aplicaciones Flutter, debe instalar Flutter SDK y todas las dependencias necesarias en su máquina local. Esta sección detalla los pasos de instalación en sistemas Windows, macOS y Linux.

Requisitos del sistema

Antes de instalar Flutter, asegúrese de que su entorno de desarrollo cumpla los siguientes requisitos básicos:

RequisitoWindowsmacOSLinux
Sistema operativoWindows 10 o superiormacOS 10.14 o superiorUbuntu 18.04 o superior
Espacio en discoAl menos 2.8 GBAl menos 2.8 GBAl menos 2.8 GB
HerramientasGit for WindowsGit (a través de Xcode)Git、curl、unzip

Pasos de instalación en Windows

Primer paso: instalar Git for Windows

Git es una herramienta de control de versiones que Flutter necesita para gestionar el código y descargar el SDK.

  1. Visitela página de descarga de Git for Windows
  2. Descargue la última versión de Git for Windows
  3. Ejecute el instalador y complete la instalación con la configuración predeterminada

Segundo paso: instalar Visual Studio Code (recomendado)

Visual Studio Code (abreviado VS Code) es el editor de desarrollo Flutter que recomendamos; ofrece un amplio soporte de extensiones para Flutter.

  1. Visiteel sitio web oficial de VS Code
  2. Descargue e instale VS Code
  3. Una vez completada la instalación, abra VS Code

Tercer paso: instalar Flutter SDK

Hay dos formas de instalar Flutter SDK:

Opción 1: instalar mediante VS Code (recomendado)

La extensión Flutter de VS Code puede descargar y configurar Flutter SDK automáticamente.

  1. En VS Code, haga clic en el icono de extensiones a la izquierda (o presione Ctrl+Shift+X)
  2. Busque "Flutter" y encuentre la extensión "Dart and Flutter extensions"
  3. Haga clic en "Install" para instalar la extensión
  4. Una vez instalada, presione Ctrl+Shift+P para abrir la paleta de comandos
  5. Escriba "Flutter: New Project" y selecciónelo
  6. Seleccione "Download SDK" y luego elija el directorio de instalación

Opción 2: descarga e instalación manual

  1. Visitela página de descarga del sitio web oficial de Flutter
  2. Descargue el último Flutter SDK (archivo .zip)
  3. Extraiga el archivo descargado en el directorio que prefiera, por ejemplo C:\flutter
  4. Agregue el directorio bin de Flutter a la variable de entorno PATH del sistema

Configurar manualmente las variables de entorno

Pasos para configurar las variables de entorno en Windows:

  1. Haga clic derecho en "Este equipo" y seleccione "Propiedades"
  2. Haga clic en "Configuración avanzada del sistema"
  3. Haga clic en "Variables de entorno"
  4. En "Variables del sistema", busque Path y haga clic en "Editar"
  5. Haga clic en "Nuevo" y agregue la ruta del directorio bin de Flutter (por ejemplo, C:\flutter\bin)
  6. Haga clic en Aceptar para guardar

Pasos de instalación en macOS

Primer paso: instalar Git

macOS generalmente ya incluye Git preinstalado; puede verificarlo con el siguiente comando:

$ git --version

Si no está instalado, ejecute el siguiente comando:

$ xcode-select --install

Cuando aparezca el cuadro de diálogo, haga clic en el botón "Instalar".

Segundo paso: instalar VS Code

desdeSitio web oficial de VS CodeDescargue e instale VS Code.

Tercer paso: instalar Flutter SDK

Al igual que en Windows, puede elegir instalar desde VS Code o manualmente.

Pasos de instalación manual:

  1. Descargue Flutter SDK:
$ git clone https://github.com/flutter/flutter.git -b stable
  1. Agregue Flutter a PATH:
$ echo 'export PATH="$PATH:/Users/你的用户名/flutter/bin"' >> ~/.zshrc
$ source ~/.zshrc

Pasos de instalación en Linux

Primer paso: instalar las herramientas necesarias

En sistemas Ubuntu/Debian, ejecute el siguiente comando para instalar las herramientas necesarias:

$ sudo apt-get update
$ sudo apt-get install -y curl git unzip xz-utils zip libglu1-mesa

Segundo paso: clonar Flutter SDK

$ git clone https://github.com/flutter/flutter.git -b stable

Tercer paso: configurar PATH

$ echo 'export PATH="$PATH:$HOME/flutter/bin"' >> ~/.bashrc
$ source ~/.bashrc

Verificar la instalación

Independientemente del sistema operativo que use para instalar Flutter, puede verificar si la instalación fue exitosa con el siguiente comando:

$ flutter doctor

Después de ejecutar este comando, Flutter verificará su entorno de desarrollo e informará los problemas. Si la instalación fue exitosa, verá una salida similar a la siguiente:

Doctor summary (v3.x.x):
[✓] Flutter (Channel stable, 3.x.x)
[✓] Android toolchain
[✓] iOS toolchain
[✓] Chrome (for web development)
[✓] Windows toolchain
[✓] macOS toolchain
[✓] Linux toolchain
[✓] Web server

Al ejecutar flutter doctor por primera vez, descargará el Dart SDK y realizará algunas operaciones de inicialización; puede tardar unos minutos.

Solución de problemas comunes

No se encuentra el comando Flutter

Si al escribir el comando flutter en la terminal aparece "no encontrado", verifique:

  • Si la variable de entorno PATH está configurada correctamente
  • Si abrió una nueva ventana de terminal (los cambios en las variables de entorno requieren una nueva ventana para tener efecto)

Advertencia de que Android Studio no está instalado

Al ejecutar flutter doctor puede mostrarse una advertencia de que Android Studio no está instalado. Si no desarrolla aplicaciones Android, puede ignorar esta advertencia.

Problemas con Android SDK

Si necesita desarrollar aplicaciones Android pero encuentra problemas con el SDK, puede:

  1. Descargar e instalarAndroid Studio
  2. Instalar Android SDK a través del SDK Manager en Android Studio
Otras extensiones