678058c940
CI / Select checks (push) Has been cancelled
CI / Format and repository checks (push) Has been cancelled
CI / Compile RISC-V (manual) (push) Has been cancelled
Docker / image (push) Has been cancelled
Generated files / Regenerate and commit (push) Has been cancelled
Kernel rig / Select the rig areas (push) Has been cancelled
Lists / Design format changes merge cleanly (push) Has been cancelled
Lists / Lists are sorted one item per line (push) Has been cancelled
Packaging lint / lint (push) Has been cancelled
Pages / build (push) Has been cancelled
CI / Dependency advisories (push) Has been cancelled
CI / Quick compile (push) Has been cancelled
CI / Native Linux Clippy (push) Has been cancelled
CI / Build tests (push) Has been cancelled
CI / Native Linux tests (push) Has been cancelled
CI / GPU path tests (1/4) (push) Has been cancelled
CI / GPU path tests (2/4) (push) Has been cancelled
CI / GPU path tests (3/4) (push) Has been cancelled
CI / GPU path tests (4/4) (push) Has been cancelled
CI / Action matrix (1/16) (push) Has been cancelled
CI / Action matrix (10/16) (push) Has been cancelled
CI / Action matrix (11/16) (push) Has been cancelled
CI / Action matrix (12/16) (push) Has been cancelled
CI / Action matrix (13/16) (push) Has been cancelled
CI / Action matrix (14/16) (push) Has been cancelled
CI / Action matrix (15/16) (push) Has been cancelled
CI / Action matrix (16/16) (push) Has been cancelled
CI / Action matrix (2/16) (push) Has been cancelled
CI / Action matrix (3/16) (push) Has been cancelled
CI / Action matrix (4/16) (push) Has been cancelled
CI / Action matrix (5/16) (push) Has been cancelled
CI / Action matrix (6/16) (push) Has been cancelled
CI / Action matrix (7/16) (push) Has been cancelled
CI / Action matrix (8/16) (push) Has been cancelled
CI / Action matrix (9/16) (push) Has been cancelled
CI / Action matrix determinism (push) Has been cancelled
CI / Property tests (many cases) (push) Has been cancelled
CI / Doc tests (push) Has been cancelled
CI / Reference tests (push) Has been cancelled
CI / Windows D3D12 FXC shaders (push) Has been cancelled
CI / Windows app startup (push) Has been cancelled
CI / ci (push) Has been cancelled
CI / Compile WebAssembly (push) Has been cancelled
CI / Nightly alert (push) Has been cancelled
Kernel rig / Build the CLI (push) Has been cancelled
Kernel rig / Kernel rig (${{ matrix.shard }}) (push) Has been cancelled
Kernel rig / kernel-rig (push) Has been cancelled
Pages / deploy (push) Has been cancelled
3.0 KiB
3.0 KiB
name, description
| name | description |
|---|---|
| makecad-packaging | Use when preparing or shipping a makeCAD release, changing installers or packages (AppImage, MSI, dmg, Flatpak, Snap, WinGet, Nix, FreeBSD, web), release asset names, signing or the Pages deployment. |
Packaging and releases
Development pushes are not application releases. Pushing to main or pushing a tag does not start a release. The full procedure is docs/releasing.md; follow it when asked to prepare or ship a release.
Preparing
- Choose one version for the whole batch from the actual changes (patch, minor, major,
-rc.N). Do not infer it from commit prefixes. Moving to1.0is the owner's decision. - Update
[workspace.package] versioninCargo.toml, thencargo update --workspace --offline; only our own crates'version =lines inCargo.lockchange. - Fold the pending design-format changes with
scripts/fold-format-pending.sh(skills/makecad-file-formats/SKILL.md). - Run
cargo xtask ciand the packaging checks in.github/workflows/packaging-lint.yml. Land the version commit onmainthrough the normal review flow; never use[skip ci].
Building and publishing
- Advance the
releasebranch with fast-forwards only (git merge --ff-only); never force-push..github/workflows/release.ymlbuilds every package and creates a draft GitHub Release. - Verify the draft before publishing: the run succeeded for the intended SHA, every platform and architecture is present,
sha256sum --check SHA256SUMS.txtpasses, and the built CLI runs (--version, an example model). - Only when shipping is authorised, publish the verified draft with
gh release edit, then confirm its tag resolves to the recorded SHA and the downstream deployment ran. A request to prepare a release is not a request to publish. - Never overwrite a published version, tag or asset; use a new version. Do not push the version tag yourself. Packages are unsigned unless
docs/releasing.mdsays otherwise; do not claim they are signed. - Nightlies are prereleases built by the same workflow; they never become latest or advance
release.
Names that must stay stable
- Assets are
solidcraft-<version>-...and are also attached without the version (solidcraft-windows-x64.msi). The README links and the in-app update check (crates/ui-egui/src/update.rs) pick them by name; renaming one breaks both. - The old product name survives only in the shims in
docs/compatibility.md. Do not rewrite published assets, checksums, tags or historical notes. - Documentation, the browser app and the Flatpak repository publish under project Pages
/solidcraft/. Add no old-name Pages aliases.
Where things live
packaging/holds the per-platform scripts (packaging/linux,packaging/windows,packaging/macos,packaging/freebsd,packaging/web);packaging/testschecks them.- Nix:
flake.nixanddocs/nix.md. Building:docs/building.md. Downloads:docs/downloads.md. - Build with
CARGO_TARGET_DIR=<repo>/target. Windows from Linux:cargo xwin build --release --target x86_64-pc-windows-msvc -p solidcraft.