duffyduck
21a315ca71
Stefan ist unterwegs, ADB-Zugriff nicht moeglich. Loesung: die App
loggt ihre eigenen Crashes via RVS, Bridge sammelt sie in
/shared/logs/app.log, Diagnostic-Server liefert sie als JSON.
Damit braucht's keinen ADB mehr — Crashes sind sofort vom Browser
(oder Claude per curl) lesbar.
Komponenten:
1. App components/ErrorBoundary.tsx
- React-ErrorBoundary fuer kritische Sections
- componentDidCatch → reportAppError (RVS-Send)
- UI zeigt Error-Box statt White-Screen + Reset-Button
2. App services/logger.ts
- reportAppError(scope, message, stack) → rvs.send('app_log', ...)
- installGlobalCrashReporter() haengt sich an ErrorUtils.setGlobalHandler
UND HermesInternal.enablePromiseRejectionTracker — fangt sowohl
ungefangene Errors als auch unhandled Promise-Rejections
- Konsole bleibt parallel aktiv (damit ADB im Dev-Build weiter
was sieht)
3. App App.tsx: installGlobalCrashReporter() im useEffect zusammen
mit initLogger.
4. App ChatScreen.tsx:
- Inbox-Modal mit ErrorBoundary umschlossen (scope: InboxModal,
onReset schliesst Modal)
- MemoryDetailModal mit ErrorBoundary umschlossen
- DetailModal wird nur noch konditional gerendert (memoryDetailId
!= null) statt immer visible-toggle — vermeidet potentielles
Modal-Stacking-Problem
5. RVS server.js: ALLOWED_TYPES += "app_log"
6. Bridge aria_bridge.py:
- elif msg_type == "app_log": haengt eine Zeile an
/shared/logs/app.log (JSONL, jedes Item {ts, platform, level,
scope, message, stack})
- Plus log.info Hinweis fuer das normale Bridge-Log
7. Diagnostic server.js:
- GET /api/app-log[?limit=N] → letzte N Eintraege als JSON
- POST /api/app-log/clear → log-Datei loeschen
Workflow zum Debuggen des Inbox-Crashes:
Stefan rebuilded App → drueckt Inbox → ErrorBoundary fangt den
Crash (oder Global-Handler bei ungefangenem Error) → reportAppError
→ RVS → Bridge schreibt nach /shared/logs/app.log → Stefan
oder Claude rufen GET /api/app-log auf → sehen Stacktrace.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
ARIA Cockpit — Android App
Stefans primäre Schnittstelle zu ARIA. Gebaut mit React Native + TypeScript.
Schnellstart
# 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:
./build.sh release # oder einfach: ./build.sh
Debug nur zum Entwickeln am PC:
# 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).
./setup.sh
Nach dem Setup einmalig Shell neu starten oder
source ~/.bashrcausführen.
build.sh — APK bauen
Baut die Android APK in einem Schritt:
./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:
- Prüft ob Node, npm, Java vorhanden sind (sonst Fehler mit Hinweis auf
setup.sh) - Erkennt automatisch JDK 21 und wechselt auf JDK 17 (inkl. jlink-Prüfung)
- Sucht automatisch nach dem Android SDK (typische Pfade)
- Prüft ob das native Android-Projekt existiert (sonst Hinweis auf
setup.sh) - Installiert/updated Node Dependencies falls nötig
- Baut die APK via Gradle
- Kopiert die fertige APK als
ARIA-Cockpit-<modus>.apkins 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
# 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)
- App starten
- Tab Einstellungen öffnen
- QR-Code scannen (vom RVS generiert) oder Token manuell eingeben
- Verbindungsstatus prüfen (grüner Punkt = verbunden)
Der QR-Code enthält alles was die App braucht:
{
"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 |