# Build scripts Local release builds for Windows and Linux. ## 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`. ## Windows ```powershell .\scripts\build-windows.ps1 ``` Output: `target\release\posprint.exe` Options: ```powershell .\scripts\build-windows.ps1 -Deb:$false # exe only (default) ``` ## 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 **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 ``` 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/*.deb` | | Arch package | `packaging/arch/posprint-*-x86_64.pkg.tar.zst` | ### 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 ``` ## Tests before release ```bash cargo test --release ```