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

`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/*.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
```
