Files
hms-mediaengine/_entwicklung/docs/adr/0005-packaging-nuitka-onefolder.md
T
HMS MediaEngine Agent 362e089be0 AUFGERAUMT: Root auf 10 sichtbare Elemente reduziert
Der Nutzer hat recht: Der Ordner war voller Entwicklungs-Muell.
Jetzt ist sauber getrennt:

ROOT (was der Nutzer sieht und braucht):
- run.py                     = das Programm
- hms_app/                   = der Anwendungscode
- HMS MediaEngine.app        = macOS Doppelklick-Starter
- HMS-Start.vbs              = Windows Doppelklick-Starter
- HMS-Install.vbs             = Windows Erst-Installation
- HMS-Mac-Install.command     = macOS Homebrew-Installation
- HMS-Portable-Install.command = macOS Portable-Installation (16GB-Fix)
- installer_gui.py           = grafischer Installer
- launcher.pyw + launcher_core.py = interne Start-Logik
- LIESMICH.txt               = 10-Zeilen-Kurzanleitung
- .gitignore

_entwicklung/ (alles andere, NICHT benoetigt):
- packages/ apps/ native/ plugins/ tools/ schemas/ tests/ docs/
  build/ fixture_profiles/
- PLAN.md STATUS.md ERRORS.md TEST_REPORT.md CHANGELOG.md README.md
- pyproject.toml uv.lock setup_*.sh/ps1 make_mac_app.py

Diese Trennung gilt ab sofort fuer alle Commits. Der Nutzer kann
_entwicklung/ loeschen wenn er Platz braucht - die App laeuft ohne.

Verifiziert: App startet nach Aufraeumen unveraendert (Health 200).
2026-09-11 23:44:06 +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.