# Build scripts Local release builds for Windows, Linux, and macOS. ## Toolchain You need a Rust toolchain (**1.88+**; CI uses 1.96). Install once: ```bash # Recommended (any distro) curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh # then restart the shell, or: source "$HOME/.cargo/env" # Or on Arch Linux sudo pacman -S --needed rust ``` Also install the platform build libraries under **Linux build dependencies** below before `cargo test` / `cargo build`. **Interactive shells:** the build scripts detect missing requirements (Rust, apt/pacman packages, `cargo-deb`, `base-devel`) and ask whether to install them automatically. Non-interactive runs (CI/pipes) never prompt; they print install instructions and exit. ## Windows ```powershell .\scripts\build-windows.ps1 ``` Output: `target\release\posprint.exe` If `cargo`/`rustc` are missing and the shell is interactive, the script offers to install Rust via **winget** (`Rustlang.Rustup`) or **rustup-init**. Options: ```powershell .\scripts\build-windows.ps1 -SkipTests ``` ## macOS ```bash chmod +x scripts/build-macos.sh ./scripts/build-macos.sh # release binary (target/release/posprint) ./scripts/build-macos.sh --app # binary + target/macos/Posprint.app ./scripts/build-macos.sh --dmg # binary + Posprint.app + target/macos/Posprint--macos-.dmg ./scripts/build-macos.sh --install # build Posprint.app, install to /Applications & PATH, register posprint:// ``` `Posprint.app` bundles the native `posprint` binary together with an AppleEvent launcher (`packaging/macos/Info.plist`) so clicking `posprint://` deep links in Safari/Chrome or opening `.pos` files in Finder launches `posprint` automatically. ## Linux ```bash chmod +x scripts/build-linux.sh ./scripts/build-linux.sh # release binary ./scripts/build-linux.sh --deb # binary + .deb (prompts to install if interactive) ./scripts/build-linux.sh --deb --install # build .deb and install with apt ``` On a TTY, missing **apt** build packages and (with `--deb`) **cargo-deb** are offered for install before building. On **Arch Linux**: ```bash chmod +x scripts/build-arch.sh ./scripts/build-arch.sh # .pkg.tar.zst (prompts to install if interactive) ./scripts/build-arch.sh --install # build and install with pacman ``` On a TTY, missing **base-devel**, Rust, and common pacman build libs are offered for install before building. `build-arch.sh` accepts a **rustup** toolchain on `PATH`. If the pacman `rust`/`cargo` packages are not installed, it runs `makepkg --nodeps` after verifying `rustc`/`cargo` work (the PKGBUILD still lists those packages for AUR/CI). After a successful package build, both scripts ask whether to install (TTY only). Pass `--install` to skip the prompt and install automatically. Non-interactive runs (CI/pipes) never prompt. Outputs: | Artifact | Path | |----------|------| | Binary | `target/release/posprint` | | Debian package | `target/debian/posprint_-1_amd64.deb` (`cargo-deb` revision defaults to `1`) | | Arch package | `packaging/arch/posprint--1-x86_64.pkg.tar.zst` (hyphens; not `posprint_`) | | AUR bin tarball | `dist/posprint--x86_64.tar.gz` (packed from the non-debug Arch package) | ### Linux targets we support | Format | Distros | Notes | |--------|---------|-------| | **`.deb`** | Debian, Ubuntu, Mint, Pop!_OS, etc. | **Recommended** for apt-based systems; produced by `cargo-deb` | | **`.pkg.tar.zst`** | Arch Linux, Manjaro, EndeavourOS, etc. | **Recommended** for pacman; `sudo pacman -U posprint-*.pkg.tar.zst` | | **Raw binary** | Any x86_64 Linux | Copy `target/release/posprint`; needs X11/Wayland libs at runtime | | **`.rpm`** | Fedora, RHEL, openSUSE | Not automated yet; build binary and wrap with `fpm` if needed | | **AppImage** | Universal | Not automated yet; good for portable distribution | **Architecture:** `x86_64` (amd64) only in CI and build scripts today. ### Linux build dependencies (Debian/Ubuntu) ```bash sudo apt-get install -y build-essential pkg-config \ libxcb-render0-dev libxcb-shape0-dev libxcb-xfixes0-dev libxkbcommon-dev \ libssl-dev libudev-dev ``` For `.deb`: ```bash cargo install cargo-deb --locked ``` ### Arch Linux build dependencies ```bash sudo pacman -S --needed base-devel rust pkgconf openssl libxkbcommon libxcb dbus \ wayland libx11 fontconfig freetype2 libglvnd git rsync ``` ### AUR publishing Normal local Arch packaging uses `packaging/arch/PKGBUILD`. Automated AUR publishing uses: - `packaging/aur/PKGBUILD` — source package (`posprint`) - `packaging/aur-bin/PKGBUILD` — binary package (`posprint-bin`) - `scripts/publish-aur.sh` — updates both AUR repos on tags (uses the local `dist/` tarball from `build:linux-arch`) - `scripts/make-linux-bin-tarball.sh` — packs `usr/` from the **non-debug** Arch CI `.pkg.tar.zst` - `scripts/publish-gitlab-release.sh` — uploads real `dist/` filenames to the Generic Package Registry and attaches them to the GitLab Release The source package builds from the GitLab tag tarball. The binary package installs a prebuilt tree from the Generic Package Registry (not `jobs/artifacts/` permalinks). Tag pipelines also keep job artifacts for a year, but **Release / Package Registry URLs are the ones that stay downloadable** if a later job fails. Setup and required GitLab secrets are documented in [AUR.md](AUR.md). To refresh an already-shipped tag (for example 0.5.7), delete and recreate that tag on a commit that contains the current `.gitlab-ci.yml` — see [AUR.md](AUR.md#refreshing-tag-057-or-any-already-pushed-tag). ### File association (`.pos` → posprint) The package installs: - `/usr/share/mime/packages/posprint.xml` → MIME type `application/x-posprint` for `*.pos` - `/usr/share/applications/posprint.desktop` → claims that MIME type After `pacman -U`, pacman hooks refresh the MIME and desktop databases. To make posprint the **default** opener (double-click): ```bash xdg-mime default posprint.desktop application/x-posprint xdg-mime query filetype some.pos # expect: application/x-posprint xdg-mime query default application/x-posprint # expect: posprint.desktop ``` If `query filetype` still says `text/plain`, the MIME package was not installed or the cache is stale: ```bash sudo update-mime-database /usr/share/mime sudo update-desktop-database /usr/share/applications ``` ## Tests before release ```bash cargo test --release ```