แก้ไขปัญหาแอป Flatpak ไม่รองรับธีม GTK ใน Ubuntu 24.04

ข้อมูลอ้างอิงโดยย่อ: วิธีใดที่มักจะช่วยแก้ไขความไม่ตรงกันนี้ได้

หากแอป Flatpak บน Ubuntu 24.04 เปิดขึ้นมาโดยใช้ธีม Adwaita หรืออินเทอร์เฟซสีอ่อน ในขณะที่เดสก์ท็อปตั้งค่าเป็นสีเข้ม ให้ตรวจสอบก่อนว่าแอปนั้นใช้ GTK 3 หรือ GTK 4/libadwaita จากนั้นอัปเดต Flatpak ทำให้ส่วนขยายธีม GTK 3 ที่ตรงกันพร้อมใช้งาน และยืนยันว่าได้ติดตั้งพอร์ทัลเดสก์ท็อปแล้ว แอป Flatpak ทำงานในสภาพแวดล้อมแบบแซนด์บ็อกซ์ ดังนั้นจึงไม่ได้อ่านไฟล์ธีมทุกไฟล์ที่ติดตั้งบนโฮสต์ Ubuntu โดยอัตโนมัติ

ขั้นตอนเหล่านี้ใช้ได้กับแอปพลิเคชัน Flatpak บน Ubuntu 24.04 โดยเฉพาะอย่างยิ่งแอปพลิเคชันที่ติดตั้งจาก Flathub ขั้นตอนเหล่านี้ไม่ได้บังคับให้ทุกแอปพลิเคชันใช้รูปแบบเดสก์ท็อปของ 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 แอปพลิเคชัน GTK 4 ที่สร้างด้วย libadwaita โดยทั่วไปจะปฏิบัติตามการตั้งค่าลักษณะที่ปรากฏของระบบที่รองรับ แต่ไม่ได้หมายความว่าจะยอมรับการแทนที่ธีม GTK รุ่นเก่าโดยพลการ ส่วนขยายธีม flatpak ที่ตั้งชื่อสำหรับ GTK 3 จะไม่เปลี่ยนรูปแบบแอปพลิเคชัน GTK 4 หรือ libadwaita ทุกแอป

สำหรับภาพรวมทางเทคนิค โปรดดูเอกสารเกี่ยวกับการผสานรวมและการกำหนดธีมบนเดสก์ท็อปของ Flatpakและเอกสารเกี่ยวกับการสนับสนุนพอร์ทัล GTK ของ Flatpak

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

หากแอปยังคงใช้ธีมสำรอง ให้แสดงรายการส่วนขยายธีม GTK ที่ Flathub เปิดเผย:

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

รายการธีม Yaru-lightของ Flathub ระบุว่าเป็นแพ็กเกจธีม GTK ชื่อธีมที่ตรงกันจะขึ้นอยู่กับการตั้งค่าโฮสต์และสิ่งที่รีโมตเผยแพร่อยู่ในปัจจุบัน หากคุณใช้ Yaru เวอร์ชันอื่นหรือธีมจากผู้พัฒนาภายนอก ให้ใช้flatpak searchรายการรีโมตเพื่อค้นหา ID ส่วนขยายที่แน่นอน อย่าเดาคำต่อท้ายแพ็กเกจจากชื่อที่แสดง

หากติดตั้งธีมแล้ว แต่แอปพลิเคชันกำลังทำงานอยู่ ให้ปิดหน้าต่างทั้งหมดของแอปพลิเคชันนั้น แล้วเปิดใหม่อีกครั้ง สำหรับกรณีที่แก้ไขยาก ให้ลองอัปเดตอีกครั้งหลังจากตรวจสอบแล้วว่าส่วนขยายและแอปพลิเคชันมาจาก Flatpak เดียวกัน

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

Flatpak แยกความแตกต่างระหว่างการติดตั้งแบบต่อผู้ใช้และการติดตั้งแบบต่อระบบ หากคุณติดตั้งแอปแบบต่อผู้ใช้--userแต่ติดตั้งส่วนขยายแบบต่อระบบ หรือในทางกลับกัน แอปอาจมองไม่เห็นส่วนขยายในตำแหน่งที่คาดหวังไว้ ควรติดตั้งแอปและส่วนขยายไว้ในขอบเขตการติดตั้งเดียวกันหากเป็นไปได้ คุณสามารถตรวจสอบการติดตั้งของแอปเฉพาะได้ด้วยคำสั่ง `sudo apt install flatpak info APP_IDflatpak`

3. ตรวจสอบพอร์ทัลบนเดสก์ท็อปใน Ubuntu 24.04

เอกสารประกอบของพอร์ทัล Flatpak ของ GTK ระบุว่าxdg-desktop-portal-gtkจำเป็นต้องใช้ธีมและฟอนต์ของ GTK 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. ตัดสินใจว่าแอปสามารถใช้ธีมนั้นได้หรือไม่

ถ้าเป็นไปได้ ให้ลองทดสอบ Flatpak GTK 3 มากกว่าหนึ่งตัว หากแอป GTK 3 หลายตัวใช้ธีมเดียวกันได้ แต่มีแอปหนึ่งที่ใช้ไม่ได้ ปัญหาที่เหลืออยู่อาจเป็นเฉพาะแอปนั้นหรือรันไทม์ของแอปนั้น หากแอป GTK 3 ทำงานได้ แต่แอป GNOME รุ่นใหม่ยังมีสีเน้นหรือลักษณะวิดเจ็ตที่แตกต่างออกไป ก็เป็นเรื่องที่คาดการณ์ได้ เพราะส่วนขยายธีม GTK 3 ไม่สามารถนำไปใช้กับ GTK 4/libadwaita ได้ในลักษณะเดียวกัน

แอปบางแอปใช้ Qt, Electron หรือชุดเครื่องมืออินเทอร์เฟซของตนเอง แม้ว่าจะดูคล้ายกับแอปพลิเคชัน GNOME ก็ตาม ในกรณีเช่นนั้น ส่วนขยายธีม GTK อาจไม่มีผลใดๆ ตรวจสอบเอกสารอย่างเป็นทางการของแอปสำหรับตัวเลือกการแสดงผลที่รองรับก่อนที่จะเปลี่ยนสิทธิ์ Flatpak สำหรับ Flatpak ที่ติดตั้งจาก Flathub ให้ตรวจสอบ ID แอปและรันไทม์ด้วยคำสั่ง:

flatpak info APP_ID

แทนที่APP_IDด้วยรหัสแอปพลิเคชันที่แสดงโดยflatpak list --appผลลัพธ์จะช่วยระบุรันไทม์และขอบเขตการติดตั้ง แต่ไม่ได้บอกถึงชุดเครื่องมือเสมอไป ดังนั้นโปรดตรวจสอบชุดเครื่องมือจากเอกสารประกอบของแอปพลิเคชันหรือหน้าโครงการเมื่อจำเป็น

วิธีแก้ไขทั่วไปที่ควรหลีกเลี่ยง

• อย่าให้สิทธิ์การเข้าถึงระบบไฟล์ของโฮสต์อย่างกว้างขวางเพียงเพื่อคัดลอกรูปลักษณ์ Flatpak ระบุส่วนขยายธีมและการรวมพอร์ทัล/XSettings เป็นวิธีการปกติ การเข้าถึงอย่างกว้างขวางจะทำให้การแยกแซนด์บ็อกซ์อ่อนแอลง และอาจยังคงล้มเหลวได้เมื่อเวอร์ชัน GTK ของโฮสต์และรันไทม์แตกต่างกัน
• อย่าใช้ส่วนขยายธีม GTK 3 เป็นตัวสลับโหมดมืดแบบทั่วไป ส่วนขยายนี้มีไฟล์ธีมสำหรับแอป GTK 3 ที่เข้ากันได้เท่านั้น การรองรับโทนสีของระบบเป็นการตั้งค่าแยกต่างหากที่แอปและพอร์ทัลต้องเข้าใจ
• อย่าติดตั้งแอปพลิเคชันใหม่ก่อนที่จะตรวจสอบส่วนขยายและรันไทม์การติดตั้งใหม่อาจดึงรันไทม์เดิมมาโดยไม่เปลี่ยนแปลงธีมที่หายไปหรือเงื่อนไขของพอร์ทัล
• อย่าเปลี่ยนการตั้งค่าพอร์ทัลส่วนกลางเป็นขั้นตอนแรกการเลือกแบ็กเอนด์ของ Ubuntu GNOME นั้นเป็นแบบเฉพาะเซสชัน การแทนที่การตั้งค่าพอร์ทัลอาจส่งผลต่อตัวเลือกไฟล์และการทำงานร่วมกันบนเดสก์ท็อปอื่นๆ นอกเหนือจากการปรับแต่งธีม

รายการตรวจสอบการยืนยัน

• การตั้งค่า Ubuntu จะแสดงรูปแบบสว่างหรือมืดตามที่ต้องการ
• ทราบชื่อธีม GTK ของโฮสต์แล้ว และมีส่วนขยาย GTK 3 ที่ตรงกันพร้อมใช้งานสำหรับ Flatpak
• flatpak updateเสร็จสมบูรณ์แล้ว และแอปและส่วนขยายธีมอยู่ในขอบเขตการติดตั้งที่เข้ากันได้
• แพ็กxdg-desktop-portal-gtkเกจได้รับการติดตั้งแล้ว หลังจากทำการเปลี่ยนแปลง ระบบได้รีสตาร์ทเซสชันผู้ใช้หรือพอร์ทัลแล้ว
• แอปพลิเคชันที่ได้รับผลกระทบถูกปิดและเปิดใหม่อีกครั้ง
• คุณเปรียบเทียบแอปพลิเคชันโดยใช้ชุดเครื่องมือที่แตกต่างกัน: GTK 3, GTK 4/libadwaita, Qt หรือ Electron อาจให้ผลลัพธ์ที่แตกต่างกัน

หากตรวจสอบตามรายการตรวจสอบแล้ว และแอปพลิเคชันหนึ่งยังคงไม่เปลี่ยนแปลง ขั้นตอนต่อไปที่มีประโยชน์ที่สุดคือการตรวจสอบตัวติดตามปัญหาหรือเอกสารประกอบของแอปพลิเคชันนั้น โดยระบุ Flatpak ID, รันไทม์, ประเภทเซสชัน Ubuntu (Wayland หรือ X11) และผลลัพธ์ของคำสั่งอ่านอย่างเดียวสองgsettingsคำสั่ง วิธีนี้จะช่วยแยกแยะความแตกต่างระหว่างการเลือกรูปแบบเฉพาะของแอปพลิเคชันกับการขาดส่วนประกอบการรวมเดสก์ท็อป โดยไม่ทำให้ระบบรักษาความปลอดภัยอ่อนแอลง

คู่มือผู้ใช้ปัจจุบันของ Ubuntu อธิบายการควบคุมโหมดสว่าง/มืดไว้ในการตั้งค่า > ลักษณะที่ปรากฏพฤติกรรมของ Flatpak อาจแตกต่างกันไปตามเวอร์ชัน รันไทม์ของแอป แบ็กเอนด์ของพอร์ทัล ชุดเครื่องมือ และเมตาเดตาจากระยะไกล หากธีมที่ใช้งานอยู่ไม่ได้ถูกบรรจุไว้สำหรับรันไทม์ แอปอาจยังคงใช้ลักษณะที่ปรากฏเริ่มต้นของตัวเองต่อไป