14. Anhänge
Die Installation von [Android Studio], des Emulators und die Einrichtung eines Telefons sind im Kapitel „Einrichtung der Entwicklungsumgebung“ beschrieben. Diese Anhänge ergänzen jenes Kapitel.
14.1. Android Studio verwenden
- [File / Open]: ein Projekt öffnen ([examples_kotlin], [rdvmedecins_kotlin]); [Gradle] „synchronisiert“ es (lädt die Bibliotheken herunter);
- Die Schaltfläche [Run] (oder Umschalt-F10) installiert die App auf dem in der Symbolleiste gewählten Gerät und startet sie; [Debug] (Umschalt-F9) startet sie mit dem Debugger (Haltepunkte, Variablen);
- [Apply Changes] ersetzt den Code einer laufenden Anwendung, wenn möglich, ohne sie neu zu starten;
- die Annotation [@Preview] an einer parameterlosen [@Composable]-Funktion zeigt diese im Editor an, ohne Emulator;
- der „Layout Inspector“ ([Tools / Layout Inspector]) zeigt den Komponentenbaum des aktuellen Bildschirms und die Anzahl der Recompositions jeder Komponente an; „App Inspection“ zeigt Netzwerkanfragen ([OkHttp]) und Datenbanken an;
- Alt-Eingabe bei einem Fehler schlägt Korrekturen vor (ein [import] hinzufügen ...); Strg-Alt-L formatiert die Datei neu;
- Kommandozeile: [adb devices] (angeschlossene Geräte), [adb reverse tcp:8080 tcp:8080] (Port 8080 des Geräts mit dem Port des Rechners verbinden), [adb install file.apk] (eine App installieren), [adb logcat] (das Telefonprotokoll; in [Android Studio] das Fenster [Logcat]), [emulator -list-avds], dann [emulator -avd Pixel_8] (einen Emulator ohne [Android Studio] starten).
14.2. Screenshots in diesem Dokument
Die Screenshots wurden automatisch von INSTRUMENTIERTEN Tests erzeugt: [JUnit]-Tests, die AUF dem Emulator – im selben Prozess wie die Anwendung – laufen und sie über die Testbibliothek von [Compose] steuern (eine Komponente anhand ihres Textes finden, antippen, darin tippen usw.). Sie befinden sich in den Ordnern [app/src/androidTest] der beiden Projekte: [Captures.kt] (eine Testfunktion pro Beispiel) und [CaseStudyCaptures.kt] (ein vollständiger Durchlauf der Anwendung). Ein Auszug:
Die Skripte [tools/captures_examples.bat] und [tools/captures_case_study.bat] starten bei Bedarf den Emulator, kompilieren und installieren die Anwendung und ihre Tests, richten den Emulator ein (Sprache, Statusleiste im „Demo-Modus“), führen die Tests aus ([adb shell am instrument]) und rufen anschließend die Bilder ab. Der JSON-Server muss gestartet sein, zusammen mit [CAPTCHA_TEST=test].
14.3. Node.js installieren
[Node.js] wird von nodejs.org heruntergeladen: Wählen Sie die Version LTS (Langzeitunterstützung). Das [Windows]-Installationsprogramm installiert auch [npm]. Es wird nur für den JSON-Server benötigt. Prüfen Sie die Installation in einer Konsole:
14.4. MySQL mit Laragon installieren
Der JSON-Server benötigt [MySQL] (oder [MariaDB]). [Laragon] (laragon.org) installiert eine einsatzbereite Instanz unter [Windows] mit dem Administrationswerkzeug [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üeintrag File / Run SQL das Skript [database/dbrdvmedecins2.sql] aus.
Installieren Sie unter [Linux] oder [macOS] [MySQL] oder [MariaDB] mit dem Paketmanager des Systems und führen Sie das Skript mit dem Kommandozeilen-Client aus: [mysql -u root -p < database/dbrdvmedecins2.sql].
14.5. curl installieren
[curl] ist in den [Windows] -Versionen 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, beginnend mit 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.