Repack
This commit is contained in:
@@ -0,0 +1,23 @@
|
|||||||
|
# How the Butt package is built
|
||||||
|
|
||||||
|
Unlike a simple repack, Butt is compiled from source. This document explains the build process to guarantee transparency and reproducibility.
|
||||||
|
|
||||||
|
1. **Docker-First Environment (Recommended):** To guarantee a perfect, reproducible build, the standard method is running the script inside a Docker container. The script is designed to automatically detect your host OS. If you are not on the exact target Ubuntu release (e.g., Ubuntu 22.04), it will automatically spawn a Docker container to perform the build. This ensures that `dpkg-shlibdeps` generates the correct, expected dependencies without relying on your host's configuration.
|
||||||
|
2. **Source Verification:** The script downloads the official `.tar.gz` from `danielnoethen.de`.
|
||||||
|
3. **Compilation & Linking:** The script runs `./configure` and `make`. It explicitly forces dynamic linking (`LIBS=... -lporttime -lasound`) so the resulting binary uses the system's shared libraries rather than bundling them.
|
||||||
|
4. **AAC Exclusion:** The script actively checks if `libfdk-aac-dev` is installed and aborts if it is, to prevent accidental inclusion. It also runs `objdump -p` on the final binary to ensure no `fdk` libraries are linked.
|
||||||
|
5. **Dependencies:** `dpkg-shlibdeps` is used inside the Docker container to generate the exact `Depends:` list required by the compiled binary for the target Ubuntu version.
|
||||||
|
6. **Packaging & Checksums:** Finally, `dpkg-deb` creates the `.deb` file. Separate SHA256 checksums are generated for the source code (`upstream_sha256_X.txt`) and for the resulting package (`SHA256SUMS_X.deb`) to maintain a transparent verification chain.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
# Hogyan készül a Butt csomag (Magyar)
|
||||||
|
|
||||||
|
A Betterbirddel ellentétben a Butt forráskódból kerül lefordításra. Ez a dokumentum elmagyarázza a build folyamatot az átláthatóság és a reprodukálhatóság érdekében.
|
||||||
|
|
||||||
|
1. **Docker-alapú környezet (Javasolt):** A tökéletes, reprodukálható build garantálása érdekében a szabványos módszer a script Docker konténerben való futtatása. A script felismeri a hoszt operációs rendszert. Ha nem a pontos cél Ubuntu kiadáson vagy (pl. Ubuntu 22.04), automatikusan indít egy Docker konténert a build elvégzéséhez. Ez biztosítja, hogy a `dpkg-shlibdeps` a helyes, elvárt függőségeket generálja anélkül, hogy a hoszt beállításaira támaszkodna.
|
||||||
|
2. **Forrás ellenőrzése:** A script letölti a hivatalos `.tar.gz` fájlt a `danielnoethen.de` oldalról.
|
||||||
|
3. **Fordítás és linkelés:** A script lefuttatja a `./configure` és a `make` parancsokat. Kifejezetten kikényszeríti a dinamikus linkelést (`LIBS=... -lporttime -lasound`), így a létrejövő bináris a rendszer megosztott könyvtárait használja, nem pedig beágyazza azokat.
|
||||||
|
4. **AAC kizárása:** A script aktívan ellenőrzi, hogy a `libfdk-aac-dev` telepítve van-e, és ha igen, leáll, hogy megakadályozza a véletlen bekerülését. A végleges binárison lefuttatja az `objdump -p` parancsot is, hogy megbizonyosodjon róla, nincs `fdk` könyvtárhoz linkelve.
|
||||||
|
5. **Függőségek:** A `dpkg-shlibdeps` a Docker konténeren belül generálja le a lefordított bináris által igényelt pontos `Depends:` listát a cél Ubuntu verzióhoz.
|
||||||
|
6. **Csomagolás és ellenőrzőösszegek:** Végül a `dpkg-deb` létrehozza a `.deb` fájlt. Külön SHA256 ellenőrzőösszegek generálódnak a forráskódhoz (`upstream_sha256_X.txt`) és a létrejött csomaghoz (`SHA256SUMS_X.deb`), hogy megmaradjon az átlátható ellenőrzési lánc.
|
||||||
Reference in New Issue
Block a user