Solucionar el problema de las aplicaciones Flatpak que no respetan el tema GTK en Ubuntu 24.04.

Referencia rápida: qué suele solucionar el desajuste

Si una aplicación Flatpak en Ubuntu 24.04 se abre con Adwaita o una interfaz clara mientras el escritorio está configurado en modo oscuro, primero verifique si la aplicación usa GTK 3 o GTK 4/libadwaita. Luego, actualice Flatpak, habilite la extensión de tema GTK 3 correspondiente y confirme que el portal de escritorio esté instalado. Las aplicaciones Flatpak se ejecutan en un entorno aislado, por lo que no leen automáticamente todos los archivos de tema instalados en el host Ubuntu.

Estos pasos se aplican a las aplicaciones Flatpak en Ubuntu 24.04, especialmente a las instaladas desde Flathub. No obligan a todas las aplicaciones a usar el estilo de escritorio completo de Ubuntu. Las extensiones de tema GTK 3, la preferencia de modo claro/oscuro, los iconos y los estilos específicos de cada aplicación son elementos independientes.

Cómo funciona la coincidencia de temas de Flatpak

Una aplicación Flatpak utiliza su propio entorno de ejecución en lugar de las bibliotecas del sistema y los directorios de temas del host. Flatpak no puede simplemente exponer el entorno de Ubuntu /usr/share/themescomo fuente de temas de la aplicación: el entorno aislado tiene su propio sistema de archivos de ejecución, y los temas pueden depender de una versión específica de GTK. Por lo tanto, Flatpak distribuye los temas GTK 3 compatibles como extensiones de ejecución.

Flatpak puede leer el nombre del tema GTK activo del host e instalar una extensión compatible si está disponible en el repositorio remoto de la aplicación. El tema aún debe estar disponible para la aplicación. En X11, GTK 3 puede recibir el tema seleccionado a través de XSettings. En Wayland, GTK lee la configuración de apariencia relevante a través de un portal de configuración de escritorio. Si falta la extensión del tema o una ruta de integración adecuada, la aplicación puede recurrir a Adwaita.

El panel de configuración de Ubuntu 24.04 ofrece estilos de escritorio claro y oscuro. Esta preferencia no implica que todas las aplicaciones utilicen el tema Yaru GTK 3. Las aplicaciones GTK 4 creadas con libadwaita generalmente siguen las preferencias de apariencia del sistema compatibles, pero no necesariamente aceptan modificaciones arbitrarias de temas GTK heredados. Una extensión de tema Flatpak con el nombre GTK 3 no modificará el estilo de todas las aplicaciones GTK 4 o libadwaita.

Para obtener una descripción técnica general, consulte la documentación de integración y personalización de temas de escritorio de Flatpak y su documentación de soporte para portales GTK .

1. Confirma el estilo de escritorio y el nombre del tema.

Abre Ajustes > Apariencia y selecciona el estilo Claro u Oscuro que prefieras. La selección se aplicará inmediatamente al escritorio. Si utilizas GNOME Tweaks u otra herramienta para seleccionar un tema GTK personalizado, anota su nombre exacto; los nombres de los paquetes y los temas pueden diferir en mayúsculas o sufijos.

Puedes leer el nombre del tema GTK activo y la preferencia de esquema de color en la Terminal:

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

El primer comando muestra el nombre del tema guardado en la configuración de GNOME; el segundo muestra el esquema claro/oscuro preferido, si está disponible. Estos comandos solo inspeccionan valores. Evite usar un nombre de tema copiado de un tutorial, a menos que el tema esté instalado y tenga intención de usarlo. Reinicie la aplicación afectada después de cambiar la configuración de apariencia, ya que muchos programas leen su tema al iniciarse.

2. Actualiza Flatpak e instala la extensión de tema correspondiente.

Primero, actualiza las aplicaciones y los entornos de ejecución instalados. La integración de temas documentada de Flatpak puede instalar automáticamente una extensión compatible durante una instalación o actualización cuando el tema esté disponible en el repositorio remoto configurado.

flatpak update

Si la aplicación sigue utilizando el tema de reserva, enumere las extensiones de tema GTK expuestas por Flathub:

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

Elige una extensión cuyo nombre coincida con el tema GTK 3 que seleccionaste. Actualmente, Flathub muestra variantes del tema Yaru, incluyendo org.gtk.Gtk3theme.Yaru-light. Por ejemplo, instala esa variante solo cuando coincida con el tema que deseas:

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

La ficha del tema Yaru-light de Flathub lo identifica como un paquete de tema GTK. El nombre del tema correspondiente depende de la configuración del host y de lo que publique el repositorio remoto. Si utiliza una variante diferente de Yaru o un tema de terceros, consulte flatpak searchla ficha del repositorio remoto para encontrar su ID de extensión exacto; no asuma el sufijo del paquete a partir de su nombre visual.

Si el tema está instalado pero la aplicación ya se estaba ejecutando, cierre todas sus ventanas y vuelva a abrirla. En caso de que persista el problema, actualice nuevamente después de confirmar que la extensión y la aplicación provienen de la misma instalación de Flatpak.

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

Flatpak distingue entre instalaciones por usuario y de sistema. Si instalaste la aplicación con --userpero instalaste la extensión en todo el sistema, o viceversa, es posible que la aplicación no vea la extensión donde se espera. Mantén la aplicación y la extensión en el mismo ámbito de instalación siempre que sea posible. Puedes inspeccionar la instalación de una aplicación específica con flatpak info APP_ID.

3. Comprueba el portal de escritorio en Ubuntu 24.04.

La documentación del portal Flatpak de GTK indica que xdg-desktop-portal-gtkes necesario para los temas y fuentes de GTK. Ubuntu publica este backend para la versión Noble (24.04 LTS). Si el paquete no está presente, instálelo desde los repositorios de Ubuntu:

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

Ubuntu GNOME también utiliza el backend del portal GNOME para las funciones específicas del portal de escritorio. Instalar el backend GTK no implica que deba eliminar o reemplazar el backend de GNOME. Conserve los paquetes del portal proporcionados para su entorno de escritorio. Después de la instalación, cierre sesión y vuelva a iniciarla, o reinicie el servicio del portal de usuario y luego vuelva a ejecutar la aplicación afectada.

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

Si systemd informa que la unidad no está disponible, cierre sesión y vuelva a iniciarla. Los detalles de activación del portal pueden variar según la sesión y el estado del paquete. El listado de paquetes de Ubuntu confirma que xdg-desktop-portal-gtk está disponible para Ubuntu 24.04 .

4. Decide si la aplicación puede usar el tema.

Si es posible, prueba más de un Flatpak de GTK 3. Si varias aplicaciones GTK 3 siguen el tema pero una no, el problema restante podría ser específico de esa aplicación o de su entorno de ejecución. Si las aplicaciones GTK 3 funcionan pero una aplicación GNOME moderna aún presenta un color de acento o una apariencia de widget diferente, es normal: las extensiones de tema de GTK 3 no se aplican a GTK 4/libadwaita de la misma manera.

Algunas aplicaciones usan Qt, Electron o su propio kit de herramientas de interfaz, incluso cuando se parecen a las aplicaciones de GNOME. En ese caso, una extensión de tema GTK podría no tener efecto. Consulta la documentación oficial de la aplicación para ver las opciones de apariencia compatibles antes de cambiar los permisos de Flatpak. Para un Flatpak instalado desde Flathub, inspecciona su ID de aplicación y tiempo de ejecución con:

flatpak info APP_ID

Reemplazar APP_IDcon el ID de la aplicación que se muestra flatpak list --app. La salida ayuda a identificar su entorno de ejecución y ámbito de instalación; no siempre indica el conjunto de herramientas, así que confirme el conjunto de herramientas en la documentación de la aplicación o en la página del proyecto cuando sea necesario.

Soluciones comunes que se deben evitar

• No conceda acceso amplio al sistema de archivos del host solo para copiar la apariencia. Flatpak documenta las extensiones de temas y la integración con portales/XSettings como los métodos habituales. El acceso amplio debilita el aislamiento del entorno aislado y puede fallar incluso si las versiones de GTK del host y del entorno de ejecución difieren.
• No utilice una extensión de tema GTK 3 como interruptor universal para el modo oscuro. Contiene archivos de tema para aplicaciones GTK 3 compatibles; la compatibilidad con el esquema de colores del sistema es una configuración independiente que la aplicación y el portal deben comprender.
• No reinstale la aplicación sin antes comprobar su extensión y entorno de ejecución. La reinstalación podría descargar el mismo entorno de ejecución sin modificar el tema o la condición del portal que faltan.
• No modifique la configuración global del portal como primer paso. La selección del backend de Ubuntu GNOME es específica de cada sesión. Reemplazar las preferencias del portal puede afectar a los selectores de archivos y otras integraciones del escritorio, más allá de la personalización de temas.

Lista de verificación

• La configuración de Ubuntu muestra el estilo claro u oscuro deseado.
• Se conoce el nombre del tema GTK del host, y hay disponible una extensión GTK 3 compatible para Flatpak.
• flatpak updateLa instalación se ha completado y tanto la aplicación como la extensión del tema se encuentran dentro de un ámbito de instalación compatible.
• El xdg-desktop-portal-gtkpaquete está instalado; tras realizar los cambios, se ha reiniciado la sesión de usuario o el portal.
• La aplicación afectada fue cerrada y reabierta por completo.
• Comparaste las aplicaciones según el kit de herramientas: GTK 3, GTK 4/libadwaita, Qt o Electron pueden responder de manera diferente.

Si la lista de verificación se completa correctamente y una aplicación permanece sin cambios, el siguiente paso más útil es consultar el sistema de seguimiento de errores o la documentación de dicha aplicación, junto con su ID de Flatpak, entorno de ejecución, tipo de sesión de Ubuntu (Wayland o X11) y el resultado de los dos gsettingscomandos de solo lectura. Esto ayuda a distinguir una elección de estilo específica de la aplicación de un componente de integración de escritorio faltante, sin comprometer el entorno aislado.

La guía de usuario actual de Ubuntu describe los controles de modo claro/oscuro en Configuración > Apariencia . El comportamiento de Flatpak puede variar según su versión, el entorno de ejecución de la aplicación, el backend del portal, el kit de herramientas y los metadatos remotos; si el tema activo no está empaquetado para el entorno de ejecución, la aplicación puede seguir utilizando su apariencia predeterminada.