Skip to content

2. Einrichtung der Arbeitsumgebung

2.1. Installation der Werkzeuge

  1. Node.js: Laden Sie Version 22 (oder höher) von nodejs.org herunter und installieren Sie sie. Überprüfen Sie die Installation in einem Terminal:

    node --version
    npm --version
    
  2. Visual Studio Code (VSCode): kostenlos herunterladbar unter code.visualstudio.com. Installieren Sie die Erweiterung [Flutter] (die auch die Erweiterung [Dart] installiert).

  3. [MySQL] 8: Installieren Sie es zum Beispiel über XAMPP, Laragon (unter Windows) oder direkt über den [MySQL] Community Server. Ein grafisches Administrationswerkzeug (phpMyAdmin, [MySQL] Workbench, DBeaver, HeidiSQL …) erleichtert die Arbeit. Im Folgenden wird das Werkzeug Laragon verwendet.

2.2. Installation des Flutter-Clients

Starten Sie VSCode, ohne ein Projekt anzugeben:

Image

  • Öffnen Sie in [1-2] die Befehlspalette;

Image

  • Erstellen Sie in [3] ein neues Flutter-Projekt;

Image

  • Erstellen Sie in [4] eine App;

Image

  • Geben Sie in [5-6] einen Ordner an, in dem der Projektunterordner erstellt wird;

Image

  • Benennen Sie in [6] das Projekt. Dies ist auch der Name des für das Projekt erstellten Ordners;

Image

  • Geben Sie in [1-3] die Ziele des Projekts an [1 – Android application, 2 – desktop application, 3 – web application];

Image

  • Bei [4] das erstellte Projekt. VSCode lädt das Flutter SDK automatisch herunter;

Der Befehl [flutter doctor] prüft Ziel für Ziel, ob alles vorhanden ist, was [Flutter] benötigt. Führen Sie ihn in einem VSCode-Terminal des neu erstellten Flutter-Projekts aus:

flutter doctor

Wenn alles in Ordnung ist, erhalten Sie ein Ergebnis wie dieses (die Versionsnummern können abweichen):

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!

Jede Zeile beginnt mit einem Symbol: [√] (alles in Ordnung), [!] (Warnung: Ein Element fehlt, was das Funktionieren des Codes nicht unbedingt verhindert) oder [X] (Fehler). Für diesen Kurs sind die Zeilen [Flutter], [Android toolchain] (Kompilierung für ein Telefon), [Android] und [Connected device] (mindestens ein erkanntes Gerät, konkret das Telefon) relevant. Die Zeilen [Chrome] (Webziel) und [Visual Studio] (Windows-Ziel) betreffen nur diese Ziele: Ein [!] oder [X] bei einem Ziel, das Sie nicht verwenden, können Sie ignorieren.

Meldet [Android toolchain] „cmdline-tools component is missing“, installieren Sie [Android SDK Command-line Tools] (siehe unten); meldet es „Android license status unknown“, akzeptieren Sie die Lizenzen (Schritt 5). Der Befehl [flutter doctor -v] liefert Details zu jeder Prüfung.

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!

Listen Sie nun die von Flutter erkannten Anwendungen (Geräte) auf:

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

In Spalte 2 finden Sie die IDs der erkannten Geräte. So starten Sie die Flutter-App auf einem davon:

flutter run -d <device_id>

Um zum Beispiel die App [flutter_application_1] im Browser Edge zu starten:

flutter run -d edge

Im Browser Edge erscheint folgendes Ergebnis:

Image

Wir beschreiben nun, wie die Werkzeuge für die Android-Entwicklung installiert werden.

2.3. Android Studio und die Android-Befehlszeilenwerkzeuge

Das Zielgerät für diesen Kurs ist ein [Android]-Telefon. Um die Anwendung zu kompilieren und auf diesem Telefon zu installieren, benötigt [Flutter] das [Android] SDK, das zusammen mit [Android Studio], der Entwicklungsumgebung von Google, installiert wird. [Android Studio] wird nicht zum Schreiben von Code verwendet – der Editor bleibt [VSCode] –, es dient hier ausschließlich dazu, das [Android] SDK zu installieren und zu aktualisieren.

  1. [Android Studio]: Laden Sie es kostenlos von [https://developer.android.com/studio] herunter und installieren Sie es. Beim ersten Start bietet der Assistent eine Standardinstallation an: Akzeptieren Sie sie, und er lädt das [Android] SDK herunter.

Image

  1. Öffnen Sie den [SDK Manager] aus [Android Studio] (über das Menü [Tools / SDK Manager], wenn ein Projekt geöffnet ist, oder über [More Actions / SDK Manager] auf dem Startbildschirm): Dies ist das Werkzeug, das die Komponenten des [Android] SDK installiert und aktualisiert.
  1. [SDK Platforms]-Tab: Prüfen Sie, ob eine aktuelle [Android]-Plattform installiert ist (die [Flutter]-Dokumentation nennt zum Zeitpunkt der Erstellung Version 36).

Image

  1. [SDK Tools]-Tab: Aktivieren Sie [Android SDK Command-line Tools (latest)], [Android SDK Build-Tools] und [Android SDK Platform-Tools] (sowie [Android Emulator] , wenn Sie auf einem Emulator testen möchten) und klicken Sie dann auf [Apply]. Die Dokumentation von [Flutter] empfiehlt außerdem [CMake] und [NDK (Side by side)]. Es sind die Pakete [Android SDK Command-line Tools] , die fehlen, wenn [flutter doctor] „cmdline-tools component is missing“ anzeigt.
  2. Akzeptieren Sie die Lizenzen für das [Android] SDK , indem Sie den folgenden Befehl in einem Terminal innerhalb des Flutter-Projekts eingeben und dann jede Frage mit „[y]“ beantworten, bis die Meldung „All SDK package licenses accepted.“ erscheint:
flutter doctor --android-licenses

[Note]: Bei Version 23.0 der [Android SDK Command-line Tools] kann der obige Befehl sofort ohne jede Rückfrage beendet werden und „The --licenses option is no longer needed.“ anzeigen. Dies ist ein bekanntes Problem in [Flutter] (Issues 191558 und 191487 auf github.com/flutter/flutter). Abhilfe: Aktivieren Sie im [SDK Manager] im [SDK Tools]-Tab die Option [Show Package Details], ersetzen Sie Version 23.0 der [Android SDK Command-line Tools] durch Version 22.0, klicken Sie auf [Apply], und führen Sie den Befehl dann erneut aus.

2.4. Einrichtung eines Android-Emulators

Wenn Sie kein Telefon haben, können Sie die App auf einem [Android]-Emulator testen: einem virtuellen Telefon, das in einem Fenster auf Ihrem Computer läuft. [Android Studio] installiert das Programm [Android Emulator] (sofern es im [SDK Manager] aktiviert war, siehe oben), stellt aber kein gebrauchsfertiges virtuelles Gerät bereit: Sie müssen eines erstellen.

  1. [Prerequisite]: Im [BIOS] des Computers muss die Virtualisierung aktiviert sein, und unter [Windows] muss das Feature [Windows Hypervisor Platform] aktiviert sein ([Control Panel / Programs / Turn Windows features on or off]), was einen Neustart erfordert. Andernfalls startet der Emulator nicht oder bleibt sehr langsam.
  2. Öffnen Sie den [Device Manager] aus [Android Studio]: [More Actions / Virtual Device Manager] auf dem Startbildschirm oder [Tools / Device Manager] , wenn ein Projekt geöffnet ist (je nach Version: [View / Tool Windows / Device Manager]).

Image

  1. Klicken Sie auf [Create Device], wählen Sie eine Vorlage (zum Beispiel [Pixel 8]) und dann [Next]. Wählen Sie ein aktuelles [Android]-Systemabbild für den Prozessor [x86_64] und laden Sie es über den Link [Download] daneben herunter, dann [Next] und [Finish].

Image

Image

Image

  1. Starten Sie den Emulator über die Schaltfläche [Play] im [Device Manager]:

Image

  1. Warten Sie, bis der [Android]-Startbildschirm im Emulatorfenster erscheint: Der erste Start kann mehrere Minuten dauern. Überprüfen Sie dann, ob [Flutter] den Emulator erkennt, der in der Liste erscheinen sollte (zum Beispiel [emulator-5554], Plattform [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]: Wenn [flutter devices] den Emulator nicht anzeigt, sondern stattdessen die Meldung „Device emulator-5554 is offline“, ist der Emulator noch nicht vollständig gestartet, oder [adb] (das Werkzeug, das den Computer mit dem Gerät verbindet und zusammen mit den [Android SDK Platform-Tools] installiert wird) befindet sich in einem inkonsistenten Zustand. Versuchen Sie der Reihe nach Folgendes: (1) Warten Sie, bis der Begrüßungsbildschirm erscheint, und führen Sie den Befehl erneut aus; (2) starten Sie [adb] mit den folgenden drei Befehlen neu (unter [Windows] in [PowerShell]), wobei der letzte „device“ statt „offline“ anzeigen sollte; (3) wählen Sie im [Device Manager] -Menü des Geräts ([⋮]) die Option [Cold Boot Now] oder als letzten Ausweg sogar [Wipe Data] .

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

Besteht das Problem weiterhin, prüfen Sie mit [where.exe adb], ob sich kein anderes [adb] in einer anderen Version im [PATH] befindet: Zwei Versionen von [adb] , die um die Verbindung konkurrieren, verursachen dieses Problem.

Sobald der Emulator erkannt wird, startet die Anwendung mit dem folgenden Befehl darauf (siehe den Abschnitt „Installation und Ausführung“):

flutter run -d emulator-5554

Image

Vorbereitung des Android-Telefons

Um die Anwendung auf einem echten [Android]-Telefon auszuführen, muss das Telefon so eingestellt sein, dass es vom Computer aus gesteuert werden darf:

  1. Aktivieren Sie die Entwickleroptionen: Öffnen Sie [Settings / About phone] und tippen Sie dann mehrmals (normalerweise 7-mal) auf [Build number], bis das Telefon anzeigt, dass Sie nun Entwickler sind. Die genauen Bezeichnungen variieren je nach Hersteller.
  2. Aktivieren Sie [USB debugging] im Menü [Developer options] (das im vorherigen Schritt hinzugefügt wurde).
  3. Verbinden Sie das Telefon über ein USB-Kabel, das Daten überträgt (und nicht nur das Telefon lädt), mit dem Computer und akzeptieren Sie auf dem Telefon die Anfrage zur USB-Debugging-Autorisierung. Wenn das Telefon unter Windows nicht erkannt wird, installieren Sie den USB-Treiber des Herstellers („OEM USB drivers“, siehe [https://developer.android.com/studio/run/oem-usb]).
  4. Überprüfen Sie, ob [Flutter] das Telefon erkennen kann: Es sollte in der Liste erscheinen, die der folgende Befehl anzeigt, zusammen mit der Plattform [android]:
flutter devices

Das Telefon greift über die IP-Adresse des Computers im lokalen Netzwerk auf den [NestJS]-Server zu (nicht über [localhost]): Diese Konfiguration wird in Kapitel 5 beschrieben.