chore: initial import

android/BUILD.md

@@ -0,0 +1,67 @@
+# Lokaler Build
+
+## Voraussetzungen
+
+- Android Studio mit JDK 17
+- Android SDK Platform 35
+- Android SDK Build-Tools für API 35
+- Internetzugriff auf Google Maven, Maven Central und die Gradle-Distribution beim ersten Build
+
+Minimum SDK der App ist 26. Zugangsdaten gehören nicht in `local.properties`, Gradle-Dateien oder Quellcode; sie werden erst in der App eingegeben.
+
+## Projekt öffnen
+
+1. Das Projektverzeichnis in Android Studio öffnen.
+2. Falls nötig, in `local.properties` ausschließlich den lokalen SDK-Pfad setzen, zum Beispiel:
+
+```properties
+sdk.dir=/home/user/Android/Sdk
+```
+
+3. Gradle synchronisieren.
+4. Die Build-Variante `debug` wählen.
+
+## Kommandozeile
+
+Linux/macOS:
+
+```bash
+./gradlew test
+./gradlew lintDebug
+./gradlew assembleDebug
+```
+
+Windows:
+
+```bat
+gradlew.bat test
+gradlew.bat lintDebug
+gradlew.bat assembleDebug
+```
+
+Das Debug-APK liegt anschließend unter:
+
+```text
+app/build/outputs/apk/debug/app-debug.apk
+```
+
+## Installation
+
+Bei verbundenem Gerät oder Emulator:
+
+```bash
+adb install -r app/build/outputs/apk/debug/app-debug.apk
+```
+
+## Ersteinrichtung
+
+1. App öffnen und `Einstellungen` wählen.
+2. Server-URL, Basic-Auth-Benutzername und Passwort eingeben.
+3. `Speichern & Verbindung testen` ausführen.
+4. Die App prüft zuerst den Host-Health-Endpunkt und danach den authentifizierten Tracker-Health-Endpunkt.
+
+Debug-Builds erlauben für lokale Entwicklung auch HTTP. Release-Builds akzeptieren durch Manifest, Network Security Configuration und Laufzeitprüfung ausschließlich HTTPS.
+
+## Gradle Wrapper
+
+`gradle/wrapper/gradle-wrapper.jar` ist ein kleines, im Repository enthaltenes Bootstrap-Programm. Es lädt Gradle 8.11.1 in den üblichen Wrapper-Cache, prüft die Distribution anhand der mitgelieferten SHA-256-Datei und startet anschließend Gradle. Dadurch enthält das Projekt keine lokal installierte Gradle-Abhängigkeit.