Correction d'un problème de non-respect du thème GTK par les applications Flatpak sous Ubuntu 24.04

Référence rapide : ce qui corrige généralement le problème d’incompatibilité

Si une application Flatpak s'ouvre avec Adwaita ou une interface claire sur Ubuntu 24.04 alors que le bureau est en mode sombre, vérifiez d'abord si l'application utilise GTK 3 ou GTK 4/libadwaita. Mettez ensuite Flatpak à jour, activez l'extension de thème GTK 3 correspondante et assurez-vous que le portail de bureau est installé. Les applications Flatpak s'exécutent dans un environnement isolé (sandbox) et ne lisent donc pas automatiquement tous les fichiers de thème installés sur le système Ubuntu.

Ces étapes concernent les applications Flatpak sous Ubuntu 24.04, notamment celles installées depuis Flathub. Elles n'imposent pas l'utilisation de l'interface graphique complète d'Ubuntu. Les extensions de thème GTK 3, le choix du mode clair/sombre, les icônes et les styles spécifiques à chaque application sont des éléments distincts.

Comment fonctionne la correspondance des thèmes Flatpak

Une application Flatpak utilise son propre environnement d'exécution plutôt que les bibliothèques système et les répertoires de thèmes du système hôte. Flatpak ne peut pas simplement exposer Ubuntu /usr/share/themescomme source de thèmes : le bac à sable possède son propre système de fichiers d'exécution, et les thèmes peuvent dépendre d'une version spécifique de GTK. Flatpak distribue donc les thèmes GTK 3 compatibles sous forme d'extensions d'exécution.

Flatpak peut lire le nom du thème GTK actif de l'hôte et installer une extension correspondante si elle est disponible dans le dépôt distant de l'application. Le thème doit néanmoins être exposé à l'application. Sous X11, GTK 3 peut recevoir le thème sélectionné via XSettings. Sous Wayland, GTK lit les paramètres d'apparence pertinents via le portail Paramètres du bureau. Si l'extension de thème ou un chemin d'intégration approprié est manquant, l'application peut utiliser Adwaita par défaut.

Le panneau de configuration d'Ubuntu 24.04 propose des styles de bureau clair et sombre. Ce choix est différent de l'utilisation du thème Yaru GTK 3 par toutes les applications. Les applications GTK 4 compilées avec libadwaita respectent généralement les préférences d'apparence du système, mais n'acceptent pas nécessairement les anciens thèmes GTK personnalisés. Une extension de thème Flatpak nommée GTK 3 ne modifiera pas l'apparence de toutes les applications GTK 4 ou libadwaita.

Pour une présentation technique, consultez la documentation sur l'intégration et la personnalisation des thèmes de Flatpak pour ordinateur et sa documentation sur la prise en charge du portail GTK .

1. Confirmez le style et le nom du thème du bureau

Ouvrez Paramètres > Apparence et sélectionnez le style Clair ou Sombre souhaité. Votre choix s'appliquera immédiatement au bureau. Si vous utilisez GNOME Tweaks ou un autre outil pour sélectionner un thème GTK personnalisé, notez son nom exact ; les noms de paquets et les noms de thèmes peuvent différer par la casse ou les suffixes.

Vous pouvez lire le nom du thème GTK actif et la préférence de schéma de couleurs dans le Terminal :

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

La première commande affiche le nom du thème enregistré dans les paramètres GNOME ; la seconde affiche le schéma clair/sombre préféré, le cas échéant. Ces commandes ne font que vérifier les valeurs. Évitez de définir un nom de thème copié d'un tutoriel, sauf si ce thème est installé et que vous comptez l'utiliser. Redémarrez l'application concernée après avoir modifié les paramètres d'apparence, car de nombreux programmes lisent leur thème au lancement.

2. Mettez à jour Flatpak et installez l'extension de thème correspondante.

Commencez par actualiser les applications et les environnements d'exécution installés. L'intégration de thèmes documentée de Flatpak peut installer automatiquement une extension correspondante lors d'une installation ou d'une mise à jour, si le thème est disponible sur le dépôt distant configuré.

flatpak update

Si l'application utilise toujours le thème de secours, listez les extensions de thème GTK exposées par Flathub :

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

Choisissez une extension dont le nom correspond au thème GTK 3 que vous avez sélectionné. Flathub propose actuellement plusieurs variantes du thème Yaru org.gtk.Gtk3theme.Yaru-light. Par exemple, installez cette variante uniquement si elle correspond au thème souhaité.

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

La fiche du thème Yaru-light sur Flathub l'identifie comme un thème GTK. Le nom du thème dépend de la configuration de l'hôte et du dépôt distant. Si vous utilisez une autre variante de Yaru ou un thème tiers, consultez flatpak searchla fiche du dépôt distant pour trouver son ID d'extension exact ; ne vous fiez pas au suffixe du nom du thème pour le déterminer visuellement.

Si le thème est installé mais que l'application était déjà en cours d'exécution, fermez toutes ses fenêtres et rouvrez-la. Si le problème persiste, effectuez une nouvelle mise à jour après avoir vérifié que l'extension et l'application proviennent de la même installation Flatpak.

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

Flatpak fait la distinction entre les installations par utilisateur et les installations système. Si vous avez installé l'application --usermais l'extension à l'échelle du système, ou inversement, l'application risque de ne pas détecter l'extension à l'endroit prévu. Dans la mesure du possible, installez l'application et l'extension dans le même contexte. Vous pouvez inspecter l'installation d'une application spécifique avec la commande `flatpak install` flatpak info APP_ID.

3. Consultez le portail de bureau sur Ubuntu 24.04

La documentation du portail Flatpak de GTK indique que ce module xdg-desktop-portal-gtkest requis pour les thèmes et les polices GTK. Ubuntu publie ce module pour la version Noble (24.04 LTS). Si le paquet est absent, installez-le depuis les dépôts Ubuntu :

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

Ubuntu GNOME utilise également le portail GNOME pour les fonctionnalités spécifiques à votre environnement de bureau. L'installation du portail GTK ne signifie pas que vous devez supprimer ou remplacer le portail GNOME. Conservez les paquets du portail fournis pour votre environnement de bureau. Après l'installation, déconnectez-vous puis reconnectez-vous, ou redémarrez le service du portail utilisateur, puis relancez l'application concernée.

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

Si systemd signale que l'unité est indisponible, déconnectez-vous puis reconnectez-vous. Les détails d'activation du portail peuvent varier selon la session et l'état du paquet. La liste des paquets d'Ubuntu confirme que xdg-desktop-portal-gtk est disponible pour Ubuntu 24.04 .

4. Déterminez si l'application peut utiliser le thème.

Si possible, testez plusieurs Flatpak GTK 3. Si plusieurs applications GTK 3 appliquent désormais le thème, mais qu'une application ne l'applique pas, le problème persistant peut être spécifique à cette application ou à son environnement d'exécution. Si des applications GTK 3 fonctionnent correctement, mais qu'une application GNOME moderne présente toujours une couleur d'accentuation ou une apparence de widget différente, cela est normal : les extensions de thème GTK 3 ne s'appliquent pas de la même manière à GTK 4/libadwaita.

Certaines applications utilisent Qt, Electron ou leur propre interface graphique, même si leur apparence est similaire à celle des applications GNOME. Dans ce cas, une extension de thème GTK peut être sans effet. Consultez la documentation officielle de l'application pour connaître les options d'apparence prises en charge avant de modifier les autorisations Flatpak. Pour un Flatpak installé depuis Flathub, examinez son identifiant d'application et son environnement d'exécution avec :

flatpak info APP_ID

Remplacez APP_IDpar l'identifiant de l'application affiché par flatpak list --app. Le résultat permet d'identifier son environnement d'exécution et son périmètre d'installation ; il n'indique pas toujours la boîte à outils, alors vérifiez la boîte à outils dans la documentation de l'application ou sur la page du projet si nécessaire.

Solutions courantes à éviter

• N’accordez pas un accès étendu au système de fichiers de l’hôte uniquement pour copier l’apparence. Flatpak documente les extensions de thème et l’intégration du portail/XSettings comme étant les approches normales. Un accès étendu affaiblit l’isolation du sandbox et peut toujours échouer si les versions GTK de l’hôte et de l’environnement d’exécution diffèrent.
• N’utilisez pas une extension de thème GTK 3 comme commutateur universel pour le mode sombre. Elle contient des fichiers de thème pour les applications GTK 3 compatibles ; la prise en charge du schéma de couleurs du système est un paramètre distinct que l’application et le portail doivent comprendre.
• Ne réinstallez pas l'application avant d'avoir vérifié son extension et son environnement d'exécution. Une réinstallation peut récupérer le même environnement d'exécution sans modifier le thème manquant ni l'état du portail.
• Ne modifiez pas la configuration globale du portail dans un premier temps. Le choix du moteur de rendu d'Ubuntu GNOME est spécifique à chaque session. Modifier les préférences du portail peut affecter le sélecteur de fichiers et d'autres éléments d'intégration du bureau, au-delà du simple thème.

Liste de vérification

• Les paramètres d'Ubuntu affichent le style clair ou sombre souhaité.
• Le nom du thème GTK hôte est connu, et une extension GTK 3 correspondante est disponible pour Flatpak.
• flatpak updateL'installation est terminée, et l'application ainsi que l'extension de thème font partie d'un environnement d'installation compatible.
• Le xdg-desktop-portal-gtkpackage est installé ; après les modifications, la session utilisateur ou le portail a été redémarré.
• L'application concernée a été entièrement fermée puis rouverte.
• Vous avez comparé des applications selon leur boîte à outils : GTK 3, GTK 4/libadwaita, Qt ou Electron peuvent réagir différemment.

Si la liste de vérification est validée et qu'une application reste inchangée, l'étape suivante la plus utile consiste à consulter le système de suivi des problèmes ou la documentation de cette application en indiquant son identifiant Flatpak, son environnement d'exécution, son type de session Ubuntu (Wayland ou X11) et le résultat des deux gsettingscommandes en lecture seule. Cela permet de distinguer un choix de style spécifique à l'application d'un composant d'intégration de bureau manquant, sans compromettre l'environnement isolé.

Le guide utilisateur actuel d'Ubuntu décrit les options de mode clair/sombre dans Paramètres > Apparence . Le comportement de Flatpak peut varier selon sa version, son environnement d'exécution, son portail, sa boîte à outils et ses métadonnées distantes ; si le thème actif n'est pas inclus dans le package d'exécution, l'application peut continuer à utiliser son apparence par défaut.