feat(desktop, network): Chat-Funktion hinzugefügt und P2P-Sync verbessert

Signed-off-by: Stefan Mogeritsch <stefan.mo.co@gmail.com>
2026-05-11 13:57:49 +02:00
parent 1a4753cd73
commit e389fe9bce
17 changed files with 514 additions and 426 deletions
@@ -1,98 +1,85 @@
-# 📦 Guide: Desktop App Packaging (Linux, Windows, macOS)
+# 📦 Guide: Desktop App Packaging (Conveyor & Gradle)

-Dieses Dokument beschreibt, wie die Meldestelle Desktop App für verschiedene Betriebssysteme paketiert wird. Wir nutzen einen hybriden Ansatz aus **Gradle (Compose-Desktop)** für lokale Linux-Builds und **Conveyor** für das Cross-Packaging (Windows/macOS) von Linux aus.
+Dieses Dokument beschreibt den professionellen Packaging-Prozess für die Meldestelle Desktop App. Wir nutzen **Conveyor** als primäres Werkzeug für das Cross-Platform Packaging (Windows, Linux, macOS), da es stabile Installer inklusive signierter Updates und gebündelter JREs erzeugt.

 ---

-## 1. Voraussetzungen
+## 1. Strategie: Conveyor vs. Gradle

-### Linux (Entwicklungsrechner / Fedora)
-Um native Pakete bauen zu können, müssen folgende Werkzeuge auf dem System vorhanden sein:
+| Feature | Conveyor (Empfohlen) | Gradle (Compose Plugin) |
+| :--- | :--- | :--- |
+| **Zielgruppe** | Endanwender (Produktion) | Entwickler (Lokaler Test) |
+| **Plattformen** | Windows (.msix), Linux (.deb), macOS | Nur Host-OS (Linux auf Linux) |
+| **Updates** | Automatisch integriert | Manuell |
+| **JRE** | Amazon Corretto (isoliert) | System JRE oder Toolchain |

-```bash
-# Für RPM-Pakete (Fedora)
-sudo dnf install rpm-build
+---

-# Für DEB-Pakete (Ubuntu/Debian)
-sudo apt install dpkg-dev fakeroot
-```
+## 2. Cross-Packaging mit Conveyor

-### Conveyor (Cross-Packaging Tool)
-Conveyor wird benötigt, um von Linux aus Windows-Installer (.msi) oder macOS-Pakete zu erzeugen.
+Conveyor ist so konfiguriert, dass es von Linux aus Pakete für alle Zielsysteme schnüren kann.

-**Installation auf Fedora/Linux:**
-Da automatisierte Skripte manchmal unzuverlässig sind, hier der direkte Weg über das Binär-Paket:
-
-1. **Tarball herunterladen:**
-   Besuchen Sie [https://downloads.hydraulic.dev/conveyor/download.html](https://downloads.hydraulic.dev/conveyor/download.html) und laden Sie die neueste `linux-amd64.tar.gz` Datei herunter.
-
-2. **Manuelle Installation:**
+### Voraussetzungen
+1. **JAR-Dateien:** Die App muss kompiliert sein:
   ```bash
-   # Entpacken
-   tar -xvf hydraulic-conveyor-*-linux-amd64.tar.gz
-   # In den Pfad verschieben
-   sudo mv conveyor /usr/local/bin/
+   ./gradlew :frontend:shells:meldestelle-desktop:jvmJar
   ```
+2. **Icons:** Das System sucht nach `icon.png` in `frontend/shells/meldestelle-desktop/src/jvmMain/resources/`.

-3. **Verifizieren:**
-   ```bash
-   conveyor --version
-   ```
+### Pakete bauen
+Führen Sie Conveyor im Projekt-Root aus:

---
-
-## 2. Lokale Linux-Builds (Gradle)
-
-Die schnellste Methode, um während der Entwicklung ein installierbares Paket für das eigene System zu erstellen.
-
-### RPM-Paket (Fedora)
 ```bash
-./gradlew :frontend:shells:meldestelle-desktop:packageRpm
-```
-*Ausgabe: `frontend/shells:meldestelle-desktop/build/compose/binaries/main/rpm/`*
-
-### DEB-Paket (Ubuntu/Debian)
-```bash
-./gradlew :frontend:shells:meldestelle-desktop:packageDeb
-```
-*Ausgabe: `frontend/shells:meldestelle-desktop/build/compose/binaries/main/deb/`*
-
-### Portable Version (Ohne Installation)
-```bash
-./gradlew :frontend:shells:meldestelle-desktop:createDistributable
-```
-*Ausgabe: `frontend/shells:meldestelle-desktop/build/compose/binaries/main/app/`*
-
---
-
-## 3. Cross-Packaging mit Conveyor
-
-Conveyor nutzt die kompilierte JAR-Datei und schnürt daraus Pakete für alle Zielplattformen.
-
-### Schritt 1: JAR erstellen
-```bash
-./gradlew :frontend:shells:meldestelle-desktop:jvmJar
-```
-
-### Schritt 2: Pakete bauen
-```bash
-# Erstellt den Windows-Installer und die HTML-Downloadseite
+# Komplette Release-Site (Windows & Linux)
 conveyor make site
+
+# Nur ein spezifisches Paket (schneller für Tests)
+conveyor make debian-package   # Linux .deb
+conveyor make windows-msix      # Windows .msix
 ```

-### Schritt 3: Ergebnisse
-Die fertigen Installer (z.B. `.msi` für Windows) befinden sich im neu erstellten Ordner `output/`.
+Die Ergebnisse liegen im Ordner `output/`.

 ---

-## 4. Problembehandlung & Optimierung
+## 3. Konfiguration (`conveyor.conf`)

-### Native Access Warnungen
-Die App benötigt Zugriff auf native Bibliotheken (Netty/SQLite). Der notwendige Parameter `--enable-native-access=ALL-UNNAMED` ist bereits fest hinterlegt.
+Wichtige Parameter der aktuellen Konfiguration (v1.0.1):
+*   **JDK:** Nutzt `Amazon Corretto 21` für maximale Cross-Platform Stabilität.
+*   **Heap-Size:** Erhöht auf `-Xmx1024m`, um auch große Stammdaten-Importe zu bewältigen.
+*   **Linux-Deps:** Automatische Installation von `libasound2`, `libgl1-mesa-glx` und `libx11-6`.
+*   **Native Access:** `--enable-native-access=ALL-UNNAMED` ist für Netty/SQLite aktiviert.

-### Firewall-Konfiguration
-Für Netzwerk-Tests (Discovery/Chat) müssen die Ports 8090, 8080 und 5353 (UDP) geöffnet sein.
-Nutzen Sie dafür das bereitgestellte Skript:
+---
+
+## 4. Netzwerk & Sicherheit (WICHTIG)
+
+Damit die P2P-Funktionen (Chat, Discovery, Sync) nach der Installation funktionieren, müssen folgende Ports auf dem Host-System offen sein:
+
+| Port | Protokoll | Funktion |
+| :--- | :--- | :--- |
+| **8080** | TCP | P2P Sync & Datenabgleich |
+| **8090** | TCP | Veranstaltungs-Chat (WebSocket) |
+| **5353** | UDP | mDNS Discovery (Geräte finden) |
+
+### Firewall-Einrichtung (Linux)
+Nutzen Sie das optimierte Setup-Script:
 ```bash
 sudo ./setup-firewall-linux.sh
 ```
+
+### Windows-Besonderheit
+Beim ersten Start der `.msix` App wird Windows fragen, ob der Netzwerkzugriff erlaubt werden soll. **Wichtig:** Sowohl "Private" als auch "Öffentliche" Netzwerke anhaken, falls auf Turnieren oft Gast-WLANs oder Hotspots genutzt werden.
+
+---
+
+## 5. Troubleshooting
+
+### Problem: "No main class specified"
+**Lösung:** Stellen Sie sicher, dass in der `Main.kt` eine saubere Top-Level `fun main()` existiert und in der `conveyor.conf` auf `at.mocode.frontend.shell.desktop.MainKt` verwiesen wird.
+
+### Problem: SQLite / Native Libs laden nicht
+**Lösung:** Prüfen Sie, ob `extract-native-libraries.conf` in der `conveyor.conf` inkludiert ist.
+
+### Problem: JmDNS findet keine Teilnehmer
+**Lösung:** Prüfen Sie die Ports via `ss -tulpn`. Auf Linux blockieren oft Docker-Interfaces (`br-*`) den Broadcast. Die App filtert diese nun automatisch, aber ein aktives `setup-firewall-linux.sh` ist zwingend erforderlich.