Files
ARIA-AGENT/android
duffyduck 0ec4b00879 feat: App-Chat-Sync — verpasste Nachrichten + chat_cleared Live-Update
Zwei zusammenhaengende Bugs:
  1. App aktualisierte nicht wenn die Diagnostic "Konversation komplett
     zuruecksetzen" gedrueckt hat — die App hatte den lokalen Stand weiter
  2. Nachrichten die kamen waehrend die App offline/geschlossen war,
     wurden nicht nachgeladen

Loesung: chat_backup.jsonl wird wieder geschrieben (Bridge statt Diagnostic,
weil OpenClaw-Code-Pfad tot ist) und dient als Server-Truth fuer App+Diagnostic.

bridge/aria_bridge.py
  _append_chat_backup() schreibt jeden Turn (User + ARIA) als JSONL-Zeile
  in /shared/config/chat_backup.jsonl. Trigger: send_to_core (User) +
  _process_core_response (Assistant, inkl. file-Attachments).

  _read_chat_backup_since(since_ms, limit) liest die Datei, filtert auf
  ts > since_ms, gibt max limit neueste zurueck. Honoriert file_deleted-Marker.

  Neuer RVS-Handler chat_history_request {since, limit?} → antwortet mit
  chat_history_response {messages: [...], since}.

diagnostic/server.js
  /api/chat-history-clear broadcastet jetzt zusaetzlich chat_cleared via
  RVS (sendToRVS_raw), damit App ihre lokale Liste auch leert. Vorher nur
  Browser-Clients via broadcast() — App war aussen vor.

rvs/server.js
  ALLOWED_TYPES um chat_history_request, chat_history_response, chat_cleared.

android/src/screens/ChatScreen.tsx
  - Bei (re)connect: AsyncStorage 'aria_chat_last_sync' lesen → send
    chat_history_request {since}
  - Handler chat_history_response: incoming → ChatMessage[] mappen,
    Attachments aus 'files'-Array rekonstruieren, mergen (Dedup via timestamp),
    lastSync hochziehen
  - Handler chat_cleared: setMessages([]) + AsyncStorage 'chat_messages' +
    'last_sync' weg
  - Bei jeder eingehenden chat-Message: 'aria_chat_last_sync' updaten damit
    Reconnect nicht doppelt nachzieht

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 23:24:52 +02:00
..
2026-05-11 22:38:45 +02:00
2026-03-08 23:31:46 +01:00
2026-03-08 23:31:46 +01:00
2026-03-08 23:31:46 +01:00
2026-03-08 23:31:46 +01:00
2026-03-08 23:31:46 +01:00
2026-05-11 22:38:45 +02:00
2026-03-08 23:31:46 +01:00
2026-03-08 23:31:46 +01:00
2026-03-08 23:31:46 +01:00

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 ~/.bashrc ausfü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:

  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

# 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:

{
  "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