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

만약 Ubuntu 24.04의 나머지 부분이 Yaru를 사용하는 동안 Flatpak 앱이 Adwaita 테마로 실행된다면, 데스크톱에 설치된 테마 파일에는 문제가 없을 수 있습니다. Flatpak은 앱을 샌드박스 환경에서 실행하기 때문에 프로그램이 호스트의 모든 테마 파일을 자동으로 읽지 않습니다. 일반적으로 이 문제를 해결하려면 선택한 테마가 Flatpak 런타임에서 사용 가능한지 확인하고, 데스크톱 설정 서비스가 활성화된 테마를 전달할 수 있도록 해야 합니다.

이 가이드는 간단한 점검부터 시작하여 단계별 문제 해결로 이어집니다. 주로 GTK 3 애플리케이션에 적용됩니다. GTK 4 및 libadwaita 애플리케이션은 다른 스타일링 규칙을 따를 수 있으므로, 파일 앱이나 다른 GTK 3 애플리케이션에서 작동하는 테마가 모든 Flatpak 창에 적용된다는 보장은 없습니다.

먼저 알아야 할 사항

GTK 테마는 그래픽 인터페이스 구축 툴킷인 GTK를 사용하는 앱에서 버튼이나 메뉴와 같은 인터페이스 요소의 모양을 제어합니다. Flatpak 런타임은 샌드박스 환경에서 실행되는 앱에서 사용하는 공유 라이브러리를 제공합니다. 샌드박스는 앱의 파일 시스템을 호스트 시스템과 분리합니다. 따라서 특정 위치에 있는 호스트 테마 파일은 /usr/share/themes모든 Flatpak에 그대로 복사되지 않습니다.

Flatpak에서 지원하는 GTK 3 테마 방식은 테마 이름을 딴 확장 프로그램으로, 일반적으로 `.getTemplate` 뒤에 붙습니다 org.gtk.Gtk3theme.ThemeName. 해당 확장 프로그램이 앱 실행을 위해 구성된 원격 저장소에 존재하면 Flatpak은 앱과 함께 또는 업데이트 중에 해당 확장 프로그램을 설치할 수 있습니다. 데스크톱은 또한 활성 설정을 노출해야 합니다. X11에서는 `XSettings`가 사용되고, Wayland에서는 설정 포털이 제공됩니다. 포털 은 샌드박스 앱에 선택된 데스크톱 기능 및 환경 설정에 대한 제어된 액세스를 제공하는 데스크톱 서비스입니다.

Ubuntu의 기본 Yaru 테마가 호스트에 설치되어 있지만, 그 사실만으로는 모든 앱과 런타임에 해당하는 Flatpak 테마 확장 프로그램이 사용 가능하다는 것을 보장할 수 없습니다. 사용 가능 여부는 테마 이름, 구성된 Flatpak 원격 저장소, 런타임 브랜치 및 툴킷에 따라 달라질 수 있습니다. Flatpak 문서에서는 테마 또는 설정 인터페이스를 사용할 수 없을 때 Adwaita를 대체 도구로 사용한다고 명시하고 있습니다.

1단계: 호스트 테마 및 세션을 확인합니다.

먼저 테마가 일반 데스크톱 앱에 적용되는지 확인하세요. 설정 → 모양으로 이동하여 선택된 스타일을 확인하고, 미리 설치된 GTK 앱을 실행해 보세요. 호스트 앱도 제대로 표시되지 않으면 Flatpak 설정을 변경하기 전에 데스크톱 모양을 수정하세요.

터미널에서 다음 명령어를 사용하여 GTK 테마 이름을 확인할 수 있습니다.

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

결과는 예를 들어 따옴표로 묶인 이름입니다 'Yaru'. 철자와 대소문자를 기록해 두세요. Flatpak은 호스트에서 선택한 GTK 테마 이름을 확장자와 일치시킵니다. 유사하지만 이름이 다른 테마를 검색해도 불일치가 해결되지 않을 수 있습니다. Ubuntu의 Yaru 프로젝트는 Yaru를 Ubuntu의 기본 GTK 테마 모음으로 설명합니다.

또한 세션이 Wayland인지 X11인지 확인하십시오. 로그인 화면에서 사용자를 선택하고, 가능하다면 톱니바퀴 메뉴를 사용하세요. 세션 이름은 일반적으로 거기에 표시됩니다. 설정 경로가 다르기 때문에 이를 확인하는 것이 중요합니다. Wayland는 포털을 사용하는 반면, X11은 XSettings를 사용합니다. Ubuntu 24.04의 기본 GNOME 세션은 일반적으로 Wayland를 사용하지만, 사용자는 다른 세션을 선택할 수도 있습니다.

2단계: Flatpak을 업데이트하고 테마 확장 기능 사용 가능 여부를 확인합니다.

설치된 앱, 런타임 및 사용 가능한 확장 프로그램을 새로 고치려면 Flatpak 일반 업데이트를 실행하세요.

flatpak update

변경 사항을 확인하기 전에 제안된 내용을 검토하십시오. 다음으로, 구성된 원격 장치에서 기록한 테마 이름과 일치하는 확장 프로그램을 검색하십시오. Yaru를 선택하려면 다음을 시도해 보세요.

flatpak search org.gtk.Gtk3theme.Yaru

검색 결과가 일치하는 확장 프로그램을 반환하면 표시된 정확한 애플리케이션 ID와 원격 저장소를 기록해 두십시오. Flatpak에서 이미 설치하지 않은 경우에만 설치하십시오. 표시된 ID와 원격 저장소를 정확히 사용하십시오.

flatpak install REMOTE EXTENSION_ID

대문자로 표시된 자리 표시자를 실제 값으로 바꾸세요. 관련 없는 테마나 런타임 브랜치에서 추측한 확장 프로그램 ID를 복사하지 마세요. 일부 확장 프로그램 빌드는 특정 런타임에서 사용할 수 없을 수 있습니다. 이 경우 호스트에 Yaru가 설치되어 있더라도 앱은 Adwaita를 계속 사용할 수 있습니다.

Flatpak 자체 데스크톱 통합 문서에 따르면, 원격 저장소에 해당 GTK 테마 확장 프로그램이 있는 경우 앱 설치 또는 업데이트 중에 자동으로 설치됩니다. 따라서 확장 프로그램이 있지만 원격 저장소에 없는 경우 앱을 업데이트하는 것만으로도 충분할 수 있습니다. 원격 저장소와 패키지가 변경됨에 따라 검색 결과가 달라질 수 있으므로 패키지 이름을 가정하기보다는 로컬 Flatpak 출력 결과를 현재 기준으로 삼으세요.

3단계: 앱을 다시 시작하고 데스크톱 설정 서비스를 새로 고칩니다.

해당 앱을 백그라운드에서 실행되는 모든 인스턴스를 포함하여 완전히 종료한 다음 다시 실행하세요. 실행 중인 프로세스는 시작 시 읽어온 앱 모양 설정을 유지할 수 있습니다.

Wayland를 사용 중인데 여러 GTK Flatpak에서 선택한 스타일이 여전히 적용되지 않는다면 GTK 포털 백엔드가 설치되어 있는지 확인하십시오.

dpkg -l xdg-desktop-portal xdg-desktop-portal-gtk

패키지 목록에서 설치 상태를 확인하세요. Flatpak 문서에서는 xdg-desktop-portal-gtkGTK 테마와 글꼴에 필수적이라고 명시하고 있습니다. 만약 설치되어 있지 않다면 공식 아카이브에서 Ubuntu 패키지를 설치하세요.

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

먼저 열려 있는 애플리케이션의 작업을 저장하세요. 그런 다음 로그아웃했다가 다시 로그인하면 사용자 세션과 포털 서비스가 깔끔하게 재시작됩니다. 이는 일반적으로 초보자에게 가장 명확한 방법입니다. 고급 사용자는 터미널에서 `restart` 명령어를 사용하여 사용자 서비스를 재시작할 수 있지만 systemctl --user restart xdg-desktop-portal.service xdg-desktop-portal-gtk.service, 서비스 이름과 활성화 방식은 설치 환경에 따라 다를 수 있습니다. 해당 명령어가 특정 서비스가 로드되지 않았다고 보고하는 경우, 서비스를 반복적으로 재시작하는 대신 로그아웃하는 것이 좋습니다.

4단계: 애플리케이션이 테마를 지원하는지 확인합니다.

같은 Flatpak 파일을 다시 열고 버튼, 메뉴, 창 내용을 Ubuntu 패키지에서 설치한 GTK 앱과 비교해 보세요. 만약 하나의 Flatpak 파일만 다르다면, 문제는 해당 앱의 툴킷, 런타임 또는 구현 방식에 있을 수 있습니다. 예를 들어, 일부 GTK 4 앱은 GNOME의 디자인 규칙을 따르도록 설계된 libadwaita 라이브러리를 사용하는데, 이는 이전 GTK 3 앱처럼 임의의 GTK 테마를 지원하지 않습니다. 또한 GTK 3용 Flatpak 확장 프로그램은 Qt 앱의 스타일을 변경하지 않습니다.

앱이 최신 런타임을 사용하고 GTK 3 테마 확장 프로그램이 있는 경우 데스크톱 설정은 일반적으로 자동으로 적용됩니다. 적용되지 않는 경우 다음 명령으로 앱의 런타임을 확인하세요.

flatpak info APP_ID

APP_ID앱의 실제 ID로 바꿔주세요 . 출력 결과는 앱 관리자에게 문의할 때 보고해야 할 런타임 및 브랜치를 식별하는 데 도움이 됩니다. 하지만 이 자체만으로는 애플리케이션이 GTK 테마 설정을 준수하는지 여부를 증명할 수는 없습니다.

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

• 우선 호스트 파일 시스템에 대한 광범위한 접근 권한을 부여하지 마십시오. Flatpak 문서에 따르면 호스트 테마 파일을 노출하면 샌드박스가 약화되고 이식성이 떨어질 수 있습니다. 유지 관리가 잘 되는 테마 확장 프로그램과 제대로 작동하는 데스크톱 통합을 우선적으로 고려하십시오.
• APT를 사용하여 테마를 설치한다고 해서 모든 Flatpak 내부에 자동으로 설치되는 것은 아닙니다. APT는 호스트를 변경합니다. Flatpak 런타임은 여전히 ​​호환되는 확장 프로그램이나 지원되는 설정 경로를 필요로 합니다.
• 다크 모드와 GTK 테마를 혼동하지 마세요. 데스크톱 색 구성표 기본 설정과 전체 GTK 테마는 관련이 있지만 서로 다른 설정입니다. 앱과 해당 런타임이 관련 기본 설정을 지원해야 합니다.
• GNOME 설정을 모두 초기화하거나 테마 폴더를 삭제하지 마십시오. 이러한 작업은 관련 없는 설정을 제거할 수 있으며 누락된 Flatpak 확장 프로그램을 추가하지 않습니다.
• 환경 변수 재정의를 보편적인 해결책으로 사용하지 마십시오. 재정의는 툴킷과 앱에 따라 달라질 수 있으며, 실제 누락된 확장 프로그램이나 포털 문제를 숨길 수도 있습니다.

결과를 ​​확인하세요

해당 확장 프로그램을 업데이트하거나 설치한 후 세션 또는 앱을 다시 시작하여 다음 세 가지 사항을 확인하십시오. 호스트에서 예상 GTK 테마 이름이 여전히 표시되는지, 관련 테마 확장 프로그램이 Flatpak의 설치된 응용 프로그램 목록에 나타나는지, 그리고 해당 앱의 GTK 컨트롤이 이제 예상대로 표시되는지 확인하십시오. 설치된 Flatpak 목록은 다음 명령으로 확인할 수 있습니다.

flatpak list --app

호스트 테마가 올바르고, 앱 런타임에서 확장 프로그램을 사용할 수 없으며, 시각적으로 다른 앱이 하나만 남아 있는 경우, 해당 제한 사항은 Ubuntu 테마의 문제가 아니라 앱 자체의 문제일 수 있습니다. 보고서를 제출할 때는 Flatpak 앱 ID, 런타임 브랜치, 세션 유형, 테마 이름 및 관련 포털 패키지 상태를 포함해 주세요. 이렇게 하면 관리자가 패키징 오류와 데스크톱 설정 문제를 구분하는 데 필요한 세부 정보를 얻을 수 있습니다.

공식 참조

• Flatpak 데스크톱 통합: 테마 및 외관 설정
• Flatpak 확장 기능(GTK 3 테마 확장 기능 포함)
• GTK에서 Flatpak 포털 지원
• Ubuntu Yaru 테마 모음
• Ubuntu 24.04용 xdg-desktop-portal-gtk 패키지 세부 정보