mirror of
https://github.com/Droid-Deck/DroidDeck.git
synced 2026-11-20 05:16:01 +00:00
Match the native builder and desktop package override to Arch Linux ARM KWin 6.8.0, pin the official source hash, and port the nested-scaling patch. Check package/source version consistency in both build jobs. Official source checksum, patch application, live package closure, and shell syntax verified. The published desktop remains pinned to r2; candidate 6.8 device/rendering validation remains pending before any package publication.
63 lines
4.7 KiB
Markdown
63 lines
4.7 KiB
Markdown
# The desktop package (KDE Plasma)
|
|
|
|
The desktop the app installs into its Linux runtime the first time the desktop is opened: KDE Plasma
|
|
set up as SteamOS's desktop mode, with Valve's Vapor theme, the Steam Deck wallpaper and launcher
|
|
icon, Plasma's default bottom panel, and "Return to Gaming Mode" and Steam on the desktop.
|
|
|
|
- `seeds.txt`: the packages asked for. `build.sh` takes their closure over Arch Linux ARM's
|
|
repositories (`closure.py`) and drops what the runtime already has.
|
|
- `runtime-packages.txt`: the runtime's own packages, `name version` from its pacman database
|
|
(`ls /var/lib/pacman/local` in the rootfs). Refresh it when the runtime is rebuilt.
|
|
- `overlay/`: our files on top - system-wide KDE defaults in `/etc/xdg`, the Vapor theme and its
|
|
layout script, the menu entries Steam and Return to Gaming Mode use.
|
|
|
|
`.github/workflows/build-desktop-kde.yml` builds it and, run with a new tag, publishes it as a
|
|
release in Droid-Deck/DroidDeck-Components. `release.env` pins the tag, sha256 and size the apk
|
|
installs (`DesktopCatalog.desktopEntry`); a published tag is never replaced, so a changed package
|
|
is a new tag and a `release.env` update.
|
|
|
|
At run time the desktop is started by `tools/linuxfs/desktop/droiddeck-desktop` (the app stages it
|
|
at every session): Plasma's own `startplasma-wayland`, with KWin nested in the app's compositor
|
|
through `kwin_wayland_wrapper`. KWin composites in software (QPainter) - the Adreno node is not a
|
|
DRM device - so games and emulators from the menu go through `droiddeck-gpu`, and Steam goes back
|
|
to the app as a Steam session.
|
|
|
|
`kwin.env` pins the KWin version shared by the build and packaging jobs. `build-kwin.sh` builds that version's
|
|
Wayland executable and library on a native ARM64 runner, using a disposable
|
|
Arch Linux ARM chroot with every build package signature-checked. It matches the current KWin package
|
|
in Arch Linux ARM even when that repository trails KDE's latest release. The source tarball is pinned
|
|
by SHA-256 from KDE's official source inventory; `patches/0001-respect-nested-desktop-scale.patch`
|
|
lets Display Settings control the inner desktop scale independently of the outer window size.
|
|
It keeps layer sizes, pointer/touch coordinates and the cursor in the same physical pixels.
|
|
The behavior is enabled only with `DROIDDECK_NESTED_SCALE`, which the desktop script supplies.
|
|
|
|
The desktop workflow replaces the same-version `kwin_wayland` executable and `libkwin.so`; the rest
|
|
comes from the signature-checked Arch packages. `desktop-kde.kwin.txt` records the source, patch,
|
|
executable, library and build package hashes. Corresponding source is
|
|
https://download.kde.org/stable/plasma/6.8.0/kwin-6.8.0.tar.xz plus the patch in this repository.
|
|
|
|
The inventories use `.gzip` rather than `.gz`: Android's asset packer expands `.gz` and strips
|
|
its suffix. The shared local/CI runtime payload check verifies the exact APK names and bytes.
|
|
|
|
Desktop removal uses `app/src/main/assets/desktop-removal/`, generated by `removal-manifests.py`
|
|
from the checksum-pinned LXQt r1, KDE r1/r2 and emulator r1 archives. KDE candidates are the files
|
|
of the desktop applications/themes in `seeds.txt` (their source package hashes verified against
|
|
`desktop-kde.packages.txt`) plus our overlay. Shared dependencies, fonts, Xwayland and Qt Wayland
|
|
remain available to Steam, native apps and emulators. Regenerate the inventories and add the new
|
|
version to `versions.txt` when publishing another desktop pin; unknown versions cannot be removed.
|
|
|
|
Removal checks file size and SHA-256, or the exact symlink target, before unlinking. Base-runtime
|
|
pacman files and emulator bundle paths are protected even when they overlap an application.
|
|
It never follows parent symlinks or recursively deletes directories. Home, added apps, custom
|
|
files and modified package files stay. A pending marker disables the installed state and allows
|
|
retry after interruption. Installing the desktop again repairs its package files and clears it.
|
|
The old LXQt applications are cleaned after KDE installation and before the next guest launch on
|
|
an already-upgraded runtime, protecting both KDE inventories as well as the runtime and emulators.
|
|
Only files owned by `lxqt-applications.txt`'s application packages are candidates; dependencies
|
|
stay even when the old runtime's pacman database does not record them. In particular, gamescope
|
|
still needs the old package's libseat. The source LXQt application archives are the versions in
|
|
the published `steamdeck-desktop-r1/desktop.packages.txt`; verify their `.sig` files with
|
|
`gpgv --keyring tools/desktop-kde/archlinuxarm-builder.gpg` and the Build System fingerprint used
|
|
by `build.sh`. Put their filenames in `selected.txt` in the LXQt cache. `sources.json` records
|
|
their SHA-256 values; file identities still come from the checksum-pinned published desktop.
|