14. Anhänge
14.1. Installation von Flutter
Das [Flutter]-SDK kann von docs.flutter.dev heruntergeladen werden (wählen Sie [Windows], dann [Android]). Es ist ein einfacher komprimierter Ordner, den Sie in einen Ordner OHNE Leerzeichen oder Umlaute bzw. Akzente entpacken (z. B. [C:\dev\flutter]) und dessen Unterordner [bin] dann zur Umgebungsvariablen [Path] des Benutzers hinzufügen. Das [Dart]-SDK ist enthalten. Überprüfen Sie die Installation in einer neuen Konsole:
[flutter doctor] prüft alles, was [Flutter] benötigt: SDK, [Android] samt Lizenzen, [Chrome], [Visual Studio] (für [Windows]-Anwendungen), angeschlossene Geräte und Netzwerkzugriff. Vor jeder Zeile steht ein Häkchen [√] , wenn alles in Ordnung ist, ein X [X] oder ein Ausrufezeichen [!] andernfalls, mit Anweisungen darunter, was zu tun ist. [flutter doctor -v] liefert Details (Versionen, Pfade).
Die Zeile „Visual Studio“ betrifft nur [Windows]-Anwendungen (den Beispielordner [windows/] ): Sie kann einen Fehler anzeigen, wenn Sie nur mobile Geräte und das Web ansteuern.
Unter [Windows] erfordern Projekte, die Pakete mit nativem Code verwenden ([shared_preferences] ...), den „Entwicklermodus“ des Systems: [flutter pub get] weist darauf hin („Building with plugins requires symlink support“). Sie können ihn unter Einstellungen / System / Für Entwickler aktivieren (Befehl [start ms-settings:developers]).
14.2. Installation von Android Studio und eines Emulators
[Android Studio] kann von developer.android.com/studio heruntergeladen werden. Es dient nicht zum Schreiben von Code, sondern zum Installieren des [Android]-SDK und zum Erstellen eines Emulators:
- Beim ersten Start installiert der Assistent das [Android]-SDK;
- Menü More Actions / SDK Manager, Registerkarte SDK Tools: Aktivieren Sie „Android SDK Command-line Tools“, die [Flutter] benötigt;
- in einer Konsole: [flutter doctor --android-licenses], und akzeptieren Sie die Lizenzen;
- Menü More Actions / Virtual Device Manager: Erstellen Sie ein virtuelles Smartphone (zum Beispiel ein „Pixel“) mit einem aktuellen System-Image. Klicken Sie auf die Schaltfläche ▶, um es zu starten; [flutter devices] erkennt es dann unter dem Namen [emulator-5554]. Sie können es auch starten, ohne [Android Studio] zu öffnen: [flutter emulators] listet die Emulatoren auf, und [flutter emulators --launch <name>] startet einen davon.
Bei einem echten Smartphone: Wenn Sie unter Einstellungen / Über das Telefon siebenmal auf „Build-Nummer“ tippen, erscheinen die „Entwickleroptionen“, in denen Sie das „USB-Debugging“ aktivieren können. Beim Anschluss an den Computer fordert das Smartphone Sie auf, den Computer zu autorisieren; [flutter devices] erkennt es dann.
14.3. Installation von Visual Studio Code
[Visual Studio Code] wird von code.visualstudio.com heruntergeladen. Installieren Sie im Bereich „Extensions“ (Strg-Umschalt-X) die [Flutter]-Erweiterung (von [Dart Code]), die auch die [Dart]-Erweiterung installiert. Sie bieten:
- Codevervollständigung, Codeprüfung während der Eingabe (anhand der Regeln aus [analysis_options.yaml]), Navigation zur Definition eines Widgets oder einer Klasse und Umbenennen im gesamten Projekt;
- Codeformatierung beim Speichern ([dart format]);
- die Geräteauswahl, unten rechts im Fenster (oder über den Befehl „Flutter: Select Device“);
- den Start mit F5 (Debugging: Haltepunkte, Variablen); bei jedem Speichern einer Datei wird die App im laufenden Betrieb neu geladen;
- Aktionen für Widgets (Strg-. auf einem Widget): „Wrap with Padding“, „Wrap with Column“, „Extract Widget“ usw. – sehr nützlich, um einen Widget-Baum umzustrukturieren.
Um ein Beispiel mit F5 auszuführen, öffnen Sie seine Datei [main.dart] , bevor Sie F5 drücken (oder erstellen Sie eine Datei namens [.vscode/launch.json]). Öffnen Sie ein Projekt über das Menü File / Open Folder (zum Beispiel den Ordner [examples_flutter]) und öffnen Sie eine Konsole über das Menü Terminal / New Terminal.
14.4. Das Flutter-Werkzeug DevTools
[Flutter DevTools] ist im SDK enthalten. Solange die Anwendung läuft, zeigt [flutter run] dessen Adresse an („The Flutter DevTools debugger and profiler... is available at: http://127.0.0.1:9101... “); in [VS Code]öffnet der Befehl „Flutter: Open DevTools“ es im Editor. Seine nützlichsten Registerkarten:
- „Flutter Inspector“: der Widget-Baum des Bildschirms und die Eigenschaften jedes Widgets. Mit „Select Widget Mode“ tippen Sie auf dem Smartphone ein Element an, um sein Widget im Baum zu finden; „Show Guidelines“ zeichnet die Ränder und Ausrichtungslinien ein. Dieses Werkzeug beantwortet die Frage „Warum sitzt dieses Widget nicht an der richtigen Stelle?“;
- „Performance“ und „CPU Profiler“: die für das Rendern und Zeichnen jedes Frames benötigte Zeit, um die Ursache einer ruckelnden Animation zu finden;
- „Network“: die HTTP-Anfragen der Anwendung einschließlich ihrer Header und Bodys; hier sehen Sie, wie das Token-Cookie gesendet und zurückgegeben wird;
- „Logging“: das, was die Anwendung ausgibt ([debugPrint]).
14.5. Installation von Node.js
[Node.js] wird von nodejs.org heruntergeladen: Wählen Sie die LTS-Version (Long-Term Support). Das [Windows]-Installationsprogramm installiert auch [npm]. Es wird nur für den JSON-Server benötigt. Überprüfen Sie die Installation in einer Konsole:
14.6. Installation von MySQL mit Laragon
Der JSON-Server benötigt [MySQL] (oder [MariaDB]). [Laragon] (laragon.org) installiert unter [Windows] eines davon, sofort einsatzbereit, mit dem Verwaltungswerkzeug [HeidiSQL]. Nach der Installation:
- Die Schaltfläche „Start All“ startet den [MySQL]-Server auf Port 3306;
- der Benutzer [root] hat kein Passwort: Dies sind die Standardwerte aus der Datei [.env.example] des Servers;
- in [HeidiSQL] (Schaltfläche „Database“) führt der Menüpunkt File / Run SQL File das Skript [database/dbrdvmedecins2.sql] aus.
Unter [Linux] oder [macOS] installieren Sie [MySQL] oder [MariaDB] mit der Paketverwaltung des Systems und führen das Skript mit dem Kommandozeilen-Client aus: [mysql -u root -p < database/dbrdvmedecins2.sql].
14.7. Installation von curl
[curl] ist in [Windows] 10 und 11, [macOS] und den meisten [Linux]-Distributionen enthalten. Prüfen Sie seine Version:
Die in diesem Dokument verwendete Option [--json] ist seit Version 7.82 (2022) verfügbar. Wenn Sie eine ältere Version verwenden, ersetzen Sie [--json @file] durch [-H "Content-Type: application/json" -d @file] oder installieren Sie eine aktuelle Version von curl.se.
Geben Sie in [PowerShell] [curl.exe] ein, nicht [curl]: In [PowerShell] ist [curl] ein Alias für einen anderen Befehl ([Invoke-WebRequest]), der die Optionen von [curl] nicht enthält. Die Eingabeaufforderung ([cmd]) hat dieses Problem nicht.