Build Linux and macOS clients with platform update feeds

This commit is contained in:
2026-11-08 16:45:42 +00:00
parent b7f439a94f
commit 36f73bb89d
17 changed files with 913 additions and 9 deletions
+34
View File
@@ -154,6 +154,40 @@ signed with the key in `~/.config/pipelines/android/` (seeded from
`~/.android/debug.keystore` if present), so each build installs over the last.
Options: `--server-url ws(s)://host:port/connect`, `--notes TEXT`, `--prefix`.
### Desktop clients
```sh
./install --linux --output ./dist
./install --macos --flutter /path/to/flutter --output ./dist
# Offer this desktop build through an installed server's update feed:
./install --linux --publish --notes "Release notes"
./install --macos --flutter /path/to/flutter --publish
```
Linux builds use Docker on Linux or macOS and target **Linux x64**. Extract the
entire `pipelines-linux-x64.tar.gz` archive and run `pipelines-linux-x64/pipelines-app`;
keep its `lib/` and `data/` siblings together. The executable has a distinct name
from the `pipelines` server CLI. The target Linux desktop needs GTK 3 and its
runtime libraries (Debian/Ubuntu: `libgtk-3-0`, `libstdc++6`, `liblzma5`). This is a
portable bundle, not a package-manager installation or a server installation.
macOS 12 or newer is required. macOS builds run natively with Xcode and the pinned Flutter version from
`app/.flutter-version`; they do not require Docker. The build targets the build
machine's architecture and records the actual executable architecture in the
feed. Unzip `Pipelines-macos.zip` and open `Pipelines.app`; move it to Applications
if desired. Local builds are not Developer ID notarized distribution packages.
Framework symlinks and executable permissions are preserved in the archive.
Both commands build in isolated source copies/containers, retain cached releases,
and do not install, launch or restart the server. `--server-url` optionally sets
the first server address; otherwise choose it in the app. `--output` copies the
archive to a chosen directory. `--publish` additionally requires an existing
installation (`--prefix` supported), copies a versioned archive into its update
directory, then atomically updates `/updates/linux-x64/version.json` or
`/updates/macos/version.json`. Feeds include platform, actual architectures,
version, SHA-256, and release notes. Android's existing feed remains separate.
Previously published archives remain available for downloads already in progress.
`./install --docker` is the optional Compose installation with its own
container harness credentials; see [Docker](docker.md). Do not run it
alongside a native install on the same ports. Its harnesses are set up with