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

34 lines
1.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.