macOS gets a Zeron.icon that follows the system's looks on macOS 26 and later, with an icns for earlier versions and the dmg. Compiling it takes Xcode 26. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Co-authored-by: zeronsh[bot] <346184242+zeronsh[bot]@users.noreply.github.com>
3.6 KiB
Packaging
Linux (implemented)
scripts/package-linux.sh # release build (thin LTO, stripped)
PROFILE=debug scripts/package-linux.sh # fast smoke package
Produces target/package/zeron-<version>-linux-<arch>.tar.gz containing:
zeron— the binary (headed by default;zeron headlessruns the engine alone)zeron.desktop— XDG desktop entry template (Exec=zeronfor packagers; the installers rewriteExec,TryExec, andIconto absolute paths under~/.zeron/app/current, since~/.local/binis often not on a desktop session'sPATH)zeron.png— 1024×1024 Zeron app icon (scripts/make-app-icons.py)install.sh— installs into~/.zeron/app/<version>behind acurrentsymlink (the curl installer's layout, which the in-app updater manages), links~/.local/bin/zeronto it, and writes the desktop entry and icon under$XDG_DATA_HOME(default~/.local/share). The curl installer does the same from the extracted tarball;scripts/test-linux-desktop-entry.shchecks both
The release profile in the root Cargo.toml sets lto = "thin" and
strip = "symbols" for distribution builds.
macOS
scripts/package-macos.sh # → target/package/zeron-<version>-macos-<arch>.dmg
Builds the release binary, assembles Zeron.app (Info.plist + icns), ad-hoc
signs it (set CODESIGN_IDENTITY for a real Developer ID), and wraps it in a
dmg. The auto-update tarball retains an internal Zeron.app path so older
installed builds can update into Zeron. CI runs this on tags
(.github/workflows/release.yml). The manual steps it automates, for reference
(run on a macOS host — gpui needs Metal; no cross-build from Linux):
- Build the universal (or per-arch) binary:
cargo build --release -p zeron --target aarch64-apple-darwin cargo build --release -p zeron --target x86_64-apple-darwin lipo -create -output zeron \ target/aarch64-apple-darwin/release/zeron \ target/x86_64-apple-darwin/release/zeron - Assemble the bundle:
mkdir -p Zeron.app/Contents/{MacOS,Resources} cp zeron Zeron.app/Contents/MacOS/zeron sed "s/__VERSION__/$(grep -m1 '^version' Cargo.toml | sed 's/.*"\(.*\)".*/\1/')/" \ dist/macos/Info.plist > Zeron.app/Contents/Info.plist - Icon:
scripts/macos-app-icon.sh Zeron.app/Contents/ResourceswritesAssets.carfromdist/macos/Zeron.icon(light, dark, clear and tinted, on macOS 26 and later; compiling it takes Xcode 26 or later) andzeron.icnsfromdist/macos/icon-1024.png(earlier macOS and the dmg). All the app's icons are made from the art indist/iconbyscripts/make-app-icons.py. - Sign + notarize (required for distribution):
codesign --deep --force --options runtime --sign "Developer ID Application: …" Zeron.app xcrun notarytool submit Zeron.zip --keychain-profile … --wait xcrun stapler staple Zeron.app - Ship as a
.dmg(hdiutil create -volname Zeron -srcfolder Zeron.app -ov -format UDZO Zeron.dmg).
Windows
./scripts/package-windows.ps1 -ReleasesUrl https://github.com/zeronsh/zeron/releases/latest/download
Produces, under target/package/:
zeron-<version>-windows-<arch>-setup.exe— the per-user installer built fromdist/windows/zeron.isswith Inno Setup 6zeron-<version>-windows-<arch>.zip— the portable packagezeron-<version>-windows-<arch>.exe— the bare executable the in-app updater downloads
The installer and the zip both carry zeron-update.json, the marker that lets
the app update itself in place. CI runs scripts/test-windows-installer.ps1
against the setup on every Windows build.