Linux ships the same shape as Windows -- executable, backend/ and python/ side
by side -- so the updater generalises rather than needing a second design. The
platform-specific parts are now three small seams: the archive format, the
executable name, and one new gate.
Rust:
- widen the updater's cfg gates from `windows` to `any(windows, linux)`, and
replace extract_zip_archive with extract_update_archive, which uses zip on
Windows and the existing extract_tar_archive on Linux
- APP_EXE_NAME so the swap and the leftover sweep stop hardcoding StemDeck.exe
- stop_backend_and_wait now sends SIGTERM and waits before escalating on unix,
matching what stop_backend already does on window close
- new app_root_is_writable gate: packaging/linux/install.sh offers a global
install into /opt/stemdeck, which is root-owned while the app runs as the
user. check_app_update declines up front rather than failing part way through
a swap. Windows portable installs are user-writable by construction, but the
probe is cheap and honest on both.
tar rather than zip on Linux is deliberate: it preserves the executable bit. A
zip would land StemDeck without +x and the relaunch after an update would fail
with a permission error.
Packaging (scripts/linux/make-portable.sh):
- write python/runtime-version.json using the same uv.lock + interpreter
major.minor formula as the Windows script, so the compatibility gate behaves
identically on both
- bring the strip to parity: stdlib test/, per-package test/tests, a post-strip
import check, and a final __pycache__ sweep after the last interpreter run
- PUBLISH_UPDATER_ASSETS=1 emits the slim app-layer tarball, its checksum and
the runtime marker; wired into the CPU build in linux-release.yml since
StemDeck and backend/ are identical between both variants
Frontend: updaterAssetNames() maps the platform to its asset names, and the
wiring is gated on that rather than on os === "windows".
macOS is deliberately still excluded, and the comments now say why rather than
just that it is: backend_dir() resolves the backend inside the downloaded
runtime pack rather than the .app, so its app layer is a different thing and
the existing runtime-pack updater already covers most of it.
Verified: both platforms compile clean with no new clippy warnings, 42 tests on
Windows and 43 on Linux (the extra one is the read-only-root gate, which is
meaningless on Windows). The app-layer archive was round-tripped on Linux to
confirm it contains exactly StemDeck + backend/, that python/ does not leak
into it, that the executable bit survives, and that replacing a running binary
works. Not yet run end to end against a real Linux release.
Thales
8238eb02a7