Linux desktop packaging¶
Build separate bundles for glibc / musl and ARM64 / x86_64.
Requirements¶
- Docker or a compatible engine.
- Required DVC inputs: assets, CLI assets, terminal-raster assets and extension fonts.
- Prefer a native runner for each architecture. Emulation needs host binfmt support.
| Bundle | Build image | Minimum libc |
|---|---|---|
| glibc | Ubuntu 22.04 | glibc 2.35 |
| musl | Alpine 3.22 | Matching musl runtime |
Keep the glibc baseline unless deliberately raising the supported minimum.
Build¶
python3 packaging/linux/build_container.py --libc glibc --arch arm64
python3 packaging/linux/build_container.py --libc musl --arch arm64
Repeat with --arch x86_64 on an x86_64 runner.
- Output folder:
dist/linux-<arch>-<libc>/. - Release archive:
dist/graffitty-linux-<arch>-<libc>.tar.gz. - Dependency and ABI audit:
build.jsonandDEPENDENCIES.txt. - Builds use an isolated source snapshot, including current edits.
--resume build/linux-containers/<workspace>reuses that snapshot; later checkout edits are not copied in.
Prepared native environment¶
The container handles staging. To export manually:
python3 packaging/linux/prepare_bundle.py --libc glibc \
--godot /path/to/built/godot --template /path/to/built/template \
--godot-source /path/to/godot/source \
--server target/aarch64-unknown-linux-gnu/release/gft
First stage the matching Godot extension and build the filetree runtime with tools/build_filetree_runtime.py --libc ... --neovim-prefix .... Never mix glibc binaries into a musl bundle.
Include Chromium¶
Default bundles omit CEF.
- Build the matching host with
apps/server/chromium/build-linux.sh. - Pass
--chromium-runtime /path/to/complete/runtimeto the exporter. -
Include
graffitty_chromium,libcef.so, resources and runtime licences. -
Cached Linux CEF artifacts exist for x64 and ARM64.
- ARM64 is build verified; application acceptance remains pending.
- The exporter rejects CEF on musl until a validated runtime exists.