feat(packaging): add self-contained AppImage build (x86_64 + aarch64) (#573)
* feat(packaging): add self-contained AppImage build Bundles the wheel plus PyGObject/GTK3/AppIndicator/IBus typelibs into a relocatable x86_64 AppImage via linuxdeploy + linuxdeploy-plugin-gtk, so users get a zero-install, no-sandbox-negotiation alternative alongside AUR/PyPI. Wired into nightly and tagged releases, plus a smoke-test job in the PR pipeline since AppImage/ELF bundling can't be verified on a macOS dev machine. * feat(packaging): add aarch64 AppImage builds Parameterizes build.sh on uname -m instead of hardcoding x86_64 (both linuxdeploy and appimagetool publish aarch64 continuous builds, and pywhispercpp ships manylinux_aarch64 wheels, so no from-source compile needed). Adds an arch matrix to the PR smoke-test job, and a second job in nightly.yml/release.yml that builds on GitHub's free ubuntu-24.04-arm hosted runner and attaches the aarch64 AppImage to the same release the x86_64 job already created.
This commit is contained in:
Jatin K Malik
Executable
+98
@@ -0,0 +1,98 @@
|
||||
#!/usr/bin/env bash
|
||||
# Build a relocatable AppImage for Vocalinux, natively for whichever
|
||||
# architecture this script runs on (x86_64 or aarch64) - no cross-compiling.
|
||||
#
|
||||
# Usage: build.sh <path-to-wheel> <version> [output-dir]
|
||||
#
|
||||
# Bundles a full copy of the active Python interpreter (relocated via
|
||||
# PYTHONHOME, not a venv, since venvs hard-code absolute paths) plus
|
||||
# PyGObject/GTK3/AppIndicator/IBus GObject-Introspection typelibs, since
|
||||
# those are needed by `gi.repository` at runtime and linuxdeploy-plugin-gtk
|
||||
# does not bundle them (it targets native C GTK apps, which don't need
|
||||
# introspection data).
|
||||
#
|
||||
# ponytail: text-injection CLI tools (xdotool/wtype/ydotool) are not
|
||||
# bundled, same runtime prerequisite as the PyPI install path documented
|
||||
# in docs/INSTALL.md. Add bundling if users hit missing-binary complaints.
|
||||
set -euo pipefail
|
||||
|
||||
WHEEL="$1"
|
||||
VERSION="$2"
|
||||
OUTDIR="${3:-dist}"
|
||||
REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
|
||||
ARCH="$(uname -m)"
|
||||
|
||||
case "$ARCH" in
|
||||
x86_64|aarch64) ;;
|
||||
*) echo "Unsupported architecture: $ARCH (need x86_64 or aarch64)" >&2; exit 1 ;;
|
||||
esac
|
||||
|
||||
WORKDIR="$(mktemp -d)"
|
||||
trap 'rm -rf "$WORKDIR"' EXIT
|
||||
APPDIR="$WORKDIR/AppDir"
|
||||
TOOLDIR="$WORKDIR/tools"
|
||||
mkdir -p "$APPDIR/usr/bin" "$APPDIR/usr/lib" "$TOOLDIR" "$OUTDIR"
|
||||
|
||||
echo "== Fetching AppImage tooling ($ARCH) =="
|
||||
curl -fsSL -o "$TOOLDIR/linuxdeploy" \
|
||||
"https://github.com/linuxdeploy/linuxdeploy/releases/download/continuous/linuxdeploy-${ARCH}.AppImage"
|
||||
curl -fsSL -o "$TOOLDIR/linuxdeploy-plugin-gtk.sh" \
|
||||
https://raw.githubusercontent.com/linuxdeploy/linuxdeploy-plugin-gtk/master/linuxdeploy-plugin-gtk.sh
|
||||
curl -fsSL -o "$TOOLDIR/appimagetool" \
|
||||
"https://github.com/AppImage/appimagetool/releases/download/continuous/appimagetool-${ARCH}.AppImage"
|
||||
chmod +x "$TOOLDIR/linuxdeploy" "$TOOLDIR/linuxdeploy-plugin-gtk.sh" "$TOOLDIR/appimagetool"
|
||||
|
||||
echo "== Bundling Python runtime =="
|
||||
PY_PREFIX="$(python3 -c 'import sys; print(sys.prefix)')"
|
||||
PY_VER="$(python3 -c 'import sys; print("%d.%d" % sys.version_info[:2])')"
|
||||
cp -L "$(command -v python3)" "$APPDIR/usr/bin/python3"
|
||||
cp -r "$PY_PREFIX/lib/python${PY_VER}" "$APPDIR/usr/lib/python${PY_VER}"
|
||||
rm -rf "$APPDIR/usr/lib/python${PY_VER}/site-packages"
|
||||
|
||||
echo "== Installing Vocalinux + PyGObject into the bundle =="
|
||||
python3 -m pip install --no-cache-dir --prefix "$APPDIR/usr" "$WHEEL" PyGObject pycairo
|
||||
|
||||
echo "== Adding desktop entry + icon =="
|
||||
install -Dm644 "$REPO_ROOT/vocalinux.desktop" "$APPDIR/usr/share/applications/vocalinux.desktop"
|
||||
install -Dm644 "$REPO_ROOT/resources/icons/scalable/vocalinux.svg" \
|
||||
"$APPDIR/usr/share/icons/hicolor/scalable/apps/vocalinux.svg"
|
||||
|
||||
echo "== Copying GObject-Introspection typelibs (not handled by linuxdeploy-plugin-gtk) =="
|
||||
mkdir -p "$APPDIR/usr/lib/girepository-1.0"
|
||||
for typelib in Gtk-3.0 Gdk-3.0 GdkX11-3.0 GdkPixbuf-2.0 GLib-2.0 GObject-2.0 Gio-2.0 \
|
||||
Pango-1.0 PangoCairo-1.0 cairo-1.0 HarfBuzz-0.0 Atk-1.0 freetype2-2.0 \
|
||||
AppIndicator3-0.1 AyatanaAppIndicator3-0.1 Notify-0.7 IBus-1.0; do
|
||||
found="$(find /usr/lib -name "${typelib}.typelib" 2>/dev/null | head -1)"
|
||||
if [ -n "$found" ]; then
|
||||
cp "$found" "$APPDIR/usr/lib/girepository-1.0/"
|
||||
fi
|
||||
done
|
||||
|
||||
echo "== Writing AppRun =="
|
||||
cat > "$APPDIR/AppRun" << 'APPRUN'
|
||||
#!/usr/bin/env bash
|
||||
HERE="$(dirname "$(readlink -f "${0}")")"
|
||||
export PYTHONHOME="$HERE/usr"
|
||||
export PYTHONPATH="$HERE/usr/lib/python3:$HERE/usr/lib/python3/site-packages"
|
||||
export GI_TYPELIB_PATH="$HERE/usr/lib/girepository-1.0"
|
||||
export LD_LIBRARY_PATH="$HERE/usr/lib:${LD_LIBRARY_PATH:-}"
|
||||
export XDG_DATA_DIRS="$HERE/usr/share:${XDG_DATA_DIRS:-/usr/share}"
|
||||
exec "$HERE/usr/bin/python3" -m vocalinux.main "$@"
|
||||
APPRUN
|
||||
# PYTHONPATH above uses a version-agnostic symlink so AppRun doesn't need
|
||||
# to know the exact interpreter minor version at runtime.
|
||||
ln -s "python${PY_VER}" "$APPDIR/usr/lib/python3"
|
||||
chmod +x "$APPDIR/AppRun"
|
||||
|
||||
echo "== Running linuxdeploy (resolves the shared-library closure + GTK theming) =="
|
||||
export DEPLOY_GTK_VERSION=3
|
||||
"$TOOLDIR/linuxdeploy" --appdir "$APPDIR" \
|
||||
--plugin gtk \
|
||||
-e "$APPDIR/usr/bin/python3" \
|
||||
-d "$APPDIR/usr/share/applications/vocalinux.desktop" \
|
||||
-i "$APPDIR/usr/share/icons/hicolor/scalable/apps/vocalinux.svg"
|
||||
|
||||
echo "== Packaging AppImage =="
|
||||
OUTPUT="$OUTDIR/Vocalinux-${VERSION}-${ARCH}.AppImage"
|
||||
ARCH="$ARCH" "$TOOLDIR/appimagetool" "$APPDIR" "$OUTPUT"
|
||||
echo "Built $OUTPUT"
|
||||
Reference in New Issue
Block a user