Saltar al contenido principal

Instala Flutter manualmente

Aprende cómo instalar y configurar el SDK de Flutter manualmente.

Aprende cómo instalar y configurar manualmente tu entorno de desarrollo de Flutter.

Elige tu plataforma de desarrollo

#

Las instrucciones de esta página están configuradas para cubrir la instalación de Flutter en un dispositivo macOS.

Si quieres seguir las instrucciones para un sistema operativo diferente, selecciona uno de los siguientes.

Descarga el software requerido

#

Antes de instalar el SDK de Flutter, primero completa la siguiente configuración.

  1. Instala Git para Windows

    Descarga e instala la última versión de Git para Windows.

    Para obtener ayuda con la instalación o resolución de problemas de Git, consulta la documentación de Git.

  2. Configura un editor o IDE

    Para obtener la mejor experiencia al desarrollar aplicaciones de Flutter, considera instalar y configurar un editor o IDE con soporte para Flutter.

  1. Instala las herramientas de línea de comandos de Xcode

    Descarga las herramientas de línea de comandos de Xcode para obtener acceso a las herramientas de línea de comandos en las que se basa Flutter, incluyendo Git.

    Para descargar las herramientas, ejecuta el siguiente comando en tu terminal preferida:

    xcode-select --install
    

    Si aún no has instalado las herramientas, debería abrirse un cuadro de diálogo confirmando que deseas instalarlas. Haz clic en Instalar, luego, una vez completada la instalación, haz clic en Listo.

  2. Configura un editor o IDE

    Para obtener la mejor experiencia al desarrollar aplicaciones de Flutter, considera instalar y configurar un editor o IDE con soporte para Flutter.

  1. Descarga e instala los paquetes requeridos

    Usando tu gestor de paquetes o mecanismo preferido, instala las últimas versiones de los siguientes paquetes:

    • curl
    • git
    • unzip
    • xz-utils
    • zip
    • libglu1-mesa

    En distribuciones basadas en Debian con apt-get, como Ubuntu, instala estos paquetes usando los siguientes comandos:

    sudo apt-get update -y && sudo apt-get upgrade -y
    sudo apt-get install -y curl git unzip xz-utils zip libglu1-mesa
    
  2. Configura un editor o IDE

    Para obtener la mejor experiencia al desarrollar aplicaciones de Flutter, considera instalar y configurar un editor o IDE con soporte para Flutter.

  1. Configura el soporte para Linux

    Si no has configurado el soporte para Linux en tu Chromebook antes, activa el soporte para Linux.

    Si ya has activado el soporte para Linux, asegúrate de que esté actualizado siguiendo las instrucciones para solucionar problemas con Linux.

  2. Descarga e instala los paquetes requeridos

    Usando apt-get o tu mecanismo de instalación preferido, instala las últimas versiones de los siguientes paquetes:

    • curl
    • git
    • unzip
    • xz-utils
    • zip
    • libglu1-mesa

    Si quieres usar apt-get, instala estos paquetes usando los siguientes comandos:

    sudo apt-get update -y && sudo apt-get upgrade -y
    sudo apt-get install -y curl git unzip xz-utils zip libglu1-mesa
    
  3. Configura un editor o IDE

    Para obtener la mejor experiencia al desarrollar aplicaciones de Flutter, considera instalar y configurar un editor o IDE con soporte para Flutter.

Instalar y configurar Flutter

#

Para instalar el SDK de Flutter, descarga el último paquete del archivo del SDK, luego extrae el SDK en el lugar donde quieras guardarlo.

  1. Descarga el paquete del SDK de Flutter

    Descarga el siguiente paquete de instalación para obtener el último lanzamiento estable del SDK de Flutter.

    flutter_windows_3.44.6-stable.zip
  2. Crea una carpeta para almacenar el SDK

    Crea o busca una carpeta para almacenar el SDK extraído. Considera crear y usar un directorio en %USERPROFILE%\develop (C:\Users\{username}\develop).

  3. Extrae el SDK

    Extrae el paquete del SDK que descargaste en el directorio en el que quieras almacenar el SDK de Flutter.

    1. Copia el siguiente comando.
    2. Reemplaza <sdk_zip_path> con la ruta al paquete que descargaste.
    3. Reemplaza <destination_directory_path> con la ruta a la carpeta en la que quieres que esté el SDK extraído.
    4. Ejecuta el comando editado en tu terminal preferida.
    Expand-Archive –Path <sdk_zip_path> -Destination <destination_directory_path>
    

    Por ejemplo, si descargaste el paquete para Flutter 3.29.3 en el directorio %USERPROFILE%\Downloads y quieres almacenar el SDK extraído en el directorio %USERPROFILE%\develop:

    Expand-Archive `
      -Path $env:USERPROFILE\Downloads\flutter_windows_3.29.3-stable.zip `
      -Destination $env:USERPROFILE\develop\
    
  1. Descarga el paquete del SDK de Flutter

    Dependiendo de la arquitectura de CPU de tu dispositivo macOS, descarga uno de los siguientes paquetes de instalación para obtener el último lanzamiento estable del SDK de Flutter.

  2. Crea una carpeta para almacenar el SDK

    Crea o busca una carpeta para almacenar el SDK extraído. Considera crear y usar un directorio en ~/develop/.

  3. Extrae el SDK

    Extrae el paquete del SDK que descargaste en el directorio en el que quieras almacenar el SDK de Flutter.

    1. Copia el siguiente comando.
    2. Reemplaza <sdk_zip_path> con la ruta al paquete que descargaste.
    3. Reemplaza <destination_directory_path> con la ruta a la carpeta en la que quieres que esté el SDK extraído.
    4. Ejecuta el comando editado en tu terminal preferida.
    unzip <sdk_zip_path> -d <destination_directory_path>
    

    Por ejemplo, si descargaste el paquete para Flutter 3.29.3 en el directorio ~/Downloads y quieres almacenar el SDK extraído en el directorio ~/develop:

    unzip ~/Downloads/flutter_macos_3.29.3-stable.zip -d ~/develop/
    
  1. Descarga el paquete del SDK de Flutter

    Descarga el siguiente paquete de instalación para obtener el último lanzamiento estable del SDK de Flutter.

    flutter_linux_3.44.6-stable.tar.xz
  2. Crea una carpeta para almacenar el SDK

    Crea o busca una carpeta para almacenar el SDK extraído. Considera crear y usar un directorio en ~/develop/.

  3. Extrae el SDK

    Extrae el paquete del SDK que descargaste en el directorio en el que quieras almacenar el SDK de Flutter.

    1. Copia el siguiente comando.
    2. Reemplaza <sdk_zip_path> con la ruta al paquete que descargaste.
    3. Reemplaza <destination_directory_path> con la ruta a la carpeta en la que quieres que esté el SDK extraído.
    4. Ejecuta el comando editado en tu terminal preferida.
    tar -xf <sdk_zip_path> -C <destination_directory_path>
    

    Por ejemplo, si descargaste el paquete para Flutter 3.29.3 en el directorio ~/Downloads y quieres almacenar el SDK extraído en el directorio ~/develop:

    tar -xf ~/Downloads/flutter_linux_3.29.3-stable.tar.xz -C ~/develop/
    

Agregar Flutter a tu PATH

#

Ahora que has descargado el SDK, añade el directorio bin del SDK de Flutter a tu variable de entorno PATH. Añadir Flutter a tu PATH te permite usar las herramientas de línea de comandos flutter y dart en terminales e IDEs.

  1. Determinar la ubicación de instalación del SDK de Flutter

    Copia la ruta absoluta del directorio en el que descargaste y extrajiste el SDK de Flutter.

  2. Navegar a la configuración de variables de entorno

    1. Presiona Windows + Pausa.

      Si tu teclado no tiene una tecla Pause, prueba con Windows + Fn + B.

      Se abre el diálogo Sistema > Acerca de.

    2. Haz clic en Configuración avanzada del sistema > Opciones avanzadas > Variables de entorno....

      Se abre el diálogo Variables de entorno.

  3. Agregar la carpeta bin del SDK de Flutter a tu path

    1. En la sección Variables de usuario para (nombre de usuario) del cuadro de diálogo Variables de entorno, busca la entrada Path.

    2. Si la entrada Path existe, haz doble clic en ella.

      Debería abrirse el diálogo Editar variable de entorno.

      1. Haz doble clic dentro de una fila vacía.

      2. Escribe la ruta al directorio bin de tu instalación de Flutter.

        Por ejemplo, si descargaste Flutter en una develop\flutter carpeta dentro de tu directorio de usuario, escribirías lo siguiente:

        %USERPROFILE%\develop\flutter\bin
        
      3. Haz clic en la entrada de Flutter que agregaste para seleccionarla.

      4. Haz clic en Subir hasta que la entrada de Flutter se encuentre en la parte superior de la lista.

      5. Para confirmar tus cambios, haz clic en Aceptar tres veces.

    3. Si la entrada no existe, haz clic en Nueva....

      Debería abrirse el diálogo Editar variable de entorno.

      1. En la casilla Nombre de la variable, escribe Path.

      2. En la casilla Valor de la variable, escribe la ruta al directorio bin de tu instalación de Flutter.

        Por ejemplo, si descargaste Flutter en una develop\flutter carpeta dentro de tu directorio de usuario, escribirías lo siguiente:

        %USERPROFILE%\develop\flutter\bin
        
      3. Para confirmar tus cambios, haz clic en Aceptar tres veces.

  4. Aplicar tus cambios

    Para aplicar este cambio y obtener acceso a la herramienta flutter, cierra y vuelve a abrir todos los símbolos del sistema (command prompts) abiertos, las sesiones en tus aplicaciones de terminal y los IDEs.

  5. Validar tu configuración

    Para asegurarte de haber añadido con éxito el SDK a tu PATH, abre la consola de comandos o tu aplicación de terminal preferida, luego intenta ejecutar las herramientas flutter y dart.

    flutter --version
    dart --version
    

    Si no se encuentra ninguno de los comandos, consulta la sección de resolución de problemas de instalación de Flutter.

  1. Determinar la ubicación de instalación del SDK de Flutter

    Copia la ruta absoluta del directorio en el que descargaste y extrajiste el SDK de Flutter.

  2. Abrir o crear el archivo de variables de entorno de Zsh

    Si existe, abre el archivo de variables de entorno de Zsh ~/.zprofile en tu editor de texto preferido. Si no existe, crea el archivo ~/.zprofile.

  3. Agregar la carpeta bin del SDK de Flutter a tu path

    Al final de tu archivo ~/.zprofile, usa el comando integrado export para actualizar la variable PATH e incluir el directorio bin de tu instalación de Flutter.

    Reemplaza <path-to-sdk> con la ruta de tu instalación del SDK de Flutter.

    bash
    export PATH="<path-to-sdk>/bin:$PATH"
    

    Por ejemplo, si descargaste Flutter en una carpeta develop/flutter dentro de tu directorio de usuario, añadirías lo siguiente al archivo:

    bash
    export PATH="$HOME/develop/flutter/bin:$PATH"
    
  4. Guardar tus cambios

    Guarda y luego cierra el archivo ~/.zprofile que editaste.

  5. Aplicar tus cambios

    Para aplicar este cambio y obtener acceso a la herramienta flutter, cierra y vuelve a abrir todas las sesiones de Zsh abiertas en tus aplicaciones de terminal e IDEs.

  6. Validar tu configuración

    Para asegurarte de haber añadido con éxito el SDK a tu PATH, abre una sesión de Zsh en tu terminal preferida, luego intenta ejecutar las herramientas flutter y dart.

    flutter --version
    dart --version
    

    Si no se encuentra ninguno de los comandos, consulta la sección de resolución de problemas de instalación de Flutter.

  1. Determinar la ubicación de instalación del SDK de Flutter

    Copia la ruta absoluta del directorio en el que descargaste y extrajiste el SDK de Flutter.

  2. Determinar tu shell predeterminada

    Si no sabes qué shell usas, comprueba qué shell se inicia al abrir una nueva ventana de consola.

    echo $SHELL
    
  3. Agregar la carpeta bin del SDK de Flutter a tu path

    Para agregar el directorio bin de tu instalación de Flutter a tu PATH:

    1. Expande las instrucciones para tu shell predeterminada.
    2. Copia el comando proporcionado.
    3. Reemplaza <path-to-sdk> con la ruta de la instalación de tu SDK de Flutter.
    4. Ejecuta el comando editado en tu terminal preferida con esa shell.

    Expandir para ver las instrucciones de bash
    echo 'export PATH="<path-to-sdk>/bin:$PATH"' >> ~/.bashrc
    

    Por ejemplo, si descargaste Flutter en una carpeta develop/flutter dentro de tu directorio de usuario, ejecutarías lo siguiente:

    echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.bashrc
    
    Expandir para ver las instrucciones de zsh
    echo 'export PATH="<path-to-sdk>/bin:$PATH"' >> ~/.zshenv
    

    Por ejemplo, si descargaste Flutter en una carpeta develop/flutter dentro de tu directorio de usuario, ejecutarías lo siguiente:

    echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.zshenv
    
    Expandir para ver las instrucciones de fish
    fish_add_path -g -p <path-to-sdk>/bin
    

    Por ejemplo, si descargaste Flutter en una carpeta develop/flutter dentro de tu directorio de usuario, ejecutarías lo siguiente:

    fish_add_path -g -p ~/develop/flutter/bin
    
    Expandir para ver las instrucciones de csh
    echo 'setenv PATH "<path-to-sdk>/bin:$PATH"' >> ~/.cshrc
    

    Por ejemplo, si descargaste Flutter en una carpeta develop/flutter dentro de tu directorio de usuario, ejecutarías lo siguiente:

    echo 'setenv PATH "$HOME/develop/flutter/bin:$PATH"' >> ~/.cshrc
    
    Expandir para ver las instrucciones de tcsh
    echo 'setenv PATH "<path-to-sdk>/bin:$PATH"' >> ~/.tcshrc
    

    Por ejemplo, si descargaste Flutter en una carpeta develop/flutter dentro de tu directorio de usuario, ejecutarías lo siguiente:

    echo 'setenv PATH "$HOME/develop/flutter/bin:$PATH"' >> ~/.tcshrc
    
    Expandir para ver las instrucciones de ksh
    echo 'export PATH="<path-to-sdk>/bin:$PATH"' >> ~/.profile
    

    Por ejemplo, si descargaste Flutter en una carpeta develop/flutter dentro de tu directorio de usuario, ejecutarías lo siguiente:

    echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.profile
    
    Expandir para ver las instrucciones de sh
    echo 'export PATH="<path-to-sdk>/bin:$PATH"' >> ~/.profile
    

    Por ejemplo, si descargaste Flutter en una carpeta develop/flutter dentro de tu directorio de usuario, ejecutarías lo siguiente:

    echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.profile
    
  4. Aplicar tus cambios

    Para aplicar este cambio y obtener acceso a la herramienta flutter, cierra y vuelve a abrir todas las sesiones de shell abiertas en tus aplicaciones de terminal e IDEs.

  5. Validar tu configuración

    Para asegurarte de haber añadido con éxito el SDK a tu PATH, abre tu terminal preferida con tu shell por defecto, luego intenta ejecutar las herramientas flutter y dart.

    flutter --version
    dart --version
    

    Si no se encuentra ninguno de los comandos, consulta la sección de resolución de problemas de instalación de Flutter.

  1. Determinar la ubicación de instalación del SDK de Flutter

    Copia la ruta absoluta del directorio en el que descargaste y extrajiste el SDK de Flutter.

  2. Agregar la carpeta bin del SDK de Flutter a tu path

    Para agregar el directorio bin de tu instalación de Flutter a tu PATH:

    1. Copia el siguiente comando.
    2. Reemplaza <path-to-sdk> con la ruta de la instalación de tu SDK de Flutter.
    3. Ejecuta el comando editado en tu terminal preferida.
    echo 'export PATH="<path-to-sdk>:$PATH"' >> ~/.bash_profile
    

    Por ejemplo, si descargaste Flutter en una carpeta develop/flutter dentro de tu directorio de usuario, ejecutarías lo siguiente:

    echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.bash_profile
    
  3. Aplicar tus cambios

    Para aplicar este cambio y obtener acceso a la herramienta flutter, cierra y vuelve a abrir todas las sesiones de Zsh abiertas en tus aplicaciones de terminal e IDEs.

  4. Validar tu configuración

    Para asegurarte de haber añadido con éxito el SDK a tu PATH, abre una sesión de Zsh en tu terminal preferida, luego intenta ejecutar las herramientas flutter y dart.

    flutter --version
    dart --version
    

    Si no se encuentra ninguno de los comandos, consulta la sección de resolución de problemas de instalación de Flutter.

Continúa tu camino con Flutter

#

Ahora que has instalado Flutter con éxito, configura el desarrollo para al menos una plataforma de destino para continuar tu viaje con Flutter.