BlueGit

timfa posprint

Files

posprint / docs / BUILD.md

BUILD.md

BUILD.md 1.5 KiB Download Raw

Build scripts

Local release builds for Windows and Linux.

Windows

.\scripts\build-windows.ps1

Output: target\release\posprint.exe

Options:

.\scripts\build-windows.ps1 -Deb:$false   # exe only (default)

Linux

chmod +x scripts/build-linux.sh
./scripts/build-linux.sh          # release binary
./scripts/build-linux.sh --deb    # binary + .deb package

Outputs:

ArtifactPath
Binarytarget/release/posprint
Debian packagetarget/debian/*.deb

Linux targets we support

FormatDistrosNotes
.debDebian, Ubuntu, Mint, Pop!_OS, etc.Recommended for apt-based systems; produced by cargo-deb
Raw binaryAny x86_64 LinuxCopy target/release/posprint; needs X11/Wayland libs at runtime
.rpmFedora, RHEL, openSUSENot automated yet; build binary and wrap with fpm if needed
AppImageUniversalNot automated yet; good for portable distribution

Architecture: x86_64 (amd64) only in CI and build scripts today.

Linux build dependencies (Debian/Ubuntu)

sudo apt-get install -y build-essential pkg-config \
  libxcb-render0-dev libxcb-shape0-dev libxcb-xfixes0-dev libxkbcommon-dev libssl-dev

For .deb:

cargo install cargo-deb --locked

Tests before release

cargo test --release
Source
1# Build scripts
2
3Local release builds for Windows and Linux.
4
5## Windows
6
7```powershell
8.\scripts\build-windows.ps1
9```
10
11Output: `target\release\posprint.exe`
12
13Options:
14
15```powershell
16.\scripts\build-windows.ps1 -Deb:$false # exe only (default)
17```
18
19## Linux
20
21```bash
22chmod +x scripts/build-linux.sh
23./scripts/build-linux.sh # release binary
24./scripts/build-linux.sh --deb # binary + .deb package
25```
26
27Outputs:
28
29| Artifact | Path |
30|----------|------|
31| Binary | `target/release/posprint` |
32| Debian package | `target/debian/*.deb` |
33
34### Linux targets we support
35
36| Format | Distros | Notes |
37|--------|---------|-------|
38| **`.deb`** | Debian, Ubuntu, Mint, Pop!_OS, etc. | **Recommended** for apt-based systems; produced by `cargo-deb` |
39| **Raw binary** | Any x86_64 Linux | Copy `target/release/posprint`; needs X11/Wayland libs at runtime |
40| **`.rpm`** | Fedora, RHEL, openSUSE | Not automated yet; build binary and wrap with `fpm` if needed |
41| **AppImage** | Universal | Not automated yet; good for portable distribution |
42
43**Architecture:** `x86_64` (amd64) only in CI and build scripts today.
44
45### Linux build dependencies (Debian/Ubuntu)
46
47```bash
48sudo apt-get install -y build-essential pkg-config \
49 libxcb-render0-dev libxcb-shape0-dev libxcb-xfixes0-dev libxkbcommon-dev libssl-dev
50```
51
52For `.deb`:
53
54```bash
55cargo install cargo-deb --locked
56```
57
58## Tests before release
59
60```bash
61cargo test --release
62```