bos/packaging/arch/README.md
Breadway c24202cff1
Some checks failed
Mirror to GitHub / mirror (push) Failing after 3s
Build and publish calamares / calamares (push) Failing after 3m2s
Build and release ISO / release-iso (push) Successful in 11m52s
Add touchpad workspace-swipe gestures, pacman/yay aliases, re-enable breadhelp package, fix identity URLs
2026-07-19 03:08:24 +08:00

39 lines
1.3 KiB
Markdown

Arch packaging
==============
`breadhelp/PKGBUILD` builds and installs `breadhelp` from source — BOS's
onboarding + help center, and the only first-party pacman package still built
from this repo.
`bos-settings` is also pacman-packaged and served from the same [breadway]
repo, but its source lives in its own repo now (`~/Projects/bos-settings`,
`git.breadway.dev/Breadway/bos-settings`) so a bos-settings release doesn't require
a BOS ISO release.
Everything else the bread ecosystem ships (breadbar, breadbox, breadpad, ...)
is bakery-managed, not pacman-packaged — see `build-local.sh`.
## Local build
```bash
cd breadhelp && makepkg -si
```
## Before publishing to [breadway] repo
CI (`.forgejo/workflows/package.yml`) handles this on tag push (`vX.Y.Z`): it
bumps `pkgver`, archives the repo into the expected tarball name, and runs
`makepkg`. To do it by hand instead:
1. Tag a release on GitHub (`vX.Y.Z`).
2. Update `pkgver` in `breadhelp/PKGBUILD` to match the tag.
3. Update `source` to the release tarball URL.
4. Run `updpkgsums` (or manually set `sha256sums`).
## Runtime dependencies
| Package | Required | Notes |
|---------|----------|-------|
| `gtk4` | yes | UI toolkit |
| `glib2` | yes | always |
| `snapper` | optional | create-backup one-click fix |