BlueGit

timfa posprint

Add Arch Linux pacman release via PKGBUILD and GitLab CI.

Produce .pkg.tar.zst on tagged releases for pacman -U installation.

Co-authored-by: Cursor <cursoragent@cursor.com>

timfa Tim Falken · pushed by timfa

Authored 2026-07-15 · 4 months ago

Hash
0308c4fcd80731ddbb97e0076c5b4aafaab828d5
Parent
c6fac090
7 files changed +145 −5
.cursor/rules/development.mdc +3 −2
@@ -37,5 +37,6 @@ alwaysApply: true
37 37 ## Releases
38 38
39 39 - GitLab CI (`.gitlab-ci.yml`) runs tests on push.
40 - Tagged releases produce Linux `.deb` (apt) and Windows `posprint.exe`.
41 - Linux release uses `cargo-deb` and `[package.metadata.deb]` in `Cargo.toml`.
40 - Tagged releases produce Windows `.exe`, Debian `.deb` (apt), and Arch `.pkg.tar.zst` (pacman).
41 - Debian packages use `cargo-deb` and `[package.metadata.deb]` in `Cargo.toml`.
42 - Arch packages use `packaging/arch/PKGBUILD` and `makepkg`.
@@ -37,5 +37,6 @@ alwaysApply: true
37## Releases
37## Releases
38
38
39- GitLab CI (`.gitlab-ci.yml`) runs tests on push.
39- GitLab CI (`.gitlab-ci.yml`) runs tests on push.
40- Tagged releases produce Linux `.deb` (apt) and Windows `posprint.exe`.
40- Tagged releases produce Windows `.exe`, Debian `.deb` (apt), and Arch `.pkg.tar.zst` (pacman).
41- Linux release uses `cargo-deb` and `[package.metadata.deb]` in `Cargo.toml`.
41- Debian packages use `cargo-deb` and `[package.metadata.deb]` in `Cargo.toml`.
42- Arch packages use `packaging/arch/PKGBUILD` and `makepkg`.
.gitignore +4 −0
@@ -1 +1,5 @@
1 1 /target
2 packaging/arch/pkg/
3 packaging/arch/src/
4 packaging/arch/*.pkg.tar.zst
5 packaging/arch/*.pkg.tar.zst.sig
@@ -1 +1,5 @@
1/target
1/target
2packaging/arch/pkg/
3packaging/arch/src/
4packaging/arch/*.pkg.tar.zst
5packaging/arch/*.pkg.tar.zst.sig
.gitlab-ci.yml +24 −1
@@ -1,5 +1,5 @@
1 1 # posprint — GitLab CI/CD
2 # Builds and tests on every push; publishes Windows and Linux (.deb) releases on tags.
2 # Builds and tests on every push; publishes Windows, Debian, and Arch releases on tags.
3 3
4 4 stages:
5 5 - test
@@ -55,6 +55,27 @@ build:linux-deb:
55 55 - dist/*.deb
56 56 expire_in: 1 year
57 57
58 build:linux-arch:
59 stage: build
60 image: archlinux/archlinux:base-devel
61 rules:
62 - if: $CI_COMMIT_TAG
63 script:
64 - pacman -Syu --noconfirm
65 - pacman -S --noconfirm --needed rust pkgconf openssl libxkbcommon libxcb dbus-libs
66 wayland libx11 fontconfig freetype2 libglvnd git rsync
67 - export PKGVER="${CI_COMMIT_TAG#v}"
68 - sed -i "s/^pkgver=.*/pkgver=${PKGVER}/" packaging/arch/PKGBUILD
69 - cd packaging/arch
70 - makepkg -f --noconfirm --asroot
71 - mkdir -p "$CI_PROJECT_DIR/dist"
72 - cp ./*.pkg.tar.zst "$CI_PROJECT_DIR/dist/"
73 artifacts:
74 name: "posprint-arch-$CI_COMMIT_TAG"
75 paths:
76 - dist/*.pkg.tar.zst
77 expire_in: 1 year
78
58 79 build:windows:
59 80 stage: build
60 81 tags:
@@ -79,6 +100,7 @@ release:gitlab:
79 100 - if: $CI_COMMIT_TAG
80 101 needs:
81 102 - build:linux-deb
103 - build:linux-arch
82 104 - build:windows
83 105 script:
84 106 - |
@@ -87,4 +109,5 @@ release:gitlab:
87 109 --tag-name "$CI_COMMIT_TAG" \
88 110 --description "Cross-platform POS print designer release $CI_COMMIT_TAG" \
89 111 --assets-link "{\"name\":\"Linux .deb (amd64)\",\"url\":\"${CI_PROJECT_URL}/-/jobs/artifacts/${CI_COMMIT_TAG}/raw/dist/posprint_${CI_COMMIT_TAG#v}_amd64.deb?job=build%3Alinux-deb\",\"link_type\":\"package\"}" \
112 --assets-link "{\"name\":\"Arch Linux .pkg.tar.zst (x86_64)\",\"url\":\"${CI_PROJECT_URL}/-/jobs/artifacts/${CI_COMMIT_TAG}/raw/dist/posprint_${CI_COMMIT_TAG#v}-1-x86_64.pkg.tar.zst?job=build%3Alinux-arch\",\"link_type\":\"package\"}" \
90 113 --assets-link "{\"name\":\"Windows .exe\",\"url\":\"${CI_PROJECT_URL}/-/jobs/artifacts/${CI_COMMIT_TAG}/raw/dist/posprint.exe?job=build%3Awindows\",\"link_type\":\"package\"}"
@@ -1,5 +1,5 @@
1# posprint — GitLab CI/CD
1# posprint — GitLab CI/CD
2# Builds and tests on every push; publishes Windows and Linux (.deb) releases on tags.
2# Builds and tests on every push; publishes Windows, Debian, and Arch releases on tags.
3
3
4stages:
4stages:
5 - test
5 - test
@@ -55,6 +55,27 @@ build:linux-deb:
55 - dist/*.deb
55 - dist/*.deb
56 expire_in: 1 year
56 expire_in: 1 year
57
57
58build:linux-arch:
59 stage: build
60 image: archlinux/archlinux:base-devel
61 rules:
62 - if: $CI_COMMIT_TAG
63 script:
64 - pacman -Syu --noconfirm
65 - pacman -S --noconfirm --needed rust pkgconf openssl libxkbcommon libxcb dbus-libs
66 wayland libx11 fontconfig freetype2 libglvnd git rsync
67 - export PKGVER="${CI_COMMIT_TAG#v}"
68 - sed -i "s/^pkgver=.*/pkgver=${PKGVER}/" packaging/arch/PKGBUILD
69 - cd packaging/arch
70 - makepkg -f --noconfirm --asroot
71 - mkdir -p "$CI_PROJECT_DIR/dist"
72 - cp ./*.pkg.tar.zst "$CI_PROJECT_DIR/dist/"
73 artifacts:
74 name: "posprint-arch-$CI_COMMIT_TAG"
75 paths:
76 - dist/*.pkg.tar.zst
77 expire_in: 1 year
78
58build:windows:
79build:windows:
59 stage: build
80 stage: build
60 tags:
81 tags:
@@ -79,6 +100,7 @@ release:gitlab:
79 - if: $CI_COMMIT_TAG
100 - if: $CI_COMMIT_TAG
80 needs:
101 needs:
81 - build:linux-deb
102 - build:linux-deb
103 - build:linux-arch
82 - build:windows
104 - build:windows
83 script:
105 script:
84 - |
106 - |
@@ -87,4 +109,5 @@ release:gitlab:
87 --tag-name "$CI_COMMIT_TAG" \
109 --tag-name "$CI_COMMIT_TAG" \
88 --description "Cross-platform POS print designer release $CI_COMMIT_TAG" \
110 --description "Cross-platform POS print designer release $CI_COMMIT_TAG" \
89 --assets-link "{\"name\":\"Linux .deb (amd64)\",\"url\":\"${CI_PROJECT_URL}/-/jobs/artifacts/${CI_COMMIT_TAG}/raw/dist/posprint_${CI_COMMIT_TAG#v}_amd64.deb?job=build%3Alinux-deb\",\"link_type\":\"package\"}" \
111 --assets-link "{\"name\":\"Linux .deb (amd64)\",\"url\":\"${CI_PROJECT_URL}/-/jobs/artifacts/${CI_COMMIT_TAG}/raw/dist/posprint_${CI_COMMIT_TAG#v}_amd64.deb?job=build%3Alinux-deb\",\"link_type\":\"package\"}" \
112 --assets-link "{\"name\":\"Arch Linux .pkg.tar.zst (x86_64)\",\"url\":\"${CI_PROJECT_URL}/-/jobs/artifacts/${CI_COMMIT_TAG}/raw/dist/posprint_${CI_COMMIT_TAG#v}-1-x86_64.pkg.tar.zst?job=build%3Alinux-arch\",\"link_type\":\"package\"}" \
90 --assets-link "{\"name\":\"Windows .exe\",\"url\":\"${CI_PROJECT_URL}/-/jobs/artifacts/${CI_COMMIT_TAG}/raw/dist/posprint.exe?job=build%3Awindows\",\"link_type\":\"package\"}"
113 --assets-link "{\"name\":\"Windows .exe\",\"url\":\"${CI_PROJECT_URL}/-/jobs/artifacts/${CI_COMMIT_TAG}/raw/dist/posprint.exe?job=build%3Awindows\",\"link_type\":\"package\"}"
README.md +3 −2
@@ -16,7 +16,7 @@ cargo run # launch the designer
16 16 cargo build --release
17 17 ```
18 18
19 **Scripts:** `scripts/build-windows.ps1`, `scripts/build-linux.sh` (see [docs/BUILD.md](docs/BUILD.md)).
19 **Scripts:** `scripts/build-windows.ps1`, `scripts/build-linux.sh`, `scripts/build-arch.sh` (see [docs/BUILD.md](docs/BUILD.md)).
20 20
21 21 ### Command-line printing
22 22
@@ -36,7 +36,8 @@ All `${Parameters}` must be supplied via `--set NAME=VALUE` or the command fails
36 36
37 37 | Platform | Artifact | Install |
38 38 |----------|----------|---------|
39 | Linux | `.deb` (amd64) | `sudo dpkg -i posprint_*_amd64.deb` then `sudo apt-get install -f` |
39 | Linux (Debian/Ubuntu) | `.deb` (amd64) | `sudo dpkg -i posprint_*_amd64.deb` then `sudo apt-get install -f` |
40 | Linux (Arch) | `.pkg.tar.zst` (x86_64) | `sudo pacman -U posprint_*_x86_64.pkg.tar.zst` |
40 41 | Windows | `posprint.exe` | Download from GitLab release job artifacts |
41 42
42 43 Tag a version (e.g. `v0.1.0`) to trigger release builds.
@@ -16,7 +16,7 @@ cargo run # launch the designer
16cargo build --release
16cargo build --release
17```
17```
18
18
19**Scripts:** `scripts/build-windows.ps1`, `scripts/build-linux.sh` (see [docs/BUILD.md](docs/BUILD.md)).
19**Scripts:** `scripts/build-windows.ps1`, `scripts/build-linux.sh`, `scripts/build-arch.sh` (see [docs/BUILD.md](docs/BUILD.md)).
20
20
21### Command-line printing
21### Command-line printing
22
22
@@ -36,7 +36,8 @@ All `${Parameters}` must be supplied via `--set NAME=VALUE` or the command fails
36
36
37| Platform | Artifact | Install |
37| Platform | Artifact | Install |
38|----------|----------|---------|
38|----------|----------|---------|
39| Linux | `.deb` (amd64) | `sudo dpkg -i posprint_*_amd64.deb` then `sudo apt-get install -f` |
39| Linux (Debian/Ubuntu) | `.deb` (amd64) | `sudo dpkg -i posprint_*_amd64.deb` then `sudo apt-get install -f` |
40| Linux (Arch) | `.pkg.tar.zst` (x86_64) | `sudo pacman -U posprint_*_x86_64.pkg.tar.zst` |
40| Windows | `posprint.exe` | Download from GitLab release job artifacts |
41| Windows | `posprint.exe` | Download from GitLab release job artifacts |
41
42
42Tag a version (e.g. `v0.1.0`) to trigger release builds.
43Tag a version (e.g. `v0.1.0`) to trigger release builds.
docs/BUILD.md +17 −0
@@ -24,18 +24,28 @@ chmod +x scripts/build-linux.sh
24 24 ./scripts/build-linux.sh --deb # binary + .deb package
25 25 ```
26 26
27 On **Arch Linux**:
28
29 ```bash
30 chmod +x scripts/build-arch.sh
31 ./scripts/build-arch.sh # .pkg.tar.zst for pacman
32 sudo pacman -U packaging/arch/posprint-*-x86_64.pkg.tar.zst
33 ```
34
27 35 Outputs:
28 36
29 37 | Artifact | Path |
30 38 |----------|------|
31 39 | Binary | `target/release/posprint` |
32 40 | Debian package | `target/debian/*.deb` |
41 | Arch package | `packaging/arch/posprint-*-x86_64.pkg.tar.zst` |
33 42
34 43 ### Linux targets we support
35 44
36 45 | Format | Distros | Notes |
37 46 |--------|---------|-------|
38 47 | **`.deb`** | Debian, Ubuntu, Mint, Pop!_OS, etc. | **Recommended** for apt-based systems; produced by `cargo-deb` |
48 | **`.pkg.tar.zst`** | Arch Linux, Manjaro, EndeavourOS, etc. | **Recommended** for pacman; `sudo pacman -U posprint-*.pkg.tar.zst` |
39 49 | **Raw binary** | Any x86_64 Linux | Copy `target/release/posprint`; needs X11/Wayland libs at runtime |
40 50 | **`.rpm`** | Fedora, RHEL, openSUSE | Not automated yet; build binary and wrap with `fpm` if needed |
41 51 | **AppImage** | Universal | Not automated yet; good for portable distribution |
@@ -55,6 +65,13 @@ For `.deb`:
55 65 cargo install cargo-deb --locked
56 66 ```
57 67
68 ### Arch Linux build dependencies
69
70 ```bash
71 sudo pacman -S --needed base-devel rust pkgconf openssl libxkbcommon libxcb dbus-libs \
72 wayland libx11 fontconfig freetype2 libglvnd git rsync
73 ```
74
58 75 ## Tests before release
59 76
60 77 ```bash
@@ -24,18 +24,28 @@ chmod +x scripts/build-linux.sh
24./scripts/build-linux.sh --deb # binary + .deb package
24./scripts/build-linux.sh --deb # binary + .deb package
25```
25```
26
26
27On **Arch Linux**:
28
29```bash
30chmod +x scripts/build-arch.sh
31./scripts/build-arch.sh # .pkg.tar.zst for pacman
32sudo pacman -U packaging/arch/posprint-*-x86_64.pkg.tar.zst
33```
34
27Outputs:
35Outputs:
28
36
29| Artifact | Path |
37| Artifact | Path |
30|----------|------|
38|----------|------|
31| Binary | `target/release/posprint` |
39| Binary | `target/release/posprint` |
32| Debian package | `target/debian/*.deb` |
40| Debian package | `target/debian/*.deb` |
41| Arch package | `packaging/arch/posprint-*-x86_64.pkg.tar.zst` |
33
42
34### Linux targets we support
43### Linux targets we support
35
44
36| Format | Distros | Notes |
45| Format | Distros | Notes |
37|--------|---------|-------|
46|--------|---------|-------|
38| **`.deb`** | Debian, Ubuntu, Mint, Pop!_OS, etc. | **Recommended** for apt-based systems; produced by `cargo-deb` |
47| **`.deb`** | Debian, Ubuntu, Mint, Pop!_OS, etc. | **Recommended** for apt-based systems; produced by `cargo-deb` |
48| **`.pkg.tar.zst`** | Arch Linux, Manjaro, EndeavourOS, etc. | **Recommended** for pacman; `sudo pacman -U posprint-*.pkg.tar.zst` |
39| **Raw binary** | Any x86_64 Linux | Copy `target/release/posprint`; needs X11/Wayland libs at runtime |
49| **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 |
50| **`.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 |
51| **AppImage** | Universal | Not automated yet; good for portable distribution |
@@ -55,6 +65,13 @@ For `.deb`:
55cargo install cargo-deb --locked
65cargo install cargo-deb --locked
56```
66```
57
67
68### Arch Linux build dependencies
69
70```bash
71sudo pacman -S --needed base-devel rust pkgconf openssl libxkbcommon libxcb dbus-libs \
72 wayland libx11 fontconfig freetype2 libglvnd git rsync
73```
74
58## Tests before release
75## Tests before release
59
76
60```bash
77```bash
packaging/arch/PKGBUILD added +49 −0
@@ -0,0 +1,49 @@
1 # Maintainer: posprint contributors
2 pkgname=posprint
3 pkgver=0.1.0
4 pkgrel=1
5 pkgdesc="Designer for POS-print documents with live preview and USB ESC/POS printing"
6 arch=('x86_64')
7 url="https://gitlab.com/Timfa/posprint"
8 license=('MIT')
9 depends=(
10 'gcc-libs'
11 'libxkbcommon'
12 'libxcb'
13 'openssl'
14 'dbus-libs'
15 'wayland'
16 'libx11'
17 'fontconfig'
18 'freetype2'
19 'libglvnd'
20 )
21 makedepends=('rust' 'cargo' 'pkgconf' 'git')
22 options=('!lto')
23 source=()
24 sha256sums=()
25
26 prepare() {
27 local root="$startdir/../.."
28 mkdir -p "$srcdir/$pkgname-$pkgver"
29 rsync -a \
30 --exclude target \
31 --exclude .git \
32 --exclude packaging/arch/pkg \
33 --exclude packaging/arch/src \
34 --exclude 'packaging/arch/*.pkg.tar.zst' \
35 --exclude 'packaging/arch/*.pkg.tar.zst.sig' \
36 "$root/" "$srcdir/$pkgname-$pkgver/"
37 }
38
39 build() {
40 cd "$srcdir/$pkgname-$pkgver"
41 cargo build --release --locked
42 }
43
44 package() {
45 cd "$srcdir/$pkgname-$pkgver"
46 install -Dm755 target/release/posprint "$pkgdir/usr/bin/posprint"
47 install -Dm644 LICENSE "$pkgdir/usr/share/licenses/$pkgname/LICENSE"
48 install -Dm644 README.md "$pkgdir/usr/share/doc/$pkgname/README.md"
49 }
@@ -0,0 +1,49 @@
1# Maintainer: posprint contributors
2pkgname=posprint
3pkgver=0.1.0
4pkgrel=1
5pkgdesc="Designer for POS-print documents with live preview and USB ESC/POS printing"
6arch=('x86_64')
7url="https://gitlab.com/Timfa/posprint"
8license=('MIT')
9depends=(
10 'gcc-libs'
11 'libxkbcommon'
12 'libxcb'
13 'openssl'
14 'dbus-libs'
15 'wayland'
16 'libx11'
17 'fontconfig'
18 'freetype2'
19 'libglvnd'
20)
21makedepends=('rust' 'cargo' 'pkgconf' 'git')
22options=('!lto')
23source=()
24sha256sums=()
25
26prepare() {
27 local root="$startdir/../.."
28 mkdir -p "$srcdir/$pkgname-$pkgver"
29 rsync -a \
30 --exclude target \
31 --exclude .git \
32 --exclude packaging/arch/pkg \
33 --exclude packaging/arch/src \
34 --exclude 'packaging/arch/*.pkg.tar.zst' \
35 --exclude 'packaging/arch/*.pkg.tar.zst.sig' \
36 "$root/" "$srcdir/$pkgname-$pkgver/"
37}
38
39build() {
40 cd "$srcdir/$pkgname-$pkgver"
41 cargo build --release --locked
42}
43
44package() {
45 cd "$srcdir/$pkgname-$pkgver"
46 install -Dm755 target/release/posprint "$pkgdir/usr/bin/posprint"
47 install -Dm644 LICENSE "$pkgdir/usr/share/licenses/$pkgname/LICENSE"
48 install -Dm644 README.md "$pkgdir/usr/share/doc/$pkgname/README.md"
49}
scripts/build-arch.sh added +45 −0
@@ -0,0 +1,45 @@
1 #!/usr/bin/env bash
2 # Build an Arch Linux pacman package (.pkg.tar.zst) for posprint.
3 set -euo pipefail
4
5 ROOT="$(cd "$(dirname "$0")/.." && pwd)"
6 cd "$ROOT"
7
8 BUILD_DEB=false
9 SKIP_TESTS=false
10 AS_ROOT=false
11
12 for arg in "$@"; do
13 case "$arg" in
14 --skip-tests) SKIP_TESTS=true ;;
15 --asroot) AS_ROOT=true ;;
16 -h|--help)
17 echo "Usage: $0 [--skip-tests] [--asroot]"
18 echo "Builds packaging/arch/posprint-<ver>-<rel>-x86_64.pkg.tar.zst"
19 exit 0
20 ;;
21 *) echo "Unknown option: $arg"; exit 1 ;;
22 esac
23 done
24
25 if ! command -v makepkg &>/dev/null; then
26 echo "makepkg not found. On Arch, install base-devel: sudo pacman -S base-devel"
27 exit 1
28 fi
29
30 if [[ "$SKIP_TESTS" != "true" ]]; then
31 cargo test
32 fi
33
34 PKGVER="$(grep '^version' Cargo.toml | head -1 | sed -E 's/.*"([^"]+)".*/\1/')"
35 sed -i "s/^pkgver=.*/pkgver=${PKGVER}/" packaging/arch/PKGBUILD
36
37 cd packaging/arch
38 MAKEPKG_FLAGS=(-f --noconfirm)
39 if [[ "$AS_ROOT" == "true" ]]; then
40 MAKEPKG_FLAGS+=(--asroot)
41 fi
42 makepkg "${MAKEPKG_FLAGS[@]}"
43
44 echo "Arch package:"
45 ls -lh posprint-"${PKGVER}"-*-x86_64.pkg.tar.zst
@@ -0,0 +1,45 @@
1#!/usr/bin/env bash
2# Build an Arch Linux pacman package (.pkg.tar.zst) for posprint.
3set -euo pipefail
4
5ROOT="$(cd "$(dirname "$0")/.." && pwd)"
6cd "$ROOT"
7
8BUILD_DEB=false
9SKIP_TESTS=false
10AS_ROOT=false
11
12for arg in "$@"; do
13 case "$arg" in
14 --skip-tests) SKIP_TESTS=true ;;
15 --asroot) AS_ROOT=true ;;
16 -h|--help)
17 echo "Usage: $0 [--skip-tests] [--asroot]"
18 echo "Builds packaging/arch/posprint-<ver>-<rel>-x86_64.pkg.tar.zst"
19 exit 0
20 ;;
21 *) echo "Unknown option: $arg"; exit 1 ;;
22 esac
23done
24
25if ! command -v makepkg &>/dev/null; then
26 echo "makepkg not found. On Arch, install base-devel: sudo pacman -S base-devel"
27 exit 1
28fi
29
30if [[ "$SKIP_TESTS" != "true" ]]; then
31 cargo test
32fi
33
34PKGVER="$(grep '^version' Cargo.toml | head -1 | sed -E 's/.*"([^"]+)".*/\1/')"
35sed -i "s/^pkgver=.*/pkgver=${PKGVER}/" packaging/arch/PKGBUILD
36
37cd packaging/arch
38MAKEPKG_FLAGS=(-f --noconfirm)
39if [[ "$AS_ROOT" == "true" ]]; then
40 MAKEPKG_FLAGS+=(--asroot)
41fi
42makepkg "${MAKEPKG_FLAGS[@]}"
43
44echo "Arch package:"
45ls -lh posprint-"${PKGVER}"-*-x86_64.pkg.tar.zst