Corrigir problema em aplicativos Flatpak que não respeitam o tema GTK no Ubuntu 24.04

Referência rápida: o que geralmente resolve a incompatibilidade

Se um aplicativo Flatpak no Ubuntu 24.04 abrir com o tema Adwaita ou uma interface clara enquanto a área de trabalho estiver configurada para o tema escuro, verifique primeiro se o aplicativo usa GTK 3 ou GTK 4/libadwaita. Em seguida, atualize o Flatpak, disponibilize a extensão de tema GTK 3 correspondente e confirme se o portal da área de trabalho está instalado. Os aplicativos Flatpak são executados em um ambiente isolado (sandbox), portanto, não leem automaticamente todos os arquivos de tema instalados no sistema Ubuntu.

Estas etapas se aplicam a aplicativos Flatpak no Ubuntu 24.04, especialmente aqueles instalados pelo Flathub. Elas não forçam todos os aplicativos a usar o estilo completo da área de trabalho do Ubuntu. Extensões de tema GTK 3, preferências de modo claro/escuro, ícones e estilos específicos de aplicativos são itens separados.

Como funciona a correspondência de temas do Flatpak

Um aplicativo Flatpak usa seu próprio ambiente de execução, em vez das bibliotecas e diretórios de temas do sistema hospedeiro. O Flatpak não pode simplesmente expor o ambiente de execução do Ubuntu /usr/share/themescomo fonte de temas do aplicativo: o ambiente isolado (sandbox) possui seu próprio sistema de arquivos de execução, e os temas podem depender de uma versão específica do GTK. Portanto, o Flatpak distribui temas GTK 3 compatíveis como extensões de tempo de execução.

O Flatpak consegue ler o nome do tema GTK ativo do host e instalar uma extensão correspondente quando disponível no repositório remoto do aplicativo. O tema ainda precisa ser exposto ao aplicativo. No X11, o GTK 3 pode receber o tema selecionado através do XSettings. No Wayland, o GTK lê as configurações de aparência relevantes através de um portal de Configurações na área de trabalho. Se a extensão do tema ou um caminho de integração adequado estiver ausente, o aplicativo pode recorrer ao Adwaita.

O painel de Configurações do Ubuntu 24.04 oferece estilos de área de trabalho claro e escuro. Essa preferência não é a mesma coisa que fazer com que todos os aplicativos usem o tema Yaru GTK 3. Aplicativos GTK 4 compilados com libadwaita geralmente seguem as preferências de aparência do sistema, mas não necessariamente aceitam substituições arbitrárias de temas GTK legados. Uma extensão de tema Flatpak com o nome para GTK 3 não irá reestilizar todos os aplicativos GTK 4 ou libadwaita.

Para uma visão geral técnica, consulte a documentação de integração e temas do Flatpak para desktop e a documentação de suporte ao portal GTK .

1. Confirme o estilo da área de trabalho e o nome do tema.

Abra Configurações > Aparência e selecione o estilo Claro ou Escuro desejado. A escolha será aplicada imediatamente à área de trabalho. Se você usar o GNOME Tweaks ou outra ferramenta para selecionar um tema GTK personalizado, anote o nome exato do tema; os nomes dos pacotes e dos temas podem diferir em maiúsculas e minúsculas ou sufixos.

Você pode ler o nome do tema GTK ativo e a preferência de esquema de cores no Terminal:

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

O primeiro comando exibe o nome do tema armazenado nas configurações do GNOME; o segundo exibe o esquema claro/escuro preferido, quando compatível. Esses comandos apenas inspecionam valores. Evite definir um nome de tema copiado de um tutorial, a menos que esse tema esteja instalado e você pretenda usá-lo. Reinicie o aplicativo afetado após alterar as configurações de aparência, pois muitos programas leem seu tema na inicialização.

2. Atualize o Flatpak e instale a extensão de tema correspondente.

Primeiro, atualize os aplicativos e tempos de execução instalados. A integração de temas documentada do Flatpak pode instalar automaticamente uma extensão correspondente durante uma instalação ou atualização, quando o tema estiver disponível no repositório remoto configurado.

flatpak update

Se o aplicativo ainda estiver usando o tema alternativo, liste as extensões de tema GTK expostas pelo Flathub:

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

Escolha uma extensão cujo nome corresponda ao tema GTK 3 selecionado. O Flathub lista atualmente variantes do tema Yaru, incluindo org.gtk.Gtk3theme.Yaru-light. Por exemplo, instale essa variante somente se ela corresponder ao tema desejado:

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

A listagem do tema Yaru-light no Flathub o identifica como um pacote de tema GTK. O nome do tema correspondente depende da configuração do host e do que o servidor remoto publica atualmente. Se você usa uma variante diferente do Yaru ou um tema de terceiros, use flatpak searcha listagem do servidor remoto para encontrar o ID de extensão exato; não assuma o sufixo do pacote a partir do nome visual.

Se o tema estiver instalado, mas o aplicativo já estiver em execução, feche todas as janelas e abra-o novamente. Em casos persistentes, atualize mais uma vez após confirmar que a extensão e o aplicativo pertencem à mesma instalação do Flatpak.

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

O Flatpak distingue entre instalações por usuário e instalações do sistema. Se você instalou o aplicativo com `flatpak --userinstall`, mas instalou a extensão em todo o sistema, ou vice-versa, o aplicativo pode não encontrar a extensão onde deveria. Mantenha o aplicativo e a extensão no mesmo escopo de instalação sempre que possível. Você pode inspecionar a instalação de um aplicativo específico com `flatpak install` flatpak info APP_ID.

3. Verifique o portal da área de trabalho no Ubuntu 24.04.

A documentação do portal Flatpak do GTK afirma que ele xdg-desktop-portal-gtké necessário para temas e fontes GTK. O Ubuntu publica esse backend para a versão Noble (24.04 LTS). Se o pacote não estiver presente, instale-o a partir dos repositórios do Ubuntu:

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

O Ubuntu GNOME também utiliza o backend do portal GNOME para recursos específicos do portal para desktops. Instalar o backend GTK não significa que você deva remover ou substituir o backend GNOME. Mantenha os pacotes do portal fornecidos para o seu ambiente de desktop. Após a instalação, faça logout e login novamente, ou reinicie o serviço do portal do usuário e, em seguida, abra novamente o aplicativo afetado.

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

Se o systemd informar que a unidade está indisponível, faça logout e login novamente. Os detalhes de ativação do portal podem variar de acordo com a sessão e o estado do pacote. A lista de pacotes do Ubuntu confirma que o xdg-desktop-portal-gtk está disponível para o Ubuntu 24.04 .

4. Decida se o aplicativo pode usar o tema.

Teste mais de um Flatpak do GTK 3, se possível. Se vários aplicativos GTK 3 seguirem o tema, mas um deles não, o problema restante pode ser específico desse aplicativo ou do seu ambiente de execução. Se os aplicativos GTK 3 funcionarem, mas um aplicativo GNOME moderno ainda apresentar uma cor de destaque ou aparência de widget diferente, isso é esperado: as extensões de tema do GTK 3 não se aplicam ao GTK 4/libadwaita da mesma forma.

Alguns aplicativos usam Qt, Electron ou seu próprio kit de ferramentas de interface, mesmo que tenham aparência semelhante aos aplicativos do GNOME. Nesse caso, uma extensão de tema GTK pode não ter efeito. Consulte a documentação oficial do aplicativo para obter informações sobre as opções de aparência compatíveis antes de alterar as permissões do Flatpak. Para um Flatpak instalado a partir do Flathub, inspecione o ID do aplicativo e o ambiente de execução com:

flatpak info APP_ID

Substitua APP_IDpelo ID do aplicativo exibido por flatpak list --app. A saída ajuda a identificar o ambiente de execução e o escopo de instalação; nem sempre informa o conjunto de ferramentas, portanto, confirme o conjunto de ferramentas na documentação do aplicativo ou na página do projeto, quando necessário.

Correções comuns a evitar

• Não conceda acesso amplo ao sistema de arquivos do host apenas para copiar a aparência. O Flatpak documenta extensões de tema e integração com o portal/XSettings como as abordagens normais. O acesso amplo enfraquece o isolamento do sandbox e ainda pode falhar quando as versões do GTK no host e no ambiente de execução forem diferentes.
• Não utilize uma extensão de tema GTK 3 como um interruptor universal para o modo escuro. Ela contém arquivos de tema para aplicativos GTK 3 compatíveis; o suporte a esquemas de cores do sistema é uma configuração separada que o aplicativo e o portal devem compreender.
• Não reinstale o aplicativo antes de verificar sua extensão e ambiente de execução. A reinstalação pode obter o mesmo ambiente de execução sem alterar o tema ausente ou a condição do portal.
• Não altere a configuração global do portal como primeiro passo. A seleção do backend do GNOME no Ubuntu é específica da sessão. Alterar as preferências do portal pode afetar os seletores de arquivos e outras integrações da área de trabalho, além da personalização de temas.

Lista de verificação

• As configurações do Ubuntu mostram o estilo desejado, claro ou escuro.
• O nome do tema GTK do host é conhecido e uma extensão GTK 3 correspondente está disponível para o Flatpak.
• flatpak updateConcluído, e o aplicativo e a extensão do tema estão em um escopo de instalação compatível.
• O xdg-desktop-portal-gtkpacote foi instalado; após as alterações, a sessão do usuário ou o portal foi reiniciado.
• O aplicativo afetado foi totalmente fechado e reaberto.
• Você comparou aplicativos por conjunto de ferramentas: GTK 3, GTK 4/libadwaita, Qt ou Electron podem responder de maneira diferente.

Se a lista de verificação for aprovada e um aplicativo permanecer inalterado, a próxima etapa mais útil é consultar o rastreador de problemas ou a documentação desse aplicativo, incluindo seu ID Flatpak, ambiente de execução, tipo de sessão do Ubuntu (Wayland ou X11) e a saída dos dois gsettingscomandos somente leitura. Isso ajuda a distinguir uma escolha de estilo específica do aplicativo de um componente de integração com a área de trabalho ausente, sem comprometer a segurança do ambiente isolado.

O guia do usuário atual do Ubuntu descreve os controles de tema claro/escuro em Configurações > Aparência . O comportamento do Flatpak pode variar de acordo com a versão, o ambiente de execução do aplicativo, o backend do portal, o conjunto de ferramentas e os metadados remotos; se o tema ativo não estiver empacotado para o ambiente de execução, o aplicativo poderá continuar usando sua aparência padrão.