From 5e1bebdbd52f5a4feb040829bd8d1a3386be86c8 Mon Sep 17 00:00:00 2001 From: Dandaedre Date: Sat, 21 Nov 2026 08:00:06 +0100 Subject: [PATCH] release: add ARM and macOS stable targets --- Cargo.lock | 2 +- Cargo.toml | 2 +- Cross.toml | 3 +++ README.md | 18 +++++++------ docs/changelog.md | 9 +++++++ docs/development/release-notes/v0.1.91.md | 32 +++++++++++++++++++++++ docs/development/releases.md | 28 +++++++++++--------- docs/user-guide.md | 16 +++++++----- rust-release.toml | 23 +++++++++++++--- 9 files changed, 100 insertions(+), 33 deletions(-) create mode 100644 docs/development/release-notes/v0.1.91.md diff --git a/Cargo.lock b/Cargo.lock index 5998a48..83b48c1 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -2245,7 +2245,7 @@ dependencies = [ [[package]] name = "pdf-presenter" -version = "0.1.90" +version = "0.1.91" dependencies = [ "bytemuck", "chrono", diff --git a/Cargo.toml b/Cargo.toml index 09a029b..f2a75e0 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -4,7 +4,7 @@ default-members = ["crates/pdf-presenter"] resolver = "3" [workspace.package] -version = "0.1.90" +version = "0.1.91" edition = "2024" license = "MIT" repository = "https://proxy.dandaedre.com/gitea/idle-org/pdf-presenter" diff --git a/Cross.toml b/Cross.toml index 6349a6f..23cdd91 100644 --- a/Cross.toml +++ b/Cross.toml @@ -4,5 +4,8 @@ passthrough = ["RUSTUP_TOOLCHAIN"] [target.x86_64-unknown-linux-gnu] image = "ghcr.io/cross-rs/x86_64-unknown-linux-gnu:main" +[target.aarch64-unknown-linux-musl] +image = "ghcr.io/cross-rs/aarch64-unknown-linux-musl:main" + [target.x86_64-pc-windows-gnu] image = "ghcr.io/cross-rs/x86_64-pc-windows-gnu:main" diff --git a/README.md b/README.md index e388341..c3fb5a7 100644 --- a/README.md +++ b/README.md @@ -60,21 +60,23 @@ and download the archive for your computer. | --- | --- | --- | | Windows x86_64 | `pdf-presenter-portable-x86_64-pc-windows-gnu-v….zip` | `pdf-presenter.exe` | | Linux x86_64 | `pdf-presenter-portable-x86_64-unknown-linux-gnu-v….tgz` | `./pdf-presenter` | -| Apple Silicon macOS 13+ | v0.1.83 `pdf-presenter-aarch64-apple-darwin-v….tgz` | Follow the release-page instructions for the unsigned executable | +| Linux ARM64 | `pdf-presenter-portable-aarch64-unknown-linux-musl-v….tgz` | `./pdf-presenter` | +| Apple Silicon macOS 13+ | `pdf-presenter-portable-aarch64-apple-darwin-v….tgz` | Follow the release-page macOS instructions | +| Intel macOS 13+ | `pdf-presenter-portable-x86_64-apple-darwin-v….tgz` | Follow the release-page macOS instructions | -Windows and macOS builds are currently unsigned. Releases are previews, so test the -actual computer, adapters and display arrangement before a live event. The macOS -artifact is a one-off cross-build in v0.1.83 and has not yet had native Mac runtime +Windows and macOS builds are currently unsigned. Releases are ready for normal use; +test the actual computer, adapters and display arrangement before a live event. +macOS artifacts are cross-built on Linux and have not yet had native Mac runtime testing. [Installation and update details →](docs/user-guide.md#install-and-update) If you already have [cargo-binstall](https://github.com/cargo-bins/cargo-binstall) installed, you can install a prebuilt release directly: ```sh -cargo binstall pdf-presenter --git https://proxy.dandaedre.com/gitea/idle-org/pdf-presenter --version 0.1.83 --strategies crate-meta-data +cargo binstall pdf-presenter --git https://proxy.dandaedre.com/gitea/idle-org/pdf-presenter --version 0.1.91 --strategies crate-meta-data ``` -Replace `0.1.83` with the published version you want from the release page. This +Replace `0.1.91` with the published version you want from the release page. This uses the repository's release archives and requires an available build for your platform. Then run `pdf-presenter`. @@ -144,8 +146,8 @@ Useful controls: PDF Presenter is independent open-source software under the [MIT license](LICENSE). Development includes LLM-generated or LLM-assisted work with human review. The -project is used in professional settings, while preview limitations and physical -acceptance work remain documented rather than hidden. +project is used in professional settings, while physical acceptance work remains +documented rather than hidden. --- diff --git a/docs/changelog.md b/docs/changelog.md index 89fc488..9750a12 100644 --- a/docs/changelog.md +++ b/docs/changelog.md @@ -2,6 +2,15 @@ ## Unreleased +### 0.1.91 + +- Promote releases from preview status and add recurring Linux ARM64, Apple Silicon + macOS and Intel macOS artifacts alongside Linux x86_64 and Windows x86_64. +- Pin the macOS 13 cross-build environment, package portable archives for every + target, and document the expanded download and cargo-binstall choices. +- Linux formatting, warnings-denied Clippy/rustdoc, workspace tests and 13 Python + helper tests pass; full GUI coverage is 84.79% against the 75% floor. + ### 0.1.90 - Correct CLI help for confirmed quitting and hold-S screen swapping. Release diff --git a/docs/development/release-notes/v0.1.91.md b/docs/development/release-notes/v0.1.91.md new file mode 100644 index 0000000..1d3a4b0 --- /dev/null +++ b/docs/development/release-notes/v0.1.91.md @@ -0,0 +1,32 @@ +# PDF Presenter 0.1.91 + +PDF Presenter releases are now regular releases rather than previews. The version +remains below 1.0 while the project continues to refine platform integration and +physical-display acceptance. + +## Expanded platform packages + +This release provides standalone binaries, cargo-binstall archives, portable +bundles and SHA-256 checksums for: + +- Linux x86_64 GNU +- Linux ARM64 musl +- Windows x86_64 GNU +- Apple Silicon macOS 13+ +- Intel macOS 13+ + +The Linux ARM64 build uses musl for a portable executable. Both macOS builds use a +pinned cross-build image and macOS 13 deployment target. Windows and macOS builds +are unsigned. The release page includes the commands needed to run the unsigned +macOS archives. + +## Validation + +Linux formatting, warnings-denied Clippy/rustdoc, workspace tests, build and 13 +Python helper tests pass. Full GUI coverage is **84.79%** against the 75% floor. +The release pipeline also verifies target architecture, archive layout, checksums, +system-library dependencies and isolated cargo-binstall extraction for every +target. Linux x86_64 receives the native-window smoke test. macOS artifacts cannot +be executed on the Linux release host, and native Windows/macOS runtime, +clean-machine and physical multiscreen acceptance remain open. Rehearse on the +actual presentation computer and display arrangement before a live event. diff --git a/docs/development/releases.md b/docs/development/releases.md index 401a513..f8a1598 100644 --- a/docs/development/releases.md +++ b/docs/development/releases.md @@ -1,10 +1,10 @@ -# Manual preview releases +# Manual releases The standalone `rust_realease` tool (sibling checkout `../rust_realease`) consumes root `rust-release.toml` and `Cross.toml`. Jenkins still only validates/publishes -badges. The release configuration selects Linux x86_64 GNU and Windows x86_64 GNU. -macOS remains an implementation target, but is not advertised as a prepared release -artifact until a linked native build and runtime acceptance are available. +badges. The release configuration selects Linux x86_64 GNU, Linux ARM64 musl, +Windows x86_64 GNU, and both Apple Silicon and Intel macOS 13+ targets. Releases are +ordinary releases below 1.0; do not pass `--prerelease` during publication. Build local artifacts without a token or contacting Gitea: @@ -15,9 +15,10 @@ CROSS_CONTAINER_ENGINE=podman ../rust_realease/target/release/rust_realease . \ Use the installed `rust_realease` command instead if preferred. Cross must have access to its configured images. Outputs live under `dist/` (the tool prints the final release directory), including -raw executables, binstall `.tgz` archives, a Linux portable `.tgz`, a Windows -portable `.zip`, and `SHA256SUMS`. The binaries themselves need no companion assets. -Portable bundles add the license, quickstart and optional Python Linux launcher. +raw executables, binstall `.tgz` archives, portable bundles, `SHA256SUMS` and an +artifact manifest. Windows portable bundles use ZIP; other targets use `.tgz`. +The binaries themselves need no companion assets. Portable bundles add the license, +quickstart and optional Python Linux launcher. Wayland shells resolve icons through the matching installed desktop entry; X11 and Windows also receive the embedded native window icon directly. The Windows PE icon is embedded at build time using winresource/windres. @@ -27,16 +28,17 @@ ignored and never included in archives. Dependency notices are embedded (`--lice and regenerated with `python3 scripts/notices.py` after dependency changes. Before publication, run all checks in [CI](ci.md), inspect bundle contents and -checksums, and test extracted binaries on clean Windows/Linux machines. Physical -multiscreen, sleep and performance acceptance remains in [the plan](plan.md). -Version 0.1.33 is prepared as a **preview**, not a production-readiness claim. +checksums, and test extracted binaries on available native platforms. Cross-built +macOS artifacts require the generated release-page workaround and native Mac testing +when available. Physical multiscreen, sleep and performance acceptance remains in +[the plan](plan.md). -Publication is a separate explicit action: create local `v0.1.33` at the reviewed +Publication is a separate explicit action: create the version tag at the reviewed commit, push that commit/tag, then run: ```sh -rust_realease . --package pdf-presenter --prerelease \ - --message-file docs/development/release-notes/v0.1.33.md \ +rust_realease . --package pdf-presenter \ + --message-file docs/development/release-notes/vVERSION.md \ --token-file ../gitea-token.txt ``` diff --git a/docs/user-guide.md b/docs/user-guide.md index 0fbb9f0..a541b19 100644 --- a/docs/user-guide.md +++ b/docs/user-guide.md @@ -2,12 +2,14 @@ ## Install and update -Download a preview from the [releases page](https://proxy.dandaedre.com/gitea/idle-org/pdf-presenter/releases). -Choose the portable ZIP for Windows x86_64 or portable `.tgz` for Linux x86_64, -extract the whole archive, and run `pdf-presenter.exe` or `./pdf-presenter`. +Download the latest version from the [releases page](https://proxy.dandaedre.com/gitea/idle-org/pdf-presenter/releases). +Choose the portable ZIP for Windows x86_64 or the portable `.tgz` matching Linux +x86_64, Linux ARM64, Apple Silicon macOS or Intel macOS. Extract the whole archive, +then run `pdf-presenter.exe` or `./pdf-presenter` as directed on the release page. No Rust toolchain, Python or separate PDF renderer is needed to run the application. Linux uses the system desktop services and X11/Wayland libraries. Windows binaries -are unsigned; macOS packages are not currently provided. Release assets include +are unsigned; macOS packages are unsigned and require the release-page workaround. +Release assets include `SHA256SUMS` for checking downloads. For optional Linux application-menu and Wayland icon integration, keep the extracted @@ -26,9 +28,9 @@ and run its executable. Settings and saved layouts live in your user configurati directory, outside the extracted folder. If you installed the Linux launcher, rerun its installer from the new location so it points to the updated binary. -These are preview releases: physical display routing, sleep prevention and -clean-machine compatibility still need acceptance testing. Rehearse on the displays -you plan to use before a live event. +Physical display routing, sleep prevention and clean-machine compatibility still +need broader acceptance testing. Rehearse on the displays you plan to use before a +live event. ## Open your slides diff --git a/rust-release.toml b/rust-release.toml index b580f74..fa229d7 100644 --- a/rust-release.toml +++ b/rust-release.toml @@ -2,17 +2,34 @@ tag-prefix = "v" [build] -targets = ["x86_64-unknown-linux-gnu", "x86_64-pc-windows-gnu"] +targets = [ + "x86_64-unknown-linux-gnu", + "aarch64-unknown-linux-musl", + "x86_64-pc-windows-gnu", + "aarch64-apple-darwin", + "x86_64-apple-darwin", +] profile = "release" locked = true +[build.apple] +image = "ghcr.io/rust-cross/cargo-zigbuild@sha256:9b4f6b3eb9e8f9fefb3960fe288ddba576627d66d9eff851ce7f62d2455564a5" +deployment-target = "13.0" +sdk-root = "/opt/MacOSX11.3.sdk" + [package] format = "both" [[package.bundles]] name = "portable" -targets = ["x86_64-unknown-linux-gnu", "x86_64-pc-windows-gnu"] -formats = { x86_64-pc-windows-gnu = "zip", x86_64-unknown-linux-gnu = "tgz" } +targets = [ + "x86_64-unknown-linux-gnu", + "aarch64-unknown-linux-musl", + "x86_64-pc-windows-gnu", + "aarch64-apple-darwin", + "x86_64-apple-darwin", +] +formats = { x86_64-pc-windows-gnu = "zip", x86_64-unknown-linux-gnu = "tgz", aarch64-unknown-linux-musl = "tgz", aarch64-apple-darwin = "tgz", x86_64-apple-darwin = "tgz" } archive-name = "{name}-{bundle}-{target}-v{version}" root = "{name}-{bundle}-{target}-v{version}" cargo-binaries = "all"