Skip to content

2. Capítulo 1 - 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
    
  1. Visual Studio Code (VSCode): disponible para descarga gratuita en code.visualstudio.com. Instale la extensión “TypeScript and JavaScript Language Features” (normalmente ya incluida).
  1. [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…) simplifica el proceso. En lo sucesivo se utiliza la herramienta Laragon.
  2. Postman: disponible para descarga gratuita en postman.com.

2.1.1. Instalación del cliente Flutter

Inicie VSCode sin seleccionar ningún 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 vacía;

Image

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

Image

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

Image

  • en [1-3], especifique los destinos del proyecto [1 – Android application, 2 – desktop application, 3 – web application];

Image

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

Si ha descargado el código de este documento, este se encuentra en dos carpetas:

Image

Image

  • en [1], el cliente [Flutter];
  • en [2], el servidor [NestJS];
  • en [3], el contenido de [2]. Copie todo este contenido en la carpeta de su proyecto Flutter. Aparecerán nuevos elementos en su proyecto:

Image

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

flutter doctor

Cuando todo es correcto, se obtiene un resultado como el siguiente (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, concretamente el teléfono). Las líneas [Chrome] (destino web) y [Visual Studio] (destino Windows) solo se aplican 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 puede iniciar la aplicación Flutter incluso si el servicio web con el que debe comunicarse no se ha iniciado. Primero, liste las aplicaciones (dispositivos) reconocidas por Flutter:

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

En la columna 2 encontrará los identificadores de los dispositivos reconocidos. Para iniciar la aplicación Flutter en uno de ellos:

flutter run -d <device_id>

Por ejemplo, para iniciar la aplicación en el navegador Chrome con el identificador (chrome):

flutter run -d chrome

Esto produce el siguiente resultado (o un error de conexión con el servidor):

Image

Es posible que no tenga instalado el SDK de Android requerido por Flutter. A continuación se describe cómo instalarlo.

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

El destino móvil 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 utiliza únicamente para instalar y actualizar el SDK de [Android].

  1. [Android Studio]: Descárguelo gratuitamente 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 se descargará el SDK de [Android].

Image

  1. Abra [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): esta es la herramienta que instala y actualiza los componentes del SDK de [Android].
  2. Pestaña [SDK Platforms]: verifique que esté instalada una plataforma [Android] reciente (la documentación de [Flutter] especifica la versión 36 al momento de escribir este texto).

Image

  1. Pestaña [SDK Tools]: 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 [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] escribiendo el siguiente comando en una terminal dentro del proyecto Flutter y respondiendo luego “[y]” a cada pregunta hasta que aparezca 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, y mostrar “The --licenses option is no longer needed.” Es un problema conocido de [Flutter] (problemas 191558 y 191487 en github.com/flutter/flutter). Solución alternativa: en [SDK Manager], pestaña [SDK Tools], 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.1.3. Creación de un emulador de Android

Si no tiene un teléfono, puede probar la aplicación en un emulador de [Android]: un teléfono virtual que se ejecuta en una ventana de su computadora. [Android Studio] instala el programa [Android Emulator] (si se marcó en el [SDK Manager], véase más arriba), pero no proporciona un dispositivo virtual listo para usar: debe 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 un reinicio. De lo contrario, el emulador no se iniciará o será muy lento.
  2. Abra [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 mediante el enlace [Download] ubicado junto a ella; después, [Next] y [Finish].

Image

Image

Image

  1. Inicie el emulador con el botón [Play] del [Device Manager] o desde una terminal (el primer comando lista los emuladores y sus identificadores):
    flutter emulators
    flutter emulators --launch <id>
    

Image

  1. Espere a que aparezca la pantalla de bienvenida de [Android] en la ventana del emulador: el primer inicio 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 [Device Manager], en el menú [⋮] 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, presente en el [PATH]: dos versiones de [adb] que compiten por la conexión causan este problema.

Una vez que se reconoce el emulador, la aplicación se inicia en él con el siguiente comando. Nota: en el emulador, [localhost] se refiere al propio emulador y no a la computadora; el campo “Server URL” debe contener [http://10.0.2.2:8080] (véase el capítulo 5).

flutter run -d emulator-5554

Image

2.1.4. Preparación del teléfono Android

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

  1. Habilite las opciones de desarrollador: abra [Settings / About phone] y luego toque [Build number] varias veces (normalmente 7) hasta que el teléfono indique que usted es desarrollador. Los nombres exactos varían según el fabricante.
  2. Habilite [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 (y no solo cargue el teléfono) y acepte en el teléfono la solicitud de permiso de depuración USB. En Windows, si el teléfono no se reconoce, instale el controlador USB del fabricante (“OEM USB drivers”, véase [https://developer.android.com/studio/run/oem-usb]).
  4. Verifique que [Flutter] detecte 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 (y no mediante [localhost]): esta configuración se describe en el capítulo 5.