Files
hms-mediaengine/docs/adr/0005-packaging-nuitka-onefolder.md
T
HMS MediaEngine Agent 9536e08748 Phase 1: IPC-Verbindungsschicht + Build-first-Strategie (ADR-0008)
- ADR-0008: Build-first, gesammelte Windows-Validierung (Auftraggeber-Freigabe)
- ADR-0004 vorläufig: Rust auf GStreamer-D3D11-Elementpfad
- ADR-0005 vorläufig: Nuitka Onefolder
- hms_protocol: IpcServer/IpcClient mit Handshake (hello/welcome),
  Capabilities-Austausch, Heartbeat 500 ms bidirektional, Snapshot/Delta,
  Loopback-only-Enforcement, Re-Sync nach Reconnect, Version-Mismatch-Fehler
- 9 Integrationstests: echter TCP-Loopback, kein Mock
2026-09-11 00:50:03 +02:00

1.1 KiB
Raw Blame History

ADR-0005: Packaging Nuitka Onefolder (vorläufig)

  • Status: Vorläufig angenommen (Vergleich im Windows-Durchlauf)
  • Datum: 2026-09-11
  • Phase: ursprünglich Phase 0; wegen ADR-0008 vorgezogen
  • Bauplan: §7.1, §30.2

Entscheidung

Nuitka Standalone/Onefolder als Packaging-Basis; PyInstaller Onefolder als dokumentierter Fallback, falls Nuitka die GStreamer-DLL-Bündelung nicht sauber abbildet. Onefile bleibt wie geplant ausgeschlossen (§7.1).

Begründung

  • Nuitka kompiliert zu C: weniger Interpreter-Rest, bessere Reproduzierbarkeit per Buildskript (§30.1).
  • Die GStreamer-Bündelung ist von der Packaging-Wahl unabhängig (runtime/-Ordner + GST_PLUGIN_PATH, siehe build/windows/GSTREAMER.md).
  • PLAN.md verlangt den finalen Vergleich auf Windows; hier nur vorläufige Wahl.

Folgen

  • Buildskripte targetieren Nuitka; der Fallback-Pfad bleibt gepflegt.

Messwerte / Nachweise

  • Ausstehend; der erste Onefolder-Build auf sauberem Windows-Rechner entscheidet final (§29.6).

Freigabe

Vorläufig gemäß ADR-0008; endgültig nach Windows-Build.