Files
2026-11-14 05:00:04 +00:00

3.5 KiB

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.