Document v0.8.0 publication and macOS compiler setup
Gitea/canvas-pilot/pipeline/head This commit looks good Details

This commit is contained in:
Dandaedre 2026-11-16 13:39:26 +01:00
parent eb82dc7cc9
commit b3e8b13ef4
6 changed files with 96 additions and 34 deletions

1
.gitignore vendored
View File

@ -8,3 +8,4 @@ __pycache__/
/gitea-token.txt
.env
/.rust-release/
/dist/

View File

@ -8,10 +8,16 @@ No changes yet.
## v0.8.0 — 2026-11-16
- Published Windows, Linux, Apple Silicon and Intel macOS binaries and portable
bundles, with templates, an offline manual, checksums and build provenance.
macOS uses the documented Rust 1.100 compiler-image recipe because the original
pinned image is too old for the locked CAD dependencies. Linux startup was
checked; native Windows/macOS runtime acceptance remains separate.
Standalone Canvas Pilot and advanced exchange milestone. See the
[release notes](../development/release-notes/v0.8.0.md) for highlights,
compatibility and remaining release validation. This version is prepared for
release; downloadable binaries are not yet published.
compatibility and remaining release validation. See the [release page](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/releases/tag/v0.8.0)
for published downloads and platform validation.
- Import/paste can optionally rename destination layers from supplied editor names,
with proposed names shown before applying and a name-only mode. Folders and IDs

View File

@ -13,7 +13,7 @@ device readback and physical-screen acceptance.
## Release milestone
**v0.8.0 — Standalone and advanced exchange** is prepared as a source milestone.
**v0.8.0 — Standalone and advanced exchange** is published with four-platform binaries.
See its [release notes](../development/release-notes/v0.8.0.md) and
[build/publication procedure](../development/releases.md). Remaining acceptance
checks and stretch goals below remain open; the tag does not mark them complete.

View File

@ -37,23 +37,44 @@ Default builds include vendor codecs. Illustrator files require the external
VectorCraft converter. Builds using `no_proprietary` exclude optional vendor codecs;
release builds should keep the default features.
## Validation and release status
## Downloads
The feature baseline passed default, all-feature and restricted-build tests,
Clippy with warnings denied, formatting, rustdoc, and manual link/anchor checks.
Whole-application line coverage at the feature milestone is **91.09%**. Name
round trips cover all available codecs except native Illustrator conversion,
which requires VectorCraft. SVG text naming is tested separately.
Choose a **portable bundle** below, extract it, then open Canvas Pilot. The bundles
include icons, a launcher helper and a quick-start guide.
This is a source milestone and release candidate for packaging, not a claim that
platform binaries have been built or smoke-tested. Before public binary release:
| Platform | Portable download |
| --- | --- |
| Windows 64-bit | [Download ZIP](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/releases/download/v0.8.0/canvas-pilot-portable-x86_64-pc-windows-gnu-v0.8.0.zip) |
| Linux x86-64 | [Download TGZ](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/releases/download/v0.8.0/canvas-pilot-portable-x86_64-unknown-linux-gnu-v0.8.0.tgz) |
| macOS Apple Silicon | [Download ZIP](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/releases/download/v0.8.0/canvas-pilot-portable-aarch64-apple-darwin-v0.8.0.zip) |
| macOS Intel | [Download ZIP](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/releases/download/v0.8.0/canvas-pilot-portable-x86_64-apple-darwin-v0.8.0.zip) |
- Build and package Windows x86-64, Linux x86-64, Apple Silicon and Intel macOS
using the pinned release configuration on a capable build host.
- Check archive contents and application startup on the target platforms.
- Verify the published canonical archives with cargo-binstall.
Also available: canonical cargo-binstall archives, standalone binaries, SHA-256
checksums and the machine-readable build manifest. Platform packages are unsigned.
Emulator/readback evidence does not replace physical-output acceptance. Remaining
precision questions and acceptance work stay in the [project plan](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/src/tag/v0.8.0/docs/canvas-pilot/plan.md).
See [release preparation](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/src/tag/v0.8.0/docs/development/releases.md) for the exact build command, and the
[changelog](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/src/tag/v0.8.0/docs/canvas-pilot/changelog.md#v080--2026-11-16) for the detailed changes.
- [Offline manual](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/releases/download/v0.8.0/canvas-pilot-offline-manual-v0.8.0.zip): extract and open `index.html`.
- [Starter templates](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/releases/download/v0.8.0/canvas-pilot-starter-templates-v0.8.0.zip): editable Full HD and UHD examples.
- [Online manual](https://books.dandaedre.com/manuals/canvas-pilot/).
## Validation
Rust tests, formatting, Clippy, rustdoc and book checks passed for the feature
baseline; whole-application line coverage was **91.09%**. The release-version
package tests and 26 Python checks also passed. Name round trips cover available
codecs except native Illustrator conversion, which requires VectorCraft.
The built Linux binary passed an isolated GUI startup/render check with an empty
startup log. Archive integrity, checksums and architecture checks are recorded by the release
tooling. Cross compilation does not establish native Windows/macOS GUI behavior;
no macOS runtime runner is available here. Emulator/readback evidence likewise
does not replace physical-output acceptance. Remaining acceptance work stays in
the [project plan](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/src/tag/v0.8.0/docs/canvas-pilot/plan.md).
## Build reproducibility
The tagged source and lockfile were unchanged. The original macOS image had Rust
1.93, below the locked CAD dependencies' requirement. macOS therefore uses the same
SDK image with Rust 1.100.0 installed; Linux and Windows also used Rust 1.100.0.
The [build instructions](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/releases/download/v0.8.0/BUILDING-v0.8.0.md), compiler recipe and effective release configuration
are attached, with checksums. The artifact manifest distinguishes packaging checks
from native runtime checks. macOS requires 13.0 or newer; binaries are not notarized.

View File

@ -1,25 +1,56 @@
# Release preparation
## Current milestone: v0.8.0
## Published milestone: v0.8.0
[Release notes](release-notes/v0.8.0.md) record the standalone Canvas Pilot and
advanced exchange milestone. The workspace and lockfile use version 0.8.0.
The annotated local `v0.8.0` tag identifies the committed release preparation.
Tags and commits are not pushed automatically, and no binaries are published by
this preparation task.
[Download v0.8.0](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/releases/tag/v0.8.0).
The annotated tag identifies source commit `eb82dc7cc91105793d2d31552da71763d2218df5`;
subsequent publication documentation does not move that tag. The release has 21
assets: four portable bundles, four canonical cargo-binstall archives, four raw
binaries, the artifact manifest/checksums, and seven manual/template/build extras.
The [release notes](release-notes/v0.8.0.md) describe compatibility and downloads.
On a capable build host with this tagged commit checked out:
All four builds passed. Linux GUI startup/render passed with isolated settings.
Both macOS binaries passed Mach-O architecture, minimum macOS 13.0, system-library,
archive-layout and checksum checks. Native Windows/macOS runtime testing was not
available. All 21 assets were downloaded and hash-checked before publication and
again anonymously after publication. cargo-binstall retrieved all four targets
from the public release; each installed binary matched the built artifact SHA-256.
### Required macOS compiler override
The original pinned SDK image contains Rust 1.93, but the locked CAD dependencies
require Rust 1.95 or newer. The first real release build exposed this mismatch;
the earlier dry run could not detect it. v0.8.0 keeps its application source and
lockfile unchanged and uses Rust 1.100.0 for all targets.
The [compiler recipe](../../scripts/release/Containerfile.apple) extends the original
immutable image with Rust 1.100.0 and both Apple target libraries. Its built digest,
Cross image digests and validation boundaries are in the release's
`build-provenance.json`. The macOS configuration used is attached as
`rust-release-v0.8.0.toml`; the image is locally built, not a public registry upload.
For a fresh build host, download `Containerfile.apple`, `BUILDING-v0.8.0.md` and
`rust-release-v0.8.0.toml` from the release. Build the recipe, then set the supplied
configuration's `build.apple.image` to your local image's immutable digest, as
explained in the build instructions. A rebuilt image's digest can differ because
of build timestamps. From a clean tagged checkout:
```sh
rust_realease . --package canvas-pilot --tag v0.8.0 --dry-run
rust_realease . --package canvas-pilot --tag v0.8.0 --compile-only
rust_realease . --package canvas-pilot --tag v0.8.0 --dry-run --config /path/to/rust-release-v0.8.0.toml
rust_realease . --package canvas-pilot --tag v0.8.0 --compile-only --artifact-format both --config /path/to/rust-release-v0.8.0.toml
```
The second command performs the expensive four-target builds and packaging; it
creates no remote release. Keep default features enabled for vendor formats.
After target-platform smoke tests, a separately authorized publishing run can
use `--message-file docs/development/release-notes/v0.8.0.md` and the configured
credential mechanism. Do not use `--replace-assets` for a first publication.
Keep default features enabled for vendor formats. The second command builds and
packages all targets without publishing. For this publication, the successful
Linux/Windows binaries were retained after the first macOS failure; macOS was
rerun with the compatible compiler. Retained binaries were packaged to the same
configured layouts with entry/hash/permission/architecture verification. The
combined artifact manifest records this rather than claiming one uninterrupted run.
Release assets were uploaded as a draft using the authorized token, verified, then
published through Gitea. Credentials and generated archives remain outside Git.
Do not replace existing public assets or move the release tag for future fixes;
prepare a new version instead.
## Packaging configuration
@ -52,7 +83,7 @@ artifacts. Run it later on a capable build host:
rust_realease . --package canvas-pilot --compile-only
```
### Readiness audit — 2026-11-16
### Historical readiness audit — 2026-11-16 (before the milestone)
Checked with `rust_realease 0.1.6-rc.3`, without compiling or publishing:

View File

@ -0,0 +1,3 @@
FROM ghcr.io/rust-cross/cargo-zigbuild@sha256:9b4f6b3eb9e8f9fefb3960fe288ddba576627d66d9eff851ce7f62d2455564a5
RUN rustup toolchain install 1.100.0 --profile minimal --target aarch64-apple-darwin,x86_64-apple-darwin
ENV RUSTUP_TOOLCHAIN=1.100.0