Files
php-qml/.gitea/workflows/release.yml
magdev fddb70f877 Phase 4a sub-commit 4: AppImageUpdate sidecar + appcast + checkForUpdates()
Wires in the option-(a) sidecar approach: the AppImage carries a
bundled AppImageUpdate AppImage and an embedded update-info string
in the .upd_info ELF section. BackendConnection drives both the
check and the apply via QProcess.

BackendConnection:
  - Q_INVOKABLE checkForUpdates()
        Bundled mode only. Spawns AppImageUpdate.AppImage with
        --check-for-update <APPIMAGE>. Exits 0 → noUpdatesAvailable,
        1 → updatesAvailable, anything else → updateCheckFailed.
        Dev mode: emits updateCheckFailed("…dev-mode only").
  - Q_INVOKABLE applyUpdate()
        Bundled mode only. Spawns AppImageUpdate.AppImage with
        --remove-old <APPIMAGE>. Replaces the running AppImage in
        place; user must restart. Emits updateApplied or
        updateApplyFailed.
  - Sidecar path resolves to applicationDirPath()/AppImageUpdate.AppImage
    by default, overridable via BRIDGE_APPIMAGEUPDATE_BIN.
  - APPIMAGE env (set by the AppImage runtime) determines the target
    file. Outside an AppImage both methods fail loudly.

build-appimage.sh:
  - Auto-downloads AppImageUpdate-x86_64.AppImage into the cached
    tools dir and copies it into AppDir/usr/bin/AppImageUpdate.AppImage.
  - New --update-info flag, forwarded to appimagetool's -u so the
    .upd_info ELF section carries an "zsync|<URL>" string the sidecar
    will fetch.

examples/todo Makefile forwards APPIMAGE_UPDATE_INFO env to the
script as --update-info.

release.yml:
  - Builds the AppImage with APPIMAGE_UPDATE_INFO set to the canonical
    Gitea Releases asset URL for this tag.
  - Installs zsync, runs zsyncmake to generate Todo-x86_64.AppImage.zsync.
  - Generates a JSON appcast (latest.json) with version / url / sha256 /
    size / zsync URL / released_at — useful as an HTTP-fetchable
    fallback for clients that prefer a structured manifest.
  - SHA256SUMS now covers AppImage + zsync + latest.json.
  - Uploads all four assets to the Gitea Release.

AppImage size grows from ~104 MB to ~152 MB with the sidecar bundled.
Embedding verified: objdump shows .upd_info populated with the
expected zsync URL after a local build.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-02 19:58:02 +02:00

153 lines
5.3 KiB
YAML

name: Release
on:
push:
tags:
- 'v*'
jobs:
linux:
name: Linux AppImage
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v4
with:
fetch-depth: 0 # need tag history for release notes
- name: Setup PHP
uses: shivammathur/setup-php@v2
with:
php-version: '8.4'
extensions: curl, json, mbstring
tools: composer:v2
coverage: none
- name: Install bundle dependencies
working-directory: framework/php
run: composer install --no-interaction --prefer-dist
- name: Setup Qt 6
uses: jurplel/install-qt-action@v4
with:
version: '6.5.*'
modules: 'qtquickcontrols2'
cache: true
- name: Install FrankenPHP
run: |
curl -fsSL -o /usr/local/bin/frankenphp \
https://github.com/php/frankenphp/releases/download/v1.12.2/frankenphp-linux-x86_64
chmod +x /usr/local/bin/frankenphp
- name: Build the todo example
working-directory: examples/todo
run: |
make install
make build
- name: Build AppImage (with embedded update-info)
working-directory: examples/todo
env:
APPIMAGE_EXTRACT_AND_RUN: '1'
FRANKENPHP: /usr/local/bin/frankenphp
# AppImageUpdate sidecar will fetch this .zsync URL; it must
# point at the asset we're about to upload to this Release.
APPIMAGE_UPDATE_INFO: |
zsync|${{ github.server_url }}/${{ github.repository }}/releases/download/${{ github.ref_name }}/Todo-x86_64.AppImage.zsync
run: make appimage
- name: Generate zsync metadata
working-directory: examples/todo/build
run: |
sudo apt-get update -qq
sudo apt-get install -y zsync
zsyncmake Todo-x86_64.AppImage -u Todo-x86_64.AppImage
- name: Generate latest.json appcast
working-directory: examples/todo/build
env:
TAG: ${{ github.ref_name }}
run: |
SIZE=$(stat -c %s Todo-x86_64.AppImage)
SHA=$(sha256sum Todo-x86_64.AppImage | awk '{print $1}')
URL_BASE="${{ github.server_url }}/${{ github.repository }}/releases/download/${TAG}"
jq -n \
--arg version "$TAG" \
--arg url "$URL_BASE/Todo-x86_64.AppImage" \
--arg sha256 "$SHA" \
--arg zsync "$URL_BASE/Todo-x86_64.AppImage.zsync" \
--argjson size "$SIZE" \
--arg released "$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
'{version:$version, released_at:$released, appimage:{url:$url, sha256:$sha256, size:$size, zsync:$zsync}}' \
> latest.json
cat latest.json
- name: Compute SHA256SUMS
working-directory: examples/todo/build
run: |
sha256sum Todo-x86_64.AppImage Todo-x86_64.AppImage.zsync latest.json \
> SHA256SUMS
cat SHA256SUMS
- name: Import GPG signing key
if: ${{ env.GPG_KEY != '' }}
env:
GPG_KEY: ${{ secrets.GPG_KEY }}
GPG_PASSPHRASE: ${{ secrets.GPG_PASSPHRASE }}
run: |
echo "$GPG_KEY" | gpg --batch --import
# Default key id from the imported keyring (first secret key).
KEYID=$(gpg --list-secret-keys --with-colons | awk -F: '/^sec/ {print $5; exit}')
echo "GPG_KEYID=$KEYID" >> "$GITHUB_ENV"
- name: Sign SHA256SUMS
if: ${{ env.GPG_KEYID != '' }}
working-directory: examples/todo/build
env:
GPG_PASSPHRASE: ${{ secrets.GPG_PASSPHRASE }}
run: |
gpg --batch --pinentry-mode loopback \
--passphrase "$GPG_PASSPHRASE" \
--local-user "$GPG_KEYID" \
--detach-sign --armor \
-o SHA256SUMS.asc \
SHA256SUMS
- name: Create Gitea Release and upload artefacts
env:
GITEA_TOKEN: ${{ secrets.GITEA_TOKEN }}
REPO: ${{ github.repository }}
TAG: ${{ github.ref_name }}
working-directory: examples/todo/build
run: |
set -euo pipefail
api="${GITHUB_SERVER_URL}/api/v1"
# Create the release (or get the existing one for this tag)
release_json=$(curl -fsSL -X POST "$api/repos/$REPO/releases" \
-H "Authorization: token $GITEA_TOKEN" \
-H 'Content-Type: application/json' \
-d "$(jq -n --arg tag "$TAG" --arg name "$TAG" \
'{tag_name:$tag,name:$name,draft:false,prerelease:false}')" \
|| curl -fsSL "$api/repos/$REPO/releases/tags/$TAG" \
-H "Authorization: token $GITEA_TOKEN")
rid=$(echo "$release_json" | jq -r .id)
echo "Release id: $rid"
upload() {
local f="$1"
echo " uploading $f"
curl -fsSL -X POST \
"$api/repos/$REPO/releases/$rid/assets?name=$(basename "$f")" \
-H "Authorization: token $GITEA_TOKEN" \
-H 'Content-Type: application/octet-stream' \
--data-binary "@$f"
}
upload Todo-x86_64.AppImage
upload Todo-x86_64.AppImage.zsync
upload latest.json
upload SHA256SUMS
[ -f SHA256SUMS.asc ] && upload SHA256SUMS.asc || true