Oplossing voor Flatpak-apps die het GTK-thema niet respecteren in Ubuntu 24.04.

Beknopt overzicht: wat lost de mismatch meestal op?

Als een Flatpak-app op Ubuntu 24.04 opent met Adwaita of een lichte interface terwijl het bureaublad is ingesteld op donker, controleer dan eerst of de app GTK 3 of GTK 4/libadwaita gebruikt. Werk vervolgens Flatpak bij, zorg dat de bijbehorende GTK 3-thema-extensie beschikbaar is en controleer of de desktopportal is geïnstalleerd. Flatpak-apps draaien in een sandbox, waardoor ze niet automatisch alle themabestanden lezen die op de Ubuntu-host zijn geïnstalleerd.

Deze stappen zijn van toepassing op Flatpak-applicaties op Ubuntu 24.04, met name die geïnstalleerd zijn via Flathub. Ze dwingen niet elke applicatie om de volledige desktopstijl van Ubuntu te gebruiken. GTK 3-thema-extensies, de voorkeur voor licht/donker, pictogrammen en applicatiespecifieke stijlen zijn aparte onderdelen.

Hoe werkt thema-matching in Flatpak?

Een Flatpak-applicatie gebruikt zijn eigen runtime in plaats van de systeembibliotheken en themamappen van de host. Flatpak kan Ubuntu niet zomaar /usr/share/themesals themabron voor de applicatie beschikbaar stellen: de sandbox heeft zijn eigen runtime-bestandssysteem en thema's kunnen afhankelijk zijn van een specifieke GTK-versie. Flatpak distribueert daarom ondersteunde GTK 3-thema's als runtime-extensies.

Flatpak kan de naam van het actieve GTK-thema van de host uitlezen en een bijbehorende extensie installeren als deze beschikbaar is in de remote van de app. Het thema moet echter nog wel beschikbaar zijn voor de app. Op X11 kan GTK 3 het geselecteerde thema ontvangen via XSettings. Op Wayland leest GTK de relevante uiterlijke instellingen via een instellingenportaal op het bureaublad. Als de thema-extensie of een geschikte integratiemogelijkheid ontbreekt, kan een app terugvallen op Adwaita.

Het instellingenpaneel van Ubuntu 24.04 biedt een lichte en een donkere bureaubladstijl. Deze voorkeur is niet hetzelfde als ervoor zorgen dat elke applicatie het Yaru GTK 3-thema gebruikt. GTK 4-applicaties die met libadwaita zijn gebouwd, volgen over het algemeen de ondersteunde systeemvoorkeuren voor uiterlijk, maar ze accepteren niet per se willekeurige overschrijvingen van oudere GTK-thema's. Een Flatpak-thema-extensie die is vernoemd naar GTK 3 zal niet elke GTK 4- of libadwaita-app van een andere stijl voorzien.

Voor een technisch overzicht, zie de documentatie van Flatpak over desktopintegratie en theming, en de documentatie over GTK-portalondersteuning .

1. Bevestig de bureaubladstijl en de naam van het thema.

Open Instellingen > Uiterlijk en selecteer de gewenste Lichte of Donkere stijl. De keuze wordt direct toegepast op het bureaublad. Als u GNOME Tweaks of een ander programma gebruikt om een ​​aangepast GTK-thema te selecteren, noteer dan de exacte themanaam; pakketnamen en themanamen kunnen verschillen in hoofdletters of achtervoegsels.

Je kunt de naam van het actieve GTK-thema en de voorkeur voor het kleurenschema in de Terminal bekijken:

gsettings get org.gnome.desktop.interface gtk-theme
gsettings get org.gnome.desktop.interface color-scheme

De eerste opdracht geeft de themanaam weer die is opgeslagen in de GNOME-instellingen; de tweede geeft het voorkeursschema voor licht/donker weer, indien ondersteund. Deze opdrachten controleren alleen de waarden. Vermijd het instellen van een themanaam die is overgenomen uit een handleiding, tenzij dat thema is geïnstalleerd en u het wilt gebruiken. Start de betreffende app opnieuw op na het wijzigen van de uiterlijke instellingen, aangezien veel programma's hun thema bij het opstarten inlezen.

2. Werk Flatpak bij en installeer de bijbehorende thema-extensie.

Vernieuw eerst de geïnstalleerde applicaties en runtimes. De gedocumenteerde thema-integratie van Flatpak kan automatisch een bijpassende extensie installeren tijdens een installatie of update wanneer het thema beschikbaar is op de geconfigureerde externe server.

flatpak update

Als de app nog steeds het fallback-thema gebruikt, geef dan een lijst van de GTK-thema-extensies die door Flathub beschikbaar worden gesteld:

flatpak remote-ls --columns=application flathub | grep '^org.gtk.Gtk3theme'

Kies een extensie waarvan de naam overeenkomt met het GTK 3-thema dat je hebt geselecteerd. Flathub toont momenteel Yaru-themavarianten, waaronder org.gtk.Gtk3theme.Yaru-light. Installeer die variant bijvoorbeeld alleen als deze overeenkomt met het thema dat je wilt:

flatpak install flathub org.gtk.Gtk3theme.Yaru-light

De Yaru-light themalijst van Flathub identificeert het als een GTK-themapakket. De bijbehorende themanaam is afhankelijk van de hostinstellingen en van wat de remote momenteel publiceert. Als u een andere Yaru-variant of een thema van een derde partij gebruikt, raadpleeg flatpak searchdan de remote lijst om de exacte extensie-ID te vinden; ga er niet van uit dat het pakketachtervoegsel overeenkomt met de visuele naam.

Als het thema is geïnstalleerd maar de app al actief was, sluit dan alle vensters en open de app opnieuw. In het geval van een hardnekkig probleem, kunt u de update nogmaals uitvoeren nadat u hebt gecontroleerd of de extensie en de applicatie afkomstig zijn van dezelfde Flatpak-installatie.

flatpak list --app
flatpak list --runtime | grep -i theme
flatpak update

Flatpak maakt onderscheid tussen installaties per gebruiker en systeeminstallaties. Als je de app hebt geïnstalleerd met `app` --usermaar de extensie systeembreed hebt geïnstalleerd, of andersom, kan het zijn dat de app de extensie niet ziet waar verwacht. Zorg er indien mogelijk voor dat de app en de extensie zich in hetzelfde installatiebereik bevinden. Je kunt de installatie van een specifieke app bekijken met `app-install` flatpak info APP_ID.

3. Controleer de desktopportal op Ubuntu 24.04.

Volgens de documentatie van GTK's Flatpak-portaal xdg-desktop-portal-gtkis dit vereist voor GTK-thema's en -lettertypen. Ubuntu publiceert deze backend voor de Noble-release (24.04 LTS). Als het pakket ontbreekt, installeer het dan vanuit de Ubuntu-repository's:

sudo apt update
sudo apt install xdg-desktop-portal-gtk

Ubuntu GNOME gebruikt ook de GNOME-portalbackend voor desktopspecifieke portalfuncties. Het installeren van de GTK-backend betekent niet dat u de GNOME-backend moet verwijderen of vervangen. Behoud de portalpakketten die voor uw desktopomgeving beschikbaar zijn. Na de installatie kunt u zich afmelden en opnieuw aanmelden, of de gebruikersportalservice opnieuw starten en vervolgens de betreffende app opnieuw opstarten.

systemctl --user restart xdg-desktop-portal.service

Als systemd meldt dat de unit niet beschikbaar is, meld u dan af en weer aan. De activeringsdetails van de portal kunnen variëren afhankelijk van de sessie en de pakketstatus. De pakketlijst van Ubuntu bevestigt dat xdg-desktop-portal-gtk beschikbaar is voor Ubuntu 24.04 .

4. Bepaal of de app het thema kan gebruiken.

Test indien mogelijk meer dan één GTK 3 Flatpak. Als meerdere GTK 3-apps het thema nu wel volgen, maar één app niet, dan ligt het probleem mogelijk bij die app of de runtime ervan. Als GTK 3-apps wel werken, maar een moderne GNOME-app nog steeds een andere accentkleur of widgetweergave heeft, is dat te verwachten: GTK 3-thema-extensies werken niet op dezelfde manier voor GTK 4/libadwaita.

Sommige apps gebruiken Qt, Electron of hun eigen interface-toolkit, zelfs als ze er vergelijkbaar uitzien met GNOME-applicaties. In dat geval heeft een GTK-thema-extensie mogelijk geen effect. Controleer de officiële documentatie van de app voor ondersteunde weergaveopties voordat u Flatpak-machtigingen wijzigt. Voor een Flatpak die is geïnstalleerd via Flathub, kunt u de app-ID en runtime inspecteren met:

flatpak info APP_ID

Vervang dit APP_IDdoor de applicatie-ID die wordt weergegeven door flatpak list --app. De uitvoer helpt bij het identificeren van de runtime en de installatieomvang; het geeft niet altijd de toolkit weer, dus controleer de toolkit indien nodig in de documentatie of op de projectpagina van de app zelf.

Veelvoorkomende oplossingen om te vermijden

• Geef geen brede toegang tot het bestandssysteem van de host alleen om de look te kopiëren. Flatpak beschrijft thema-extensies en integratie met portals/XSettings als de gebruikelijke aanpak. Brede toegang verzwakt de sandbox-isolatie en kan nog steeds mislukken als de GTK-versies van de host en de runtime verschillen.
• Gebruik een GTK 3-thema-extensie niet als universele schakelaar voor de donkere modus. Deze bevat themabestanden voor compatibele GTK 3-apps; ondersteuning voor het systeemkleurenschema is een aparte instelling die de app en het portaal moeten begrijpen.
• Installeer de applicatie niet opnieuw voordat u de extensie en runtime hebt gecontroleerd. Bij herinstallatie kan dezelfde runtime worden opgehaald zonder dat het ontbrekende thema of de portalconditie wordt gecorrigeerd.
• Wijzig niet als eerste stap de algemene portalconfiguratie. De backend-selectie van Ubuntu GNOME is sessiespecifiek. Het vervangen van portalvoorkeuren kan gevolgen hebben voor bestandsselectoren en andere desktopintegratie, naast de thema-instellingen.

Controlelijst voor verificatie

• In de Ubuntu-instellingen wordt de gewenste lichte of donkere stijl weergegeven.
• De naam van het GTK-thema van de host is bekend en er is een bijbehorende GTK 3-extensie beschikbaar voor Flatpak.
• flatpak updateDe installatie is voltooid en de app en thema-extensie bevinden zich in een compatibel installatiegebied.
• Het xdg-desktop-portal-gtkpakket is geïnstalleerd; na de wijzigingen is de gebruikerssessie of het portaal opnieuw opgestart.
• De betreffende applicatie is volledig afgesloten en vervolgens weer heropend.
• Je hebt apps vergeleken op basis van de toolkit: GTK 3, GTK 4/libadwaita, Qt of Electron kunnen verschillend reageren.

Als de checklist is doorlopen en één app ongewijzigd blijft, is de meest nuttige volgende stap om de probleemtracker of documentatie van die applicatie te raadplegen met de Flatpak-ID, runtime, Ubuntu-sessietype (Wayland of X11) en de uitvoer van de twee alleen-lezen gsettingscommando's. Dit helpt om een ​​app-specifieke stijlkeuze te onderscheiden van een ontbrekende desktopintegratiecomponent zonder de sandbox te verzwakken.

In de huidige gebruikershandleiding van Ubuntu worden de licht/donker-instellingen beschreven in Instellingen > Uiterlijk . Het gedrag van Flatpak kan variëren afhankelijk van de versie, de runtime van de app, de portal-backend, de toolkit en de externe metadata; als het actieve thema niet is meegeleverd met de runtime, kan de app zijn eigen standaardweergave blijven gebruiken.