release: add ARM and macOS stable targets
Gitea/pdf-presenter/pipeline/head This commit looks good Details

This commit is contained in:
Dandaedre 2026-11-21 08:00:06 +01:00
parent 044bdf1807
commit 5e1bebdbd5
9 changed files with 100 additions and 33 deletions

2
Cargo.lock generated
View File

@ -2245,7 +2245,7 @@ dependencies = [
[[package]]
name = "pdf-presenter"
version = "0.1.90"
version = "0.1.91"
dependencies = [
"bytemuck",
"chrono",

View File

@ -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"

View File

@ -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"

View File

@ -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.
---

View File

@ -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

View File

@ -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.

View File

@ -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
```

View File

@ -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

View File

@ -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"