Files
cadcraft/docs/releasing.md
T
7c7c1f9a3d Release: Flatpak x86_64/aarch64, AppImage zsync updates, README Downloads (#16)
* Release: Flatpak x86_64/aarch64, AppImage zsync updates, README Downloads

- AppImages embed gh-releases-zsync update information and ship a .zsync beside them.
- New flatpak job repackages each Linux tarball into cadcraft-<ver>-linux-<arch>.flatpak
  (bundle manifest + flatpak-bundle.sh); the from-source Flathub manifest moves to runtime
  26.08 with the same commented, minimal finish-args (packaging-lint checks they agree).
- Jobs that sign nothing (version, linux, flatpak, freebsd, web) leave the release
  environment, so a branch dispatch is a dry run; the draft-release job runs only on release.
- README: Downloads section listing every build.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Release: check AppImage update info without extract-and-run; fix the deb/rpm description

APPIMAGE_EXTRACT_AND_RUN makes the runtime pass --appimage-updateinformation to the app.
The package description was PhotoCraft's.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Brandon Thomas <shared2@storyteller.ai>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-08 09:40:49 -04:00

2.1 KiB

Releasing CADCraft

The canonical recipe is craftrules' release/playbook.md; this file covers only what's CADCraft-specific.

  • Version: [workspace.package] version in the root Cargo.toml is the single source. cargo xtask version prints it; cargo xtask version set X.Y.Z[-pre] changes it. The app shows it in About, cadcraft --version and cadcraft-cli --version; release builds also embed the commit (CADCRAFT_BUILD_SHA).
  • Cut a release: bump the version on main, then push main to release (git push origin main:release). Every push to release runs .github/workflows/release.yml and creates or updates the draft GitHub Release CADCraft v<version>. A workflow_dispatch run with version: X.Y.Z-rc.N makes a test build. A dispatch on any other branch is a dry run: the unsigned jobs (version, Linux, Flatpak, FreeBSD, web) build, the release environment refuses the signing jobs (macOS, Windows), and no release is drafted.
  • Artifacts: macOS universal .dmg (Developer ID signed, notarized, stapled) and CLI .zip; Windows x64, x86 and arm64 .msi + portable .zip (Azure Trusted Signing); Linux x86_64 and aarch64 .AppImage (+ .AppImage.zsync for AppImageUpdate delta updates), .flatpak bundle (repackages the tarball, packaging/linux/flatpak-bundle.sh), .deb, .rpm, .tar.gz (+ the from-source Flathub manifest in packaging/linux/flatpak/); FreeBSD x86_64 .tar.gz (built in a FreeBSD VM); web .zip (wasm + index.html, see packaging/web/README.md); SHA256SUMS.txt.
  • Secrets: the twelve signing secrets live in the release environment (deployable only from the release branch, which only org admins and release-managers can push). All are optional: a missing one produces unsigned artifacts with a warning.
  • File types: .dxf and .dwg (macOS document types, Windows "Open with", Linux MIME types).
  • Local packaging test: packaging/macos/package.sh (ad-hoc signed DMG), packaging/linux/package.sh, packaging/web/package.sh.