feat: verbessere Build-Performance durch Standard-Deaktivierung von WASM und aktualisiere Dokumentation

Signed-off-by: StefanMoCoAt <stefan.mo.co@gmail.com>
2026-05-11 20:44:20 +02:00
parent e389fe9bce
commit 49393d3eac
5 changed files with 140 additions and 1 deletions
@@ -0,0 +1,92 @@
+# 🛠️ Guide: Conveyor Installation
+
+Dieses Dokument beschreibt die Installation von **Hydraulic Conveyor** auf verschiedenen Linux-Distributionen (Ubuntu
+26.04 und Fedora 44).
+
+---
+
+## 1. Ubuntu 26.04 (Debian-basiert)
+
+Der am einfachsten Weg für Ubuntu ist der direkte Download des `.deb`-Pakets. Dieses konfiguriert bei der Installation
+automatisch das APT-Repository für zukünftige Updates.
+
+### Installation via .deb (Empfohlen)
+
+```bash
+# Aktuelles Paket herunterladen (Beispiel v12.0 - bitte Version ggf. anpassen)
+VERSION="12.0"
+curl -L https://downloads.hydraulic.dev/conveyor/conveyor_${VERSION}_amd64.deb -o conveyor.deb
+
+# Installieren (konfiguriert auch das Repo automatisch)
+sudo apt update
+sudo apt install ./conveyor.deb
+```
+
+---
+
+## 2. Fedora 44 (RPM-basiert)
+
+Für Fedora wird die Installation via Tarball empfohlen, da Conveyor als autarkes Binary geliefert wird.
+
+### Installation via Tarball (Systemweit)
+
+Dies ist der zuverlässigste Weg für Fedora:
+
+```bash
+# Version definieren (Beispiel v12.0, bitte aktuelle Version prüfen)
+VERSION="12.0"
+curl -L https://downloads.hydraulic.dev/conveyor/conveyor-${VERSION}-linux-amd64.tar.gz -o conveyor.tar.gz
+
+# Entpacken nach /opt
+sudo tar -xzf conveyor.tar.gz -C /opt/
+sudo ln -s /opt/conveyor-${VERSION}/bin/conveyor /usr/local/bin/conveyor
+
+# Test
+conveyor --version
+```
+
+### Installation via RPM (Falls verfügbar)
+
+Prüfen Sie auf der Hydraulic Website, ob mittlerweile ein natives RPM-Repository existiert. Falls ja:
+
+```bash
+sudo dnf config-manager --add-repo https://conveyor.hydraulic.dev/rpm/conveyor.repo
+sudo dnf install conveyor
+```
+
+---
+
+## 3. Post-Installation & Verifikation
+
+Nach der Installation sollten Sie den Pfad und die Version prüfen:
+
+```bash
+conveyor --version
+```
+
+### Root-Key Initialisierung
+
+Beim ersten Ausführen von `conveyor` wird ein Root-Key generiert. **Sichern Sie diesen unbedingt!**
+
+```bash
+conveyor make site
+```
+
+*Folgen Sie den Anweisungen im Terminal zur Sicherung des Root-Keys.*
+
+---
+
+## 4. Troubleshooting
+
+### Fehlende Bibliotheken (Fedora)
+
+Falls Conveyor native Hilfe benötigt (z.B. für Icons oder Kompression):
+
+```bash
+sudo dnf install libX11 libXext libXrender
+```
+
+### Berechtigungen
+
+Stellen Sie sicher, dass Ihr Benutzer in der Gruppe `docker` ist, falls Sie Conveyor innerhalb von Containern nutzen
+oder Docker-basierte Inputs verwenden (für dieses Projekt primär lokal relevant).
@@ -83,3 +83,14 @@ Beim ersten Start der `.msix` App wird Windows fragen, ob der Netzwerkzugriff er

 ### 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.
+
+## 6. Performance-Optimierung (Gradle)
+
+Der Build-Prozess kann bei aktivierter Web-Kompilierung (WASM/JS) sehr lange dauern. Für die reine Desktop-Entwicklung
+wurde WASM standardmäßig deaktiviert.
+
+* **WASM aktivieren (z.B. für CI/Portal):** `./gradlew -PenableWasm=true ...`
+* **WASM deaktivieren (Default):** `./gradlew ...` (Spart bis zu 70% Build-Zeit).
+
+Stellen Sie in der `gradle.properties` sicher, dass `enableWasm=false` gesetzt ist, wenn Sie primär an der Desktop-App
+arbeiten.