2. Einrichtung der Arbeitsumgebung
2.1. Installation der Werkzeuge
-
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:
-
Visual Studio Code (VSCode): kostenlos herunterladbar unter code.visualstudio.com. Installieren Sie die Erweiterung [Flutter] (die auch die Erweiterung [Dart] installiert).
-
[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:

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

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

- Erstellen Sie in [4] eine App;

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

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

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

- 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:
Wenn alles in Ordnung ist, erhalten Sie ein Ergebnis wie dieses (die Versionsnummern können abweichen):
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.
Listen Sie nun die von Flutter erkannten Anwendungen (Geräte) auf:
In Spalte 2 finden Sie die IDs der erkannten Geräte. So starten Sie die Flutter-App auf einem davon:
Um zum Beispiel die App [flutter_application_1] im Browser Edge zu starten:
Im Browser Edge erscheint folgendes Ergebnis:

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.
- [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.

- Ö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.
- [SDK Platforms]-Tab: Prüfen Sie, ob eine aktuelle [Android]-Plattform installiert ist (die [Flutter]-Dokumentation nennt zum Zeitpunkt der Erstellung Version 36).

- [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.
- 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:
[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.
- [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.
- Ö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]).

- 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].



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

- 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]):
[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] .
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“):

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:
- 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.
- Aktivieren Sie [USB debugging] im Menü [Developer options] (das im vorherigen Schritt hinzugefügt wurde).
- 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]).
- Ü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]:
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.