Guía paso a paso y detallada para instalar y configurar Android Studio con Flutter y Dart: SDK, plugins, emuladores, ADB, variables de entorno, y primer proyecto.

Guía completa: configurar Android Studio para desarrollar apps con Flutter

De principio a fin: instalación, SDKs, plugins, emulador, dispositivos físicos, comprobaciones con flutter doctor y creación de tu primera app.

Pensada para Windows, macOS y Linux (con notas específicas por sistema)

1) Requisitos previos y conceptos

Para crear apps con Flutter en Android, necesitas:

Android Studio (IDE y gestor del Android SDK)
Android SDK (platform-tools, build-tools, plataformas)
Flutter SDK (framework, herramientas, comandos)
Dart (lenguaje; viene integrado con Flutter)
Un dispositivo: emulador (AVD) y/o móvil físico

Idea clave: Android Studio gestiona el Android SDK. Flutter se instala aparte (Flutter SDK) y se integra en Android Studio mediante plugins.

¿Qué instala cada cosa?

Android Studio: IDE, emulador, AVD Manager, SDK Manager.
Android SDK: compiladores, herramientas, APIs de Android.
Flutter SDK: flutter, dart, plantillas, motores.

Espacio en disco y rendimiento

Flutter + Android SDK + emuladores pueden ocupar varios GB.
Para el emulador: CPU con virtualización (Intel VT-x / AMD-V) y RAM suficiente.

Si tu PC es justa de recursos, un móvil físico suele ir más fluido que el emulador.

2) Instalar Android Studio

Paso 2.1: descargar e instalar

Descarga Android Studio desde la web oficial de Android Developers.
Instálalo con opciones por defecto (recomendado).
Abre Android Studio por primera vez.

Paso 2.2: asistente inicial (muy importante)

En el primer arranque suele aparecer un asistente. Elige:

Standard (instalación estándar recomendada)
Selecciona tema y configuración de UI a gusto
Permite que instale componentes del SDK

Objetivo: que Android Studio deje instalado el SDK base + herramientas esenciales.

Windows: si el emulador te da problemas de aceleración, revisa en la sección de problemas (Hyper-V/WHX/HAXM según CPU).

3) Configurar Android SDK en Android Studio

Paso 3.1: abrir el SDK Manager

Dentro de Android Studio:
File → Settings (Windows/Linux) o Android Studio → Settings (macOS) → Appearance & Behavior → System Settings → Android SDK

Paso 3.2: pestaña "SDK Platforms"

Marca al menos:

La última versión estable de Android (API más reciente disponible).
Una versión anterior común (por compatibilidad / pruebas).

Paso 3.3: pestaña "SDK Tools"

Marca/instala como mínimo:

Android SDK Platform-Tools (incluye ADB)
Android SDK Build-Tools
Android SDK Command-line Tools (latest)
Android Emulator
Google USB Driver (Windows, para móvil físico)

Consejo: si vas a crear emuladores con Google APIs, también es útil instalar “Google Play services”/system images adecuados al AVD (lo verás en el AVD Manager).

Paso 3.4: anota la ruta del SDK

En la parte superior del SDK Manager verás Android SDK Location (ruta del SDK). Apúntala: la necesitarás para comprobar variables y para depurar problemas.

Ejemplos típicos:

Windows: C:\Users\TU_USUARIO\AppData\Local\Android\Sdk

macOS:   /Users/TU_USUARIO/Library/Android/sdk

Linux:   /home/TU_USUARIO/Android/Sdk

4) Instalar Android SDK Command-line Tools (y por qué importa)

Flutter usa herramientas del SDK (como sdkmanager) para validar tu entorno. Por eso es clave tener instaladas las Command-line Tools.

Vuelve a SDK Manager → SDK Tools.
Asegúrate de tener Android SDK Command-line Tools (latest) marcado.
Aplica cambios.

Si flutter doctor te dice que faltan command-line tools, casi siempre es por esto o por una ruta mal detectada del SDK.

5) Instalar Flutter SDK (y Git)

Paso 5.1: instalar Git

Flutter necesita Git para algunas operaciones (descargas/actualizaciones). Instálalo si no lo tienes y asegúrate de que el comando git funciona en terminal.

Paso 5.2: descargar Flutter SDK

Descarga Flutter desde la web oficial de Flutter (canal estable). Extrae el ZIP en una ruta sin espacios raros y fácil de ubicar.

Rutas recomendadas:

Windows: C:\src\flutter

macOS:   /Users/tu_usuario/development/flutter

Linux:   /home/tu_usuario/development/flutter

En Windows evita instalar Flutter dentro de “Archivos de programa” o rutas con permisos restringidos.

Paso 5.3: probar comandos básicos

Abre una terminal y prueba:

flutter --version

dart --version

git --version

6) Configurar PATH y variables de entorno

Para usar flutter desde cualquier terminal, añade flutter/bin al PATH. También conviene asegurarse de que el Android SDK esté donde Flutter lo espera.

Windows (PATH)

Busca: “Editar las variables de entorno del sistema”.
En “Variables de entorno…” → en “Variables de usuario” selecciona Path → Editar.
Añade la ruta: C:\src\flutter\bin (o tu ruta real).
Guarda y abre una terminal nueva.

flutter --version

macOS / Linux (PATH)

Añade Flutter al PATH en tu archivo de shell:

zsh: ~/.zshrc (común en macOS)
bash: ~/.bashrc o ~/.bash_profile

# ejemplo:

export PATH="$PATH:/home/tu_usuario/development/flutter/bin"

Luego recarga:

source ~/.zshrc

flutter --version

Configurar la ruta del Android SDK para Flutter (si hace falta)

Flutter suele detectar automáticamente el Android SDK si Android Studio lo instaló en la ruta estándar. Si no lo detecta, puedes indicárselo:

flutter config --android-sdk "RUTA/AL/SDK"

En muchos casos no necesitarás este comando si Android Studio quedó bien configurado.

7) Instalar plugins Flutter y Dart en Android Studio

Paso 7.1: abrir el gestor de plugins

Android Studio → Settings → Plugins

Paso 7.2: instalar

Busca e instala Flutter (esto normalmente instalará Dart automáticamente)
Si Dart no se instala solo, instala el plugin Dart manualmente

Paso 7.3: reiniciar Android Studio

Tras instalar plugins, reinicia para que se activen.

Señal de que está bien: al crear un proyecto nuevo debería aparecer “Flutter” como tipo de proyecto.

8) Crear y configurar el emulador (AVD)

Paso 8.1: abrir el Device Manager / AVD Manager

En Android Studio:
Tools → Device Manager

Paso 8.2: crear un dispositivo virtual

Haz clic en Create device.
Elige un modelo (p. ej., Pixel).
Elige una imagen de sistema (recomendado: x86_64 con Google APIs / Google Play si está disponible).
Descarga la imagen si no está descargada.
Finaliza y arranca el emulador.

¿x86_64 o ARM? En la mayoría de PCs, x86_64 va más rápido. En Apple Silicon, suele usarse ARM/compatibles según soporte del emulador.

Paso 8.3: comprobar que Flutter ve el emulador

flutter devices

Deberías ver el emulador en la lista.

9) Usar un móvil físico (depuración USB)

Paso 9.1: activar opciones de desarrollador

En Android: Ajustes → Acerca del teléfono
Busca Número de compilación y toca 7 veces
Vuelve atrás: ahora verás Opciones de desarrollador

Paso 9.2: activar depuración USB

En Opciones de desarrollador activa Depuración USB.
Conecta el móvil por USB al PC.
Acepta el diálogo de “¿Permitir depuración USB?” en el móvil (marca “Confiar siempre” si quieres).

Paso 9.3: comprobar con ADB / Flutter

flutter devices

Windows: si no aparece el móvil, puede ser por drivers. Instala “Google USB Driver” desde SDK Tools y/o el driver del fabricante (Samsung, Xiaomi, etc.).

10) Verificación total con flutter doctor

Este comando revisa tu instalación y te dice qué falta. Ejecútalo siempre que algo no funcione.

flutter doctor -v

Qué esperar

[✓] Flutter
[✓] Android toolchain
[✓] Android Studio
[✓] Connected device (emulador o móvil)

Si “Android toolchain” falla, revisa: SDK Tools (platform-tools, build-tools, cmdline-tools) y licencias.

Aceptar licencias de Android (muy común)

flutter doctor --android-licenses

Acepta (y) todas las licencias necesarias.

11) Crear el primer proyecto Flutter

Opción A: desde Android Studio

New Project → Flutter
Selecciona la ruta de tu Flutter SDK (te la pedirá la primera vez)
Elige nombre del proyecto (ej. mi_app)
Elige ubicación y crea

Opción B: desde terminal

flutter create mi_app

cd mi_app

Ya tendrás una app de ejemplo lista para correr.

12) Ejecutar, depurar, hot reload y perfiles

Paso 12.1: elegir el dispositivo

En Android Studio, arriba (barra de herramientas), selecciona tu emulador o móvil.

Paso 12.2: ejecutar

Botón Run (▶) para ejecución normal
Botón Debug (🐞) para depuración con breakpoints

Hot Reload vs Hot Restart

Hot Reload: aplica cambios de código UI rápidamente manteniendo estado.
Hot Restart: reinicia la app (pierde estado), útil si algo se queda “raro”.

Modos de ejecución

Debug: para desarrollar, incluye herramientas y es más lento.
Profile: para medir rendimiento (casi como release, pero con profiling).
Release: para publicar; optimizado.

# ejecutar en modo release (para pruebas puntuales)

flutter run --release

13) Problemas comunes y soluciones

13.1 “flutter: command not found”

No está en PATH. Añade flutter/bin y abre una terminal nueva.

13.2 “Android toolchain - develop for Android devices” falla

Revisa en Android Studio → SDK Manager:

Platform-Tools
Build-Tools
Command-line Tools (latest)

Luego:

flutter doctor --android-licenses

flutter doctor -v

13.3 No aparece el móvil en flutter devices

Activa Depuración USB + acepta el diálogo de confianza.
Cambia cable USB (hay cables que solo cargan).
En Windows, instala drivers del fabricante / Google USB Driver.

13.4 El emulador va lento o no arranca

Activa virtualización en BIOS/UEFI (VT-x/AMD-V).
Reduce resolución del emulador o usa un modelo más ligero.
Si tu PC es justo, prioriza móvil físico.

13.5 Conflicto de Java/Gradle

Usa el JDK que trae Android Studio (suele ser lo recomendado).
Actualiza Flutter y tus dependencias si el proyecto es antiguo.

flutter upgrade

flutter clean

flutter pub get

Si estás abriendo un proyecto viejo, puede requerir actualizar Gradle/AGP. En esos casos, la solución depende de la versión exacta del proyecto.

14) Buenas prácticas y consejos

Configuración recomendada

Instala Flutter en una ruta simple.
Mantén Android Studio actualizado.
Usa flutter doctor -v como “radar” de problemas.
Prueba tanto emulador como móvil real (bugs distintos).

Para proyectos reales

Configura firmas (keystore) antes de publicar.
Usa flavors/entornos si tendrás dev/staging/prod.
Automatiza builds con CI si el proyecto crece.

Checklist final (si todo está bien)

flutter --version funciona
flutter doctor -v sale mayormente en verde
Android Studio reconoce Flutter/Dart
Hay un dispositivo disponible (emulador o móvil)
Puedes crear y ejecutar un proyecto de ejemplo

¡Listo! Ya tienes Android Studio preparado para desarrollar apps con Flutter.

Guía completa: Configurar Android Studio para Flutter (de cero a primera app)