From 9a00773bbdeb3ae468e5393675c8132ea95fcf3b Mon Sep 17 00:00:00 2001 From: Davide Cavalca Date: Mar 25 2025 15:12:26 +0000 Subject: deviations: document GNOME Software issues --- diff --git a/modules/ROOT/pages/deviations.adoc b/modules/ROOT/pages/deviations.adoc index 72d9399..bdcef1e 100644 --- a/modules/ROOT/pages/deviations.adoc +++ b/modules/ROOT/pages/deviations.adoc @@ -68,3 +68,7 @@ Fedora Asahi Remix uses btrfs for all of the deliverables. This matches what Fed === OpenH264 is automatically installed on first-boot Fedora Asahi Remix automatically installs openh264 on the first boot, enabling playback of H.264-encoded content out of the box. This is possible because of the two-step install process -- the Asahi Installer downloads the necessary packages from Cisco's server and makes them available to the deployed system to the perform the installation via a one-off systemd service. + +=== GNOME Software does not support updates between major releases + +Fedora Asahi Remix provides AppStream metadata that is required to support updates between major releases via PackageKit via `fedora-asahi-remix-appstream-metadata` (https://pagure.io/fedora-asahi/fedora-asahi-remix-appstream-metadata[source], https://copr.fedorainfracloud.org/coprs/g/asahi/fedora-remix-branding/[copr]). However, GNOME Software does not currently support reading this metadata, so it will not present major release updates for Fedora Asahi Remix with GNOME to the user. Instead, one needs to use the DNF https://docs.fedoraproject.org/en-US/quick-docs/upgrading-fedora-offline/[System Upgrade] plugin to perform the update. It is possible to support this properly in GNOME Software by implementing a https://gitlab.gnome.org/GNOME/gnome-software/-/tree/main/plugins[plugin] to consume the AppStream metadata, akin to what https://invent.kde.org/plasma/discover/-/tree/master/libdiscover/appstream[KDE Discover] does.