A stable release of the zgx app is also published to the beta feed when it's newer than the beta there, so the website's beta downloads get each stable release with no action. The zgx app follows the channel on record on Windows and Linux too (as on macOS), so those installs stay on beta afterwards rather than dropping to stable. Windows: every zgx release keeps its files in beta\<version>, the name the betas in the field check a package for; with a per-channel folder they couldn't have installed a stable release from the beta feed. A package also brings its feed: an install the old app's updater moved here switches from the GitHub release to the edge's feed (stable at its root, beta beside it), which release.yml now writes into the package. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Co-authored-by: zeronsh[bot] <346184242+zeronsh[bot]@users.noreply.github.com> |
History
|
|
|---|---|---|
| .. | ||
| icon | ||
| macos | ||
| voice | ||
| windows | ||
| README.md | ||
| zeron.desktop | ||
| zeron.png | ||
| zeron.svg | ||
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.