66 lines
3.5 KiB
Markdown
66 lines
3.5 KiB
Markdown
# Manual preview 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.
|
|
|
|
Build local artifacts without a token or contacting Gitea:
|
|
|
|
```sh
|
|
CROSS_CONTAINER_ENGINE=podman ../rust_realease/target/release/rust_realease . \
|
|
--package pdf-presenter --compile-only
|
|
```
|
|
|
|
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.
|
|
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.
|
|
|
|
Keep a clean committed checkout for reusable builds. Private local test PDFs are
|
|
ignored and never included in archives. Dependency notices are embedded (`--licenses`)
|
|
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.17 is prepared as a **preview**, not a production-readiness claim.
|
|
|
|
Publication is a separate explicit action: create local `v0.1.17` 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.17.md \
|
|
--token-file ../gitea-token.txt
|
|
```
|
|
|
|
`--dry-run` previews without remote mutation. Before tagging, its missing-tag
|
|
prerequisite is expected. Do not use automatic tag/push options as part of local
|
|
preparation. Never put credentials in configuration, artifacts or Git.
|
|
|
|
## Local validation for 0.1.17
|
|
|
|
Formatting, warnings-denied Clippy/rustdoc, 47 Rust tests (including native X11
|
|
icon-property checks), 12 Python tests, desktop-entry syntax validation and
|
|
macOS aarch64 compile-check pass. Whole-application line coverage is 84.05%.
|
|
The native test now tolerates BadWindow when unrelated desktop windows disappear
|
|
during enumeration; other X11 errors still fail. No production code is excluded.
|
|
Windows Explorer/taskbar appearance and Linux Wayland shell integration still
|
|
need native user confirmation.
|
|
|
|
`rust_realease --compile-only` successfully built and packaged both targets from
|
|
commit `5d12b85`. All seven checksummed files (six packages/binaries plus the
|
|
artifact manifest) verify. Inspection confirms seven Windows ICON resources plus
|
|
the GROUP_ICON and version resources, and only system DLL imports. Linux ELF imports
|
|
are libc/libm/libgcc_s/the loader. The extracted Linux portable bundle passed its
|
|
native presenter/browser smoke test and optional launcher installation in temporary
|
|
XDG directories; the resulting desktop entry passed desktop-file-validate.
|
|
No tag, push or Gitea release was created. Windows native appearance still needs user
|
|
testing; import inspection alone does not establish clean-machine acceptance.
|