Skip to content

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:

    @Test
    fun walkthrough() {
        languageEn()
        ActivityScenario.launch(MainActivity::class.java)
        pause(3000)
        logOut()

        // ─── die Anmeldung
        pause(1000)
        capture("case-01")
        typeIn("Login", "admin")
        typeIn("Password", "wrong")
        typeIn("Type the characters shown in the image", "test")
        button("Log in").performClick()
        waitFor("Incorrect", substring = true)
        pause(1000)
        capture("case-02")

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:

node --version
npm --version

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:

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