Ubuntu 24.04에서 Flatpak 앱이 GTK 테마를 제대로 적용하지 않는 문제 해결

빠른 참조: 일반적으로 불일치를 해결하는 방법

Ubuntu 24.04에서 데스크톱이 어두운 테마로 설정되어 있는데도 Flatpak 앱이 Adwaita 또는 밝은 인터페이스로 열리는 경우, 먼저 해당 앱이 GTK 3을 사용하는지 아니면 GTK 4/libadwaita를 사용하는지 확인하십시오. 그런 다음 Flatpak을 업데이트하고, 해당 GTK 3 테마 확장 프로그램을 사용할 수 있도록 설정하고, 데스크톱 포털이 설치되어 있는지 확인하십시오. Flatpak 앱은 샌드박스 환경에서 실행되므로 Ubuntu 호스트에 설치된 모든 테마 파일을 자동으로 읽지 않습니다.

이 단계는 특히 Flathub에서 설치한 Flatpak 애플리케이션이 포함된 Ubuntu 24.04에 적용됩니다. 모든 애플리케이션이 Ubuntu의 전체 데스크톱 스타일을 사용하도록 강제하는 것은 아닙니다. GTK 3 테마 확장, 밝은/어두운 테마 설정, 아이콘 및 앱별 스타일은 별개의 요소입니다.

Flatpak 테마 매칭은 어떻게 작동하나요?

Flatpak 애플리케이션은 호스트 시스템의 라이브러리 및 테마 디렉터리 대신 자체 런타임을 사용합니다. Flatpak은 Ubuntu /usr/share/themes의 테마 소스를 애플리케이션의 소스로 그대로 제공할 수 없습니다. 샌드박스에는 자체 런타임 파일 시스템이 있으며, 테마는 특정 GTK 버전에 의존할 수 있기 때문입니다. 따라서 Flatpak은 지원되는 GTK 3 테마를 런타임 확장 프로그램으로 배포합니다.

Flatpak은 호스트의 활성 GTK 테마 이름을 읽고 앱의 원격 저장소에 해당 확장 프로그램이 있는 경우 이를 설치할 수 있습니다. 단, 테마는 앱에 노출되어 있어야 합니다. X11 환경에서 GTK 3는 XSettings를 통해 선택된 테마를 수신할 수 있습니다. Wayland 환경에서는 GTK가 데스크톱 설정 포털을 통해 관련 외관 설정을 읽습니다. 테마 확장 프로그램이나 적절한 통합 경로가 없는 경우 앱은 Adwaita를 사용할 수 있습니다.

Ubuntu 24.04의 설정 패널에는 밝은 데스크톱 스타일과 어두운 데스크톱 스타일이 있습니다. 하지만 이 설정이 모든 애플리케이션에 Yaru GTK 3 테마를 적용하는 것과는 다릅니다. libadwaita로 빌드된 GTK 4 애플리케이션은 일반적으로 시스템에서 지원하는 외관 설정을 따르지만, 임의로 설정한 기존 GTK 테마를 그대로 적용하는 것은 아닙니다. GTK 3라는 이름의 Flatpak 테마 확장 프로그램은 모든 GTK 4 또는 libadwaita 앱의 스타일을 변경하지 않습니다.

기술적인 개요는 Flatpak의 데스크톱 통합 및 테마 문서 와 GTK 포털 지원 문서를 참조하십시오 .

1. 데스크톱 스타일과 테마 이름을 확인하세요.

설정 > 모양을 열고 원하는 밝은 스타일 또는 어두운 스타일을 선택하세요. 선택 사항은 바탕 화면에 즉시 적용됩니다. GNOME Tweaks 또는 다른 도구를 사용하여 사용자 지정 GTK 테마를 선택하는 경우 정확한 테마 이름을 기록해 두세요. 패키지 이름과 테마 이름은 대소문자 또는 접미사가 다를 수 있습니다.

터미널에서 현재 활성화된 GTK 테마 이름과 색 구성표 기본 설정을 확인할 수 있습니다.

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

첫 번째 명령어는 GNOME 설정에 저장된 테마 이름을 보고하고, 두 번째 명령어는 지원되는 경우 선호하는 밝음/어두움 테마를 보고합니다. 이 명령어들은 값만 검사합니다. 튜토리얼에서 복사한 테마 이름을 테마에 적용하지 마세요. 해당 테마가 설치되어 있고 사용할 의도가 있는 경우에만 적용하는 것이 좋습니다. 외관 설정을 변경한 후에는 해당 앱을 다시 시작하세요. 많은 프로그램이 실행 시 테마를 읽어오기 때문입니다.

2. Flatpak을 업데이트하고 해당 테마 확장 프로그램을 설치하세요.

먼저 설치된 애플리케이션과 런타임을 새로 고치세요. Flatpak의 테마 통합 기능은 구성된 원격 저장소에서 테마를 사용할 수 있는 경우 설치 또는 업데이트 중에 일치하는 확장 프로그램을 자동으로 설치합니다.

flatpak update

앱이 여전히 대체 테마를 사용하는 경우 Flathub에서 노출하는 GTK 테마 확장 프로그램 목록을 표시합니다.

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

선택한 GTK 3 테마와 이름이 일치하는 확장 프로그램을 선택하세요. Flathub에는 현재 Yaru 테마 변형이 나열되어 있습니다 org.gtk.Gtk3theme.Yaru-light. 예를 들어, 원하는 테마와 일치하는 경우에만 해당 변형을 설치하세요.

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

Flathub의 Yaru-light 테마 목록에서는 해당 테마가 GTK 테마 패키지로 식별됩니다. 일치하는 테마 이름은 호스트 설정과 원격 저장소에서 현재 게시하는 내용에 따라 달라집니다. 다른 Yaru 변형이나 타사 테마를 사용하는 경우, flatpak search정확한 확장 ID를 찾으려면 원격 저장소 목록을 참조하십시오. 패키지 접미사를 시각적 이름에서 추측하지 마십시오.

테마가 설치되어 있지만 앱이 이미 실행 중인 경우, 앱의 모든 창을 닫고 다시 실행하세요. 문제가 계속되는 경우, 확장 프로그램과 애플리케이션이 동일한 Flatpak 설치에서 나온 것인지 확인한 후 다시 한 번 업데이트하세요.

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

Flatpak은 사용자별 설치와 시스템 설치를 구분합니다. 앱을 설치했지만 --user확장 프로그램을 시스템 전체에 설치했거나, 그 반대의 경우 앱이 예상대로 확장 프로그램을 인식하지 못할 수 있습니다. 가능하면 앱과 확장 프로그램을 동일한 설치 범위 내에 유지하세요. 특정 앱의 설치 상태는 명령어를 사용하여 확인할 수 있습니다 flatpak info APP_ID.

3. 우분투 24.04의 데스크톱 포털을 확인하세요.

GTK의 Flatpak 포털 문서에 따르면 xdg-desktop-portal-gtkGTK 테마와 글꼴을 사용하려면 해당 패키지가 필요합니다. Ubuntu는 Noble(24.04 LTS) 릴리스용 백엔드를 제공합니다. 패키지가 없는 경우 Ubuntu 저장소에서 설치하십시오.

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

Ubuntu GNOME은 데스크톱 전용 포털 기능을 위해 GNOME 포털 백엔드를 사용합니다. GTK 백엔드를 설치한다고 해서 GNOME 백엔드를 제거하거나 교체해야 하는 것은 아닙니다. 데스크톱 환경에 제공된 포털 패키지를 그대로 유지하십시오. 설치 후에는 로그아웃했다가 다시 로그인하거나, 사용자 포털 서비스를 재시작한 다음 해당 앱을 다시 실행하십시오.

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

systemd에서 해당 장치를 사용할 수 없다고 보고하는 경우 로그아웃 후 다시 로그인하십시오. 포털 활성화 세부 정보는 세션 및 패키지 상태에 따라 다를 수 있습니다. Ubuntu 패키지 목록에서 xdg-desktop-portal-gtk가 Ubuntu 24.04에서 사용 가능함 을 확인할 수 있습니다 .

4. 앱에서 해당 테마를 사용할 수 있는지 여부를 결정합니다.

가능하다면 여러 개의 GTK 3 Flatpak을 테스트해 보세요. 여러 GTK 3 앱이 테마를 제대로 따르지만 특정 앱만 그렇지 않다면, 남은 문제는 해당 앱이나 런타임과 관련된 것일 수 있습니다. GTK 3 앱은 정상적으로 작동하지만 최신 GNOME 앱에서 강조 색상이나 위젯 모양이 다르게 보이는 것은 정상적인 현상입니다. GTK 3 테마 확장 기능은 GTK 4/libadwaita에 동일한 방식으로 적용되지 않기 때문입니다.

일부 앱은 GNOME 애플리케이션과 유사하게 보일지라도 Qt, Electron 또는 자체 인터페이스 툴킷을 사용합니다. 이러한 경우 GTK 테마 확장 프로그램이 효과가 없을 수 있습니다. Flatpak 권한을 변경하기 전에 앱의 공식 문서를 확인하여 지원되는 모양 옵션을 확인하십시오. Flathub에서 설치한 Flatpak의 경우 다음 명령으로 앱 ID와 런타임을 확인할 수 있습니다.

flatpak info APP_ID

APP_ID출력 결과에 표시된 애플리케이션 ID로 대체하세요 flatpak list --app. 이 출력 결과는 애플리케이션의 런타임 및 설치 범위를 식별하는 데 도움이 됩니다. 툴킷 정보가 항상 표시되는 것은 아니므로 필요한 경우 애플리케이션 자체 문서 또는 프로젝트 페이지에서 툴킷을 확인하세요.

흔히 저지르는 실수는 피해야 합니다.

• 단순히 외형을 복제하기 위해 호스트 파일 시스템에 대한 광범위한 접근 권한을 부여하지 마십시오. Flatpak 문서에서는 테마 확장 및 포털/XSettings 통합을 일반적인 접근 방식으로 제시합니다. 광범위한 접근 권한은 샌드박스 격리를 약화시키고 호스트와 런타임 GTK 버전이 다를 경우 오류가 발생할 수 있습니다.
• GTK 3 테마 확장 프로그램을 범용 다크 모드 스위치로 사용하지 마십시오. 이 확장 프로그램에는 호환되는 GTK 3 앱용 테마 파일이 포함되어 있으며, 시스템 색 구성표 지원은 앱과 포털이 이해해야 하는 별도의 설정입니다.
• 확장 프로그램과 런타임을 확인하기 전에 애플리케이션을 다시 설치하지 마십시오. 다시 설치하면 누락된 테마나 포털 상태가 변경되지 않고 동일한 런타임이 설치될 수 있습니다.
• 우선 전역 포털 설정을 변경하지 마십시오. Ubuntu GNOME의 백엔드 선택은 세션별로 적용됩니다. 포털 설정을 변경하면 테마 외에도 파일 선택기 및 기타 데스크톱 통합 기능에 영향을 미칠 수 있습니다.

검증 체크리스트

• 우분투 설정에서 원하는 밝은 스타일 또는 어두운 스타일을 보여줍니다.
• 호스트 GTK 테마 이름이 알려져 있고, Flatpak에서 사용할 수 있는 일치하는 GTK 3 확장 프로그램이 있습니다.
• flatpak update완료되었으며, 앱과 테마 확장 프로그램은 호환 가능한 설치 범위 내에 있습니다.
• 패키지 xdg-desktop-portal-gtk가 설치되었습니다. 변경 사항 적용 후 사용자 세션 또는 포털이 다시 시작되었습니다.
• 해당 애플리케이션은 완전히 종료되었다가 다시 실행되었습니다.
• 툴킷별로 앱을 비교하셨는데, GTK 3, GTK 4/libadwaita, Qt 또는 Electron은 각기 다른 반응을 보일 수 있습니다.

체크리스트를 모두 통과했는데도 앱 하나가 변경되지 않았다면, 가장 유용한 다음 단계는 해당 앱의 이슈 트래커나 문서를 참조하는 것입니다. 이때 Flatpak ID, 런타임, Ubuntu 세션 유형(Wayland 또는 X11), 그리고 두 개의 읽기 전용 gsettings명령의 출력 결과를 활용하세요. 이렇게 하면 샌드박스 환경을 손상시키지 않고 앱별 스타일링 선택과 데스크톱 통합 구성 요소 누락을 구분할 수 있습니다.

Ubuntu의 최신 사용자 가이드에서는 설정 > 모양 에서 밝기/어둡기 모드를 조절할 수 있다고 설명합니다 . Flatpak의 동작은 버전, 앱 런타임, 포털 백엔드, 툴킷 및 원격 메타데이터에 따라 달라질 수 있습니다. 활성화된 테마가 런타임용으로 패키징되지 않은 경우 앱은 기본 모양을 계속 사용할 수 있습니다.