Skip to content

2. Configuración del entorno de trabajo

2.1. Instalación de las herramientas

  1. Node.js: descargue e instale la versión 22 (o posterior) desde nodejs.org. Verifique la instalación en una terminal:

    node --version
    npm --version
    
  2. Visual Studio Code (VSCode): disponible para descarga gratuita en code.visualstudio.com. Instale la extensión [Flutter] (que también instala la extensión [Dart]).

  3. [MySQL] 8: instálelo, por ejemplo, mediante XAMPP, Laragon (en Windows), o directamente mediante [MySQL] Community Server. Una herramienta gráfica de administración (phpMyAdmin, [MySQL] Workbench, DBeaver, HeidiSQL…) facilita el proceso. En lo sucesivo se utiliza la herramienta Laragon.

2.2. Instalación del cliente Flutter

Inicie VSCode sin especificar un proyecto:

Image

  • En [1-2], abra la paleta de comandos;

Image

  • En [3], cree un nuevo proyecto Flutter;

Image

  • en [4], cree una aplicación;

Image

  • En [5-6], especifique una carpeta donde se creará la subcarpeta del proyecto;

Image

  • en [6], asigne un nombre al proyecto. Este será también el nombre de la carpeta creada para el proyecto;

Image

  • En [1-3], especifique los destinos del proyecto en [1 – aplicación Android, 2 – aplicación de escritorio, 3 – aplicación web];

Image

  • en [4], el proyecto creado. VSCode descarga automáticamente el SDK de Flutter;

El comando [flutter doctor] verifica que todo lo que [Flutter] necesita esté en su lugar, destino por destino. Ejecútelo en una terminal de VSCode del proyecto Flutter recién creado:

flutter doctor

Cuando todo es correcto, se obtiene un resultado como este (los números de versión pueden variar):

PS C:\Data\st-2026\dev\flutter-nestjs-sept-2026\flutter_application_1> flutter doctor
Doctor summary (to see all details, run flutter doctor -v):
[√] Flutter (Channel stable, 3.44.9, on Microsoft Windows [version 10.0.26200.9457], locale fr-FR)
[√] Windows Version (Windows 11 or higher, 25H2, 2009)
[√] Android toolchain - develop for Android devices (Android SDK version 37.0.0)
[√] Chrome - develop for the web
[√] Visual Studio - develop Windows apps (Visual Studio Build Tools 2026 18.9.0)
[√] Connected device (3 available)
[√] Network resources

• No issues found!

Cada línea comienza con un símbolo: [√] (todo está bien), [!] (advertencia: falta un elemento, lo que no impide necesariamente que el código funcione) o [X] (error). Para este curso, las líneas relevantes son [Flutter], [Android toolchain] (compilación para un teléfono), [Android] y [Connected device] (al menos un dispositivo detectado, en concreto el teléfono). Las líneas [Chrome] (destino web) y [Visual Studio] (destino Windows) se aplican solo a esos destinos: un [!] o un [X] en un destino que no se utiliza puede ignorarse.

Si [Android toolchain] informa “cmdline-tools component is missing”, instale [Android SDK Command-line Tools] (véase más adelante); si informa “Android license status unknown”, acepte las licencias (paso 5). El comando [flutter doctor -v] proporciona detalles sobre cada verificación.

PS C:\Data\st-2026\dev\flutter-nestjs-sept-2026\flutter_application_1> flutter doctor -v
[√] Flutter (Channel stable, 3.44.9, on Microsoft Windows [version 10.0.26200.9457], locale fr-FR) [305ms]
    • Flutter version 3.44.9 on channel stable at C:\Users\serge\flutter
    • Upstream repository https://github.com/flutter/flutter.git
    • Framework revision 6b182d2c75 (7 weeks ago), 2026-08-05 10:04:07 -0700
    • Engine revision 5a2a6a42cc
    • Dart version 3.12.2
    • DevTools version 2.57.0
    • Feature flags: enable-web, enable-linux-desktop, enable-macos-desktop, enable-windows-desktop,
      enable-android, enable-ios, cli-animations, enable-native-assets, enable-swift-package-manager,
      omit-legacy-version-file, enable-lldb-debugging, enable-uiscene-migration

[√] Windows Version (Windows 11 or higher, 25H2, 2009) [895ms]

[√] Android toolchain - develop for Android devices (Android SDK version 37.0.0) [1 793ms]
    • Android SDK at C:\Users\serge\AppData\Local\Android\sdk
    • Emulator version 37.1.11.0 (build_id 15917651) (CL:N/A)
    • Platform android-37.0, build-tools 37.0.0
    • Java binary at: C:\Program Files\Android\Android Studio\jbr\bin\java
      This is the JDK bundled with the latest Android Studio installation on this machine.
      To manually set the JDK path, use: `flutter config --jdk-dir="path/to/jdk"`.
    • Java version OpenJDK Runtime Environment (build 25.0.3+-15898627-b508.16)
    • All Android licenses accepted.

[√] Chrome - develop for the web [114ms]
    • Chrome at C:\Program Files\Google\Chrome\Application\chrome.exe

[√] Visual Studio - develop Windows apps (Visual Studio Build Tools 2026 18.9.0) [113ms]
    • Visual Studio at C:\Program Files (x86)\Microsoft Visual Studio\18\BuildTools
    • Visual Studio Build Tools 2026 version 18.9.12105.275
    • Windows 10 SDK version 10.0.26100.0

[√] Connected device (3 available) [216ms]
    • Windows (desktop) • windows • windows-x64    • Microsoft Windows [version 10.0.26200.9457]
    • Chrome (web)      • chrome  • web-javascript • Google Chrome 151.0.7922.174
    • Edge (web)        • edge    • web-javascript • Microsoft Edge 153.0.4234.48

[√] Network resources [274ms]
    • All expected network resources are available.

• No issues found!

Ahora, liste las aplicaciones (dispositivos) reconocidas por Flutter:

1
2
3
4
5
6
7
PS ...> flutter devices                 
Found 4 connected devices:
sdk gphone16k x86 64 (mobile) • emulator-5554 • android-x64    • Android 17 (API 37) (emulator)
Windows (desktop)             • windows       • windows-x64    • Microsoft Windows [version
10.0.26200.9457]
Chrome (web)                  • chrome        • web-javascript • Google Chrome 153.0.8010.48
Edge (web)                    • edge          • web-javascript • Microsoft Edge 153.0.4234.48

En la columna 2 se encuentran los identificadores de los dispositivos reconocidos. Para lanzar la aplicación Flutter en uno de ellos:

flutter run -d <device_id>

Por ejemplo, para lanzar la aplicación [flutter_application_1] en el navegador Edge:

flutter run -d edge

El siguiente resultado aparece en el navegador Edge:

Image

A continuación describiremos cómo instalar las herramientas para el desarrollo en Android.

2.3. Android Studio y las herramientas de línea de comandos de Android

El dispositivo de destino de este curso es un teléfono [Android]. Para compilar la aplicación e instalarla en este teléfono, [Flutter] requiere el SDK de [Android], que se instala junto con [Android Studio], el entorno de desarrollo de Google. [Android Studio] no se utiliza para escribir código (el editor sigue siendo [VSCode]); aquí se usa únicamente para instalar y actualizar el SDK de [Android].

  1. [Android Studio]: descárguelo gratis desde [https://developer.android.com/studio] y luego instálelo. Al iniciarlo por primera vez, el asistente ofrecerá una instalación estándar: acéptela y descargará el SDK de [Android].

Image

  1. Abra el [SDK Manager] desde [Android Studio] (el menú [Tools / SDK Manager] cuando hay un proyecto abierto, o [More Actions / SDK Manager] desde la pantalla de inicio): es la herramienta que instala y actualiza los componentes del SDK de [Android].
  1. [SDK Platforms] pestaña: verifique que esté instalada una plataforma [Android] reciente (la documentación de [Flutter] indica la versión 36 en el momento de escribir este texto).

Image

  1. [SDK Tools] pestaña: marque [Android SDK Command-line Tools (latest)], [Android SDK Build-Tools] y [Android SDK Platform-Tools] (así como [Android Emulator] si desea probar en un emulador) y luego haga clic en [Apply]. La documentación de [Flutter] también recomienda [CMake] y [NDK (Side by side)]. Son los paquetes de [Android SDK Command-line Tools] los que faltan cuando [flutter doctor] muestra “cmdline-tools component is missing”.
  2. Acepte las licencias del SDK de [Android] ingresando el siguiente comando en una terminal dentro del proyecto Flutter y respondiendo “[y]” a cada pregunta hasta ver el mensaje “All SDK package licenses accepted.”:
flutter doctor --android-licenses

[Note]: con la versión 23.0 de [Android SDK Command-line Tools], el comando anterior puede terminar de inmediato, sin solicitar nada, mostrando “The --licenses option is no longer needed.” Se trata de un problema conocido de [Flutter] (issues 191558 y 191487 en github.com/flutter/flutter). Solución alternativa: en [SDK Manager], [SDK Tools] pestaña, marque [Show Package Details], reemplace la versión 23.0 de [Android SDK Command-line Tools] por la versión 22.0, haga clic en [Apply], y luego vuelva a ejecutar el comando.

2.4. Configuración de un emulador de Android

Si no tiene un teléfono, puede probar la aplicación en un emulador [Android]: un teléfono virtual que se ejecuta en una ventana de su computadora. [Android Studio] instala el programa [Android Emulator] (si estaba marcado en el [SDK Manager], véase más arriba), pero no proporciona un dispositivo virtual listo para usar: es necesario crear uno.

  1. [Prerequisite]: la virtualización debe estar habilitada en el [BIOS] de la computadora y, en [Windows], debe estar marcada la característica [Windows Hypervisor Platform] ([Control Panel / Programs / Turn Windows features on or off]), lo que requiere reiniciar. De lo contrario, el emulador no se iniciará o será muy lento.
  2. Abra el [Device Manager] desde [Android Studio]: [More Actions / Virtual Device Manager] desde la pantalla de inicio, o [Tools / Device Manager] cuando hay un proyecto abierto (según la versión: [View / Tool Windows / Device Manager]).

Image

  1. Haga clic en [Create Device], seleccione una plantilla (por ejemplo, [Pixel 8]) y luego [Next]. Seleccione una imagen de sistema [Android] reciente para el procesador [x86_64] y descárguela con el enlace [Download] que aparece junto a ella; después, [Next] y [Finish].

Image

Image

Image

  1. Inicie el emulador con el botón [Play] del [Device Manager]:

Image

  1. Espere a que aparezca la pantalla de inicio de [Android] en la ventana del emulador: el primer arranque puede tardar varios minutos. Luego verifique que [Flutter] reconozca el emulador, que debería aparecer en la lista (por ejemplo, [emulator-5554], plataforma [android-x64]):
flutter devices
1
2
3
4
5
6
7
PS C:\Data\st-2026\dev\flutter-nestjs-sept-2026\rdvmedecins_flutter_client> flutter devices
Found 4 connected devices:
  sdk gphone16k x86 64 (mobile) • emulator-5554 • android-x64    • Android 17 (API 37) (emulator)
  Windows (desktop)             • windows       • windows-x64    • Microsoft Windows [version
  10.0.26200.9457]
  Chrome (web)                  • chrome        • web-javascript • Google Chrome 153.0.8010.48
  Edge (web)                    • edge          • web-javascript • Microsoft Edge 153.0.4234.48

[Note]: si [flutter devices] no muestra el emulador sino el mensaje “Device emulator-5554 is offline”, el emulador no ha terminado de iniciarse o [adb] (la herramienta que conecta la computadora con el dispositivo, instalada junto con [Android SDK Platform-Tools]) se encuentra en un estado inconsistente. Pruebe lo siguiente en orden: (1) espere a que aparezca la pantalla de bienvenida y vuelva a ejecutar el comando; (2) reinicie [adb] con los tres comandos siguientes (en [Windows], dentro de [PowerShell]), de modo que el último muestre “device” en lugar de “offline”; (3) en el menú [Device Manager] del dispositivo ([⋮]), seleccione [Cold Boot Now], o incluso [Wipe Data] como último recurso.

1
2
3
& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" kill-server
& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" start-server
& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" devices

Si el problema persiste, utilice [where.exe adb] para verificar que no haya otro [adb], de una versión diferente, en el [PATH]: dos versiones de [adb] que compiten por la conexión causan este problema.

Una vez reconocido el emulador, la aplicación se lanza en él con el siguiente comando (véase la sección “Instalación y ejecución”):

flutter run -d emulator-5554

Image

Preparación del teléfono Android

Para ejecutar la aplicación en un teléfono [Android] real, el teléfono debe configurarse para permitir el control desde la computadora:

  1. Habilite las opciones de desarrollador: abra [Settings / About phone] y toque varias veces [Build number] (normalmente 7) hasta que el teléfono indique que usted es desarrollador. Los nombres exactos varían según el fabricante.
  2. Habilite la [USB debugging] en el menú [Developer options] (agregado en el paso anterior).
  3. Conecte el teléfono a la computadora con un cable USB que transfiera datos (no que solo cargue el teléfono) y acepte en el teléfono la solicitud de autorización de depuración USB. En Windows, si el teléfono no es reconocido, instale el controlador USB del fabricante (“OEM USB drivers”, véase [https://developer.android.com/studio/run/oem-usb]).
  4. Verifique que [Flutter] pueda detectar el teléfono: debe aparecer en la lista que muestra el siguiente comando, junto con la plataforma [android]:
flutter devices

El teléfono accederá al servidor [NestJS] mediante la dirección IP de la computadora en la red local (no mediante [localhost]): esta configuración se describe en el capítulo 5.