Debian-Hyprland/docs/decisions/2025-12-13-prebuilt-packaging.md

21 lines
1.1 KiB
Markdown

# Prebuilt packaging choices (2025-12-13)
Context: Prebuilt Hyprland packages failed on fresh installs due to missing/incompatible deps.
Options considered:
- A) Bundle runtime deps (libhyprlang2, libdisplay-info3) as local .debs alongside Hyprland.
- B) Add pre-checks in installer: validate base libs (libstdc++6, libxkbcommon0, Qt6) meet minimum versions; on failure, fail fast with clear guidance and offer auto-fallback to source build.
- C) Produce a Trixie-targeted package set via CI/sbuild to align deps with Stable.
Chosen for this branch (deb-pkgs): Option B
- Implement version guards in `install.sh` before attempting prebuilt install.
- If requirements are not met, prompt to fallback to source build or instruct the user to upgrade (e.g. to Sid/backports) before retrying prebuilt.
- No local package builds performed in this branch.
Rationale:
- Avoids assuming the target system has Sid-level libraries.
- Keeps current prebuilt artifacts usable where the system meets requirements, while providing a safe fallback where it does not.
Next steps (tracked elsewhere):
- Evaluate Option C (CI/sbuild) to remove the runtime mismatch long-term.