193 lines
7.0 KiB
Markdown
193 lines
7.0 KiB
Markdown
# ARIA Cockpit — Android App
|
|
|
|
Stefans primäre Schnittstelle zu ARIA. Gebaut mit React Native + TypeScript.
|
|
|
|
---
|
|
|
|
## Schnellstart
|
|
|
|
```bash
|
|
# 1. Abhängigkeiten installieren (einmalig)
|
|
./setup.sh
|
|
|
|
# 2. Release-APK bauen (standalone, kein Dev-Server nötig)
|
|
./build.sh
|
|
|
|
# 3. APK aufs Handy kopieren und installieren
|
|
adb install ARIA-Cockpit-release.apk
|
|
```
|
|
|
|
Fertig. APK liegt als `ARIA-Cockpit-release.apk` im Verzeichnis.
|
|
|
|
---
|
|
|
|
## Debug vs Release — was ist der Unterschied?
|
|
|
|
| | Debug | Release |
|
|
|---|---|---|
|
|
| **JS-Bundle** | Wird von Metro Dev-Server geladen (localhost:8081) | In die APK eingebaut — läuft standalone |
|
|
| **Verwendung** | Entwicklung am PC mit Hot-Reload | Installation aufs Handy |
|
|
| **Dev-Server nötig?** | Ja — `npx react-native start` muss laufen | Nein — App startet sofort |
|
|
| **Größe** | Kleiner (Code wird live geladen) | Größer (alles eingebaut) |
|
|
|
|
**Für aufs Handy installieren immer Release bauen:**
|
|
```bash
|
|
./build.sh release # oder einfach: ./build.sh
|
|
```
|
|
|
|
**Debug nur zum Entwickeln am PC:**
|
|
```bash
|
|
# Terminal 1: Metro Dev-Server starten
|
|
npx react-native start
|
|
|
|
# Terminal 2: Debug-APK bauen und auf verbundenes Gerät/Emulator deployen
|
|
./build.sh debug
|
|
```
|
|
|
|
> Wenn du eine Debug-APK aufs Handy kopierst ohne Metro-Server, siehst du den roten
|
|
> "Could not connect to development server" Fehler. Das ist normal — Debug braucht den Server.
|
|
|
|
---
|
|
|
|
## Scripts
|
|
|
|
### `setup.sh` — Entwicklungsumgebung einrichten
|
|
|
|
Installiert automatisch alles was zum Bauen nötig ist:
|
|
|
|
| Was | Version | Details |
|
|
|-----|---------|---------|
|
|
| **Basis-Tools** | — | curl, unzip, git |
|
|
| **Node.js** | >= 18 | Via NodeSource (falls nicht vorhanden) |
|
|
| **JDK** | 17 (vollständig) | OpenJDK mit jlink (nicht nur JRE!) |
|
|
| **Android SDK** | API 34 | Command Line Tools + Build Tools + Platform Tools |
|
|
| **Metro-Config** | — | metro.config.js, babel.config.js, .watchmanconfig (falls fehlend) |
|
|
| **Node Packages** | — | Räumt alte node_modules auf + `npm install` |
|
|
| **Natives Android-Projekt** | — | React Native Gradle-Projekt generieren |
|
|
| **Gradle Config** | — | compileSdk-Warning unterdrücken, Build-Cache aufräumen |
|
|
|
|
Das Script erkennt automatisch dein OS (Debian, Fedora, Arch, macOS) und benutzt den passenden Paketmanager.
|
|
|
|
**ANDROID_HOME** wird automatisch gesetzt und in dein Shell-Profil (`.bashrc`/`.zshrc`) eingetragen.
|
|
|
|
**JDK-Hinweis:** React Native 0.73 + Android Gradle Plugin 8.1 braucht exakt JDK 17 — nicht 21 oder neuer. Falls du JDK 21 als Standard hast, ist das kein Problem: `build.sh` setzt `JAVA_HOME` automatisch auf JDK 17 (wenn installiert).
|
|
|
|
```bash
|
|
./setup.sh
|
|
```
|
|
|
|
> Nach dem Setup einmalig Shell neu starten oder `source ~/.bashrc` ausführen.
|
|
|
|
### `build.sh` — APK bauen
|
|
|
|
Baut die Android APK in einem Schritt:
|
|
|
|
```bash
|
|
./build.sh # Release-APK (Standard) — fürs Handy
|
|
./build.sh release # Release-APK (explizit)
|
|
./build.sh debug # Debug-APK (nur mit Metro Dev-Server)
|
|
```
|
|
|
|
**Was das Script macht:**
|
|
1. Prüft ob Node, npm, Java vorhanden sind (sonst Fehler mit Hinweis auf `setup.sh`)
|
|
2. Erkennt automatisch JDK 21 und wechselt auf JDK 17 (inkl. jlink-Prüfung)
|
|
3. Sucht automatisch nach dem Android SDK (typische Pfade)
|
|
4. Prüft ob das native Android-Projekt existiert (sonst Hinweis auf `setup.sh`)
|
|
5. Installiert/updated Node Dependencies falls nötig
|
|
6. Baut die APK via Gradle
|
|
7. Kopiert die fertige APK als `ARIA-Cockpit-<modus>.apk` ins Hauptverzeichnis
|
|
|
|
**Ausgabe-Dateien:**
|
|
- `ARIA-Cockpit-release.apk` — fertige APK (Hauptverzeichnis)
|
|
- `android/app/build/outputs/apk/release/app-release.apk` — Original-Pfad
|
|
|
|
---
|
|
|
|
## Auf dem Handy installieren
|
|
|
|
```bash
|
|
# Via ADB (USB-Kabel oder WiFi)
|
|
adb install ARIA-Cockpit-release.apk
|
|
|
|
# Oder: APK aufs Handy kopieren und dort öffnen
|
|
# Oder: Via Gitea Release herunterladen (siehe release.sh im Root)
|
|
```
|
|
|
|
---
|
|
|
|
## Erstverbindung (Pairing)
|
|
|
|
1. App starten
|
|
2. Tab **Einstellungen** öffnen
|
|
3. QR-Code scannen (vom RVS generiert) oder Token manuell eingeben
|
|
4. Verbindungsstatus prüfen (grüner Punkt = verbunden)
|
|
|
|
Der QR-Code enthält alles was die App braucht:
|
|
```json
|
|
{
|
|
"host": "rvs.hackersoft.de",
|
|
"port": 443,
|
|
"token": "a3f8b2c9d1e4..."
|
|
}
|
|
```
|
|
|
|
Einmal scannen, nie wieder manuell tippen.
|
|
|
|
---
|
|
|
|
## Projektstruktur
|
|
|
|
```
|
|
android/
|
|
├── setup.sh ← Dev-Umgebung einrichten (einmalig)
|
|
├── build.sh ← APK bauen
|
|
├── index.js ← React Native Entry Point
|
|
├── app.json ← App-Name Konfiguration
|
|
├── App.tsx ← Haupt-Komponente, Navigation
|
|
├── package.json ← Dependencies
|
|
├── tsconfig.json ← TypeScript Config
|
|
├── metro.config.js ← Metro Bundler Config
|
|
├── babel.config.js ← Babel Transpiler Config
|
|
├── .watchmanconfig ← Watchman Config
|
|
│
|
|
├── src/
|
|
│ ├── services/
|
|
│ │ ├── rvs.ts ← WebSocket-Verbindung zum Rendezvous Server
|
|
│ │ └── audio.ts ← Mikrofon-Aufnahme und TTS-Wiedergabe
|
|
│ │
|
|
│ ├── screens/
|
|
│ │ ├── ChatScreen.tsx ← Hauptchat mit ARIA
|
|
│ │ └── SettingsScreen.tsx ← Verbindung, Modus, Logs
|
|
│ │
|
|
│ └── components/
|
|
│ ├── VoiceButton.tsx ← Push-to-Talk Button
|
|
│ ├── ModeSelector.tsx ← Betriebsmodus-Auswahl
|
|
│ ├── FileUpload.tsx ← Datei-Versand
|
|
│ └── CameraUpload.tsx ← Foto-Aufnahme / Galerie
|
|
│
|
|
└── android/ ← Generiertes Gradle-Projekt (nach setup)
|
|
├── gradlew ← Gradle Wrapper
|
|
├── gradle.properties ← Gradle Config (compileSdk etc.)
|
|
└── app/build.gradle ← App Build Config
|
|
```
|
|
|
|
---
|
|
|
|
## Fehlerbehebung
|
|
|
|
| Problem | Lösung |
|
|
|---------|--------|
|
|
| **"Could not connect to development server"** | Das ist eine Debug-APK. Für standalone: `./build.sh release` |
|
|
| `ANDROID_HOME nicht gesetzt` | `./setup.sh` ausführen, Shell neu starten |
|
|
| `gradlew: Permission denied` | `chmod +x android/gradlew` |
|
|
| `SDK not found` | `./setup.sh` — installiert Android SDK automatisch |
|
|
| `JDK nicht gefunden` | `./setup.sh` — installiert OpenJDK 17 |
|
|
| `jlink does not exist` | Nur JRE installiert, nicht voller JDK: `sudo apt install openjdk-17-jdk` |
|
|
| `JdkImageTransform` Fehler | JDK 21 aktiv, aber JDK 17 nötig — `build.sh` löst das automatisch |
|
|
| `BaseReactPackage` Fehler | `react-native-screens` Version zu neu — auf 3.27.0 pinnen |
|
|
| `react-native-camera` Flavor-Fehler | Paket entfernt (deprecated), wird nicht gebraucht |
|
|
| `EMFILE: too many open files` | `build.sh` setzt `CI=true` automatisch — Metro startet keinen File-Watcher |
|
|
| `No Metro config found` | `./setup.sh` erstellt metro.config.js, babel.config.js, .watchmanconfig automatisch |
|
|
| Build hängt bei `assembleRelease` | Signing Config prüfen (siehe React Native Docs) |
|
|
| `node_modules` Probleme | `./setup.sh` — räumt alles auf und installiert frisch |
|