Saltar al contenido principal

Configurar el desarrollo para Android

Configura tu entorno de desarrollo para ejecutar, compilar y desplegar aplicaciones de Flutter para dispositivos Android.

Aprende cómo configurar tu entorno de desarrollo para ejecutar, compilar y desplegar aplicaciones de Flutter para dispositivos Android.

Elige tu plataforma de desarrollo

#

Las instrucciones de esta página están configuradas para cubrir la configuración del desarrollo para Android en un dispositivo macOS.

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

Configurar herramientas de Android

#

Con Android Studio, puedes ejecutar aplicaciones de Flutter en un dispositivo Android físico o en un Android Emulator.

Si aún no lo has hecho, instala y configura la última versión estable de Android Studio.

  1. Instalar librerías de prerrequisitos

    Si estás desarrollando en Linux, primero instala la colección requerida de librerías de 32 bits que Android Studio requiere.

  2. Instalar Android Studio

    Si aún no lo has hecho, instala y configura la última versión estable de Android Studio.

    Si ya tienes instalado Android Studio, asegúrate de que esté actualizado.

  3. Instalar el SDK y herramientas de Android

    1. Inicia Android Studio.

    2. Abre el diálogo de configuración del SDK Manager.

      1. Si el diálogo Welcome to Android Studio está abierto, haz clic en el botón More Actions que sigue a los botones New Project y Open, luego haz clic en SDK Manager en el menú desplegable.

      2. Si tienes un proyecto abierto, go to Tools > SDK Manager.

    3. Si la pestaña SDK Platforms no está abierta, cámbiate a ella.

    4. Verifica que se haya seleccionado la primera entrada con un API Level de 36.

      Si la columna Status muestra Update available o Not installed:

      1. Selecciona la casilla de verificación de esa entrada o fila.

      2. Haz clic en Apply.

      3. Cuando aparezca el diálogo Confirm Change, haz clic en OK.

        El diálogo SDK Component Installer se muestra con un indicador de progreso.

      4. Cuando termine la instalación, haz clic en Finish.

    5. Cambia a la pestaña SDK Tools.

    6. Verifica que se hayan seleccionado las siguientes herramientas del SDK:

      • Android SDK Build-Tools
      • Android SDK Command-line Tools
      • Android Emulator
      • Android SDK Platform-Tools
      • CMake
      • NDK (Side by side)
    7. Si la columna Status para cualquiera de las herramientas anteriores muestra Update available o Not installed:

      1. Selecciona la casilla de verificación para las herramientas necesarias.

      2. Haz clic en Apply.

      3. Cuando aparezca el diálogo Confirm Change, haz clic en OK.

        El diálogo SDK Component Installer se muestra con un indicador de progreso.

      4. Cuando termine la instalación, haz clic en Finish.

  4. Aceptar las licencias de Android

    Antes de que puedas usar Flutter y después de instalar todos los prerrequisitos, acepta las licencias de la plataforma Android SDK.

    1. Abre tu terminal preferida.

    2. Ejecuta el siguiente comando para revisar y firmar las licencias del SDK.

      flutter doctor --android-licenses
      
    3. Lee y acepta las licencias necesarias.

      Si no has aceptado cada una de las licencias del SDK anteriormente, necesitarás revisarlas y aceptarlas antes de desarrollar para Android.

      Antes de aceptar los términos de cada licencia, léela con atención.

      Una vez que hayas aceptado todas las licencias necesarias con éxito, deberías ver una salida similar a la siguiente:

      All SDK package licenses accepted.
      

Configurar un dispositivo Android

#

Puedes depurar aplicaciones de Flutter en dispositivos Android físicos o ejecutándolas en un emulador de Android.

Para configurar tu entorno de desarrollo para ejecutar una aplicación de Flutter en un emulador de Android, sigue estos pasos:

  1. Configura tu dispositivo de desarrollo

    Habilita la aceleración de VM en tu computadora de desarrollo.

  2. Configurar un nuevo emulador

    1. Inicia Android Studio.

    2. Abre el diálogo de configuración del Device Manager.

      1. Si el diálogo Welcome to Android Studio está abierto, haz clic en el botón More Actions que sigue a los botones New Project y Open, luego selecciona Virtual Device Manager en el menú desplegable.

      2. Si tienes un proyecto abierto, go to Tools > Device Manager.

    3. Haz clic en el botón Create Virtual Device que aparece como un icono +.

      Se muestra el diálogo Virtual Device Configuration.

    4. Selecciona Phone o Tablet bajo Form Factor.

    5. Selecciona una definición de dispositivo. Puedes buscar o explorar el dispositivo.

    6. Haz clic en Next.

    7. Si se proporciona la opción, select elije x86 Images o ARM Images dependiendo de si tu computadora de desarrollo es un dispositivo x64 o Arm64.

    8. Selecciona una imagen de sistema para la versión de Android que deseas emular.

      1. Si la imagen deseada tiene un icono de Download a la izquierda del nombre de la imagen del sistema, haz clic en él.

        El diálogo SDK Component Installer se muestra con un indicador de progreso.

      2. Cuando se complete la descarga, haz clic en Finish.

    9. Haz clic en Additional settings en la barra de pestañas superior y desplázate hasta Emulated Performance.

    10. En el menú desplegable Graphics acceleration, selecciona una opción que mencione Hardware.

      Esto habilita la aceleración por hardware, mejorando el rendimiento de renderizado.

    11. Verifica la configuración de tu dispositivo virtual. Si es correcta, haz clic en Finish.

      Para aprender más sobre dispositivos virtuales, consulta Crear y administrar dispositivos virtuales.

  3. Intenta ejecutar el emulador

    En el diálogo Device Manager, haz clic en el icono Run a la derecha del dispositivo virtual deseado.

    El emulador debería iniciarse y mostrar el lienzo predeterminado para la versión y dispositivo del SO Android seleccionados.

Para configurar tu entorno de desarrollo para ejecutar una aplicación de Flutter en un dispositivo Android físico, sigue estos pasos:

  1. Configurar tu dispositivo

    Habilita las Opciones de desarrollador y la depuración por USB en tu dispositivo como se describe en Configurar opciones de desarrollador en el dispositivo.

  2. Habilitar depuración inalámbrica

    Para aprovechar la depuración inalámbrica, habilita la depuración inalámbrica en tu dispositivo como se describe en Conectarse a tu dispositivo usando Wi-Fi.

  3. Instalar prerrequisitos de la plataforma

    Si estás desarrollando en Windows, primero instala el controlador USB necesario para tu dispositivo particular como se describe en Instalar controladores USB OEM.

  4. Conecta tu dispositivo

    Conecta tu dispositivo a tu computadora. Si tu dispositivo te lo solicita, autoriza a tu computadora a acceder a tu dispositivo Android.

  5. Verifica la conexión del dispositivo

    Para verificar que Flutter reconoce tu dispositivo Android conectado, ejecuta flutter devices en tu terminal preferida:

    flutter devices
    

    Tu dispositivo debería ser encontrado y aparecer como un dispositivo conectado.

Validar tu configuración

#
  1. Comprobar problemas en la cadena de herramientas

    Para comprobar si hay algún problema con tu configuración de desarrollo de Android, ejecuta el comando flutter doctor en tu terminal preferida:

    flutter doctor
    

    Si ves algún error o tareas por completar bajo las secciones Android toolchain o Android Studio,

    Completa cualquier tarea mencionada y luego ejecuta flutter doctor nuevamente para verificar los cambios.

  2. Comprobar dispositivos Android

    Para asegurarte de que configuraste correctamente tu emulador y/o dispositivo Android físico, ejecuta flutter emulators y flutter devices en tu terminal preferida:

    flutter emulators && flutter devices
    

    Dependiendo de si configuraste un emulador o un dispositivo, al menos uno debería mostrar una entrada con la plataforma marcada como android.

  3. Solucionar problemas de configuración

    Si necesitas ayuda para resolver algún problema de configuración, consulta Solución de problemas de instalación y configuración.

    Si aún tienes problemas o preguntas, ponte en contacto en uno de los canales de la comunidad de Flutter.

Comenzar a desarrollar para Android

#

¡Felicitaciones! Ahora que has configurado el desarrollo de Android para Flutter, puedes continuar tu viaje de aprendizaje de Flutter mientras pruebas en Android o comenzar a mejorar la integración con Android.