meldestelle/docs/99_Journal/2026-05-06_Windows_Cross_Packaging_Conveyor.md

Journal-Eintrag: 06.05.2026 - Windows Cross-Packaging mit Conveyor

Kontext

Der Windows-Build (.msi) war bisher blockiert, da unser Gitea-Runner ("Zora") auf ARM64-Linux läuft und das Standard-Compose-Plugin zwingend eine Windows-Umgebung mit WiX Toolset für MSI-Pakete benötigt. Dies führte zu ständigen "Roten Kreuzen" in der CI.

Durchgeführte Arbeiten

1. 🏗️ Strategiewechsel: Hydraulic Conveyor

Anstatt auf einen Windows-Runner zu warten, wurde Hydraulic Conveyor als Packaging-Lösung eingeführt. Conveyor erlaubt den Bau von Windows-MSI-Paketen direkt auf Linux, indem es eigene Toolchains mitbringt.

• conveyor.conf erstellt: Zentrale Konfiguration für die Desktop-App (Icons, JVM-Argumente, Windows-spezifische GUIDs).
• Eingangsquelle: Nutzt das JVM-JAR des Desktop-Shell-Moduls als Input.

2. 🐧 Gitea-Workflow Update

Der Workflow .gitea/workflows/feature-build.yml wurde radikal umgebaut:

• Runner-Wechsel: Von windows-latest (der nie existierte) auf ubuntu-latest.
• Build-Schritte:
  1. Gradle jvmJar erstellt die Plattform-unabhängige JAR.
  2. Installation von Conveyor via CLI.
  3. conveyor make windows-msi erzeugt das Paket.
• Artefakte: Die resultierende .msi-Datei wird nun korrekt in der Gitea-UI hochgeladen.

Status: Implementiert (Verifikation ausstehend)

• CI-Status: Der Workflow sollte nun auf Linux-Runnern grün werden.
• Hardware-Test: Sobald das erste MSI aus der CI erfolgreich auf einem Windows-Rechner installiert und gestartet wurde, gilt die Build-Pipeline als verifiziert.

🏗️ [Lead Architect] 🐧 [DevOps Engineer]