حل مشكلة عدم توافق تطبيقات Flatpak مع سمة GTK في أوبونتو 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.

توفر لوحة إعدادات أوبونتو 24.04 نمطين لسطح المكتب: فاتح وداكن. هذا الخيار لا يعني بالضرورة استخدام جميع التطبيقات لنمط Yaru GTK 3. تطبيقات GTK 4 المبنية باستخدام مكتبة libadwaita تتبع عمومًا تفضيلات مظهر النظام المدعومة، ولكنها لا تقبل بالضرورة أي تعديلات عشوائية على أنماط GTK القديمة. إضافة سمة Flatpak تحمل اسم GTK 3 لن تُعيد تصميم جميع تطبيقات GTK 4 أو libadwaita.

للحصول على نظرة عامة فنية، راجع وثائق تكامل سطح المكتب وتخصيص السمات الخاصة بـ Flatpak ووثائق دعم بوابة GTK الخاصة بها .

1. تأكد من نمط سطح المكتب واسم السمة

افتح الإعدادات > المظهر ، ثم اختر النمط الفاتح أو الداكن. سيتم تطبيق الاختيار على سطح المكتب فورًا. إذا كنت تستخدم GNOME Tweaks أو أي أداة أخرى لاختيار سمة GTK مخصصة، فدوّن اسم السمة بدقة؛ فقد تختلف أسماء الحزم عن أسماء السمات في حالة الأحرف أو اللواحق.

يمكنك قراءة اسم سمة GTK النشطة وتفضيل نظام الألوان في Terminal:

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

يُظهر الأمر الأول اسم السمة المخزنة في إعدادات جنوم، بينما يُظهر الأمر الثاني نمط العرض المفضل (فاتح/داكن) عند دعمه. تُفحص هذه الأوامر القيم فقط. تجنب استخدام اسم سمة منسوخ من دليل تعليمي إلا إذا كانت تلك السمة مُثبتة وتعتزم استخدامها. أعد تشغيل التطبيق المتأثر بعد تغيير إعدادات المظهر، لأن العديد من البرامج تقرأ سماتها عند التشغيل.

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

يُعرّف موقع Flathub سمة Yaru-light على أنها حزمة سمات GTK. يعتمد اسم السمة المطابق على إعدادات المضيف وما ينشره الخادم البعيد حاليًا. إذا كنت تستخدم إصدارًا مختلفًا من Yaru أو سمة من طرف ثالث، فاستخدم flatpak searchقائمة الخادم البعيد للعثور على مُعرّف الامتداد الدقيق؛ لا تفترض لاحقة الحزمة من اسمها الظاهر.

إذا كان القالب مُثبّتًا ولكن التطبيق كان قيد التشغيل بالفعل، فأغلق جميع نوافذه وأعد فتحه. في حالة استمرار المشكلة، قم بالتحديث مرة أخرى بعد التأكد من أن الإضافة والتطبيق من نفس تثبيت Flatpak.

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

يُفرّق Flatpak بين تثبيتات المستخدم الفردية وتثبيتات النظام. إذا قمت بتثبيت التطبيق باستخدام `flatpak.com` --userولكنك ثبّت الإضافة على مستوى النظام، أو العكس، فقد لا يتعرّف التطبيق على الإضافة في المكان المتوقع. لذا، يُنصح بإبقاء التطبيق والإضافة ضمن نطاق التثبيت نفسه قدر الإمكان. يمكنك فحص تثبيت تطبيق مُحدد باستخدام `flatpak.com` flatpak info APP_ID.

3. تحقق من بوابة سطح المكتب على نظام التشغيل أوبونتو 24.04

تُشير وثائق بوابة Flatpak الخاصة بـ GTK إلى أن هذه الحزمة xdg-desktop-portal-gtkمطلوبة لسمات وخطوط GTK. تُصدر أوبونتو هذه الواجهة الخلفية لإصدار Noble (24.04 LTS). في حال عدم وجود الحزمة، يُرجى تثبيتها من مستودعات أوبونتو.

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

يستخدم نظام أوبونتو جنوم أيضًا واجهة بوابة جنوم الخلفية لميزات البوابة الخاصة بسطح المكتب. لا يعني تثبيت واجهة GTK الخلفية إزالة واجهة جنوم الخلفية أو استبدالها. احتفظ بحزم البوابة المتوفرة لبيئة سطح المكتب لديك. بعد التثبيت، سجّل الخروج ثم سجّل الدخول مرة أخرى، أو أعد تشغيل خدمة بوابة المستخدم ثم أعد تشغيل التطبيق المتأثر.

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

إذا أبلغ نظام systemd بأن الوحدة غير متاحة، فقم بتسجيل الخروج ثم تسجيل الدخول مرة أخرى. قد تختلف تفاصيل تفعيل البوابة الإلكترونية باختلاف حالة الجلسة والحزمة. تؤكد قائمة حزم أوبونتو أن حزمة xdg-desktop-portal-gtk متوفرة لنظام أوبونتو 24.04 .

4. تحديد ما إذا كان بإمكان التطبيق استخدام السمة

جرّب أكثر من تطبيق GTK 3 Flatpak واحد إن أمكن. إذا كانت عدة تطبيقات GTK 3 تتبع الآن نفس المظهر بينما لا يتبعه تطبيق واحد، فقد تكون المشكلة المتبقية خاصة بهذا التطبيق أو ببيئة تشغيله. إذا كانت تطبيقات GTK 3 تعمل، ولكن تطبيق GNOME حديث لا يزال يظهر بلون مميز أو مظهر مختلف للأدوات، فهذا أمر متوقع: لا تنطبق إضافات مظهر GTK 3 على GTK 4/libadwaita بنفس الطريقة.

تستخدم بعض التطبيقات Qt أو Electron أو أدوات واجهة مستخدم خاصة بها، حتى وإن بدت مشابهة لتطبيقات جنوم. في هذه الحالة، قد لا يكون لإضافة سمة GTK أي تأثير. راجع الوثائق الرسمية للتطبيق لمعرفة خيارات المظهر المدعومة قبل تغيير أذونات Flatpak. بالنسبة لتطبيق Flatpak المُثبَّت من Flathub، افحص مُعرِّف التطبيق ووقت التشغيل باستخدام الأمر التالي:

flatpak info APP_ID

استبدل APP_IDبمعرف التطبيق الموضح بواسطة flatpak list --app. يساعد الناتج في تحديد وقت التشغيل ونطاق التثبيت؛ ولا يخبرك دائمًا بمجموعة الأدوات، لذا تأكد من مجموعة الأدوات من وثائق التطبيق أو صفحة المشروع عند الحاجة.

حلول شائعة لتجنب

• لا تمنح صلاحيات وصول واسعة لنظام ملفات النظام المضيف لمجرد نسخ المظهر. توثق Flatpak امتدادات السمات وتكامل البوابة/XSettings كطرق معتادة. يؤدي الوصول الواسع إلى إضعاف عزل بيئة الحماية، وقد يفشل حتى في حال اختلاف إصدارات GTK بين النظام المضيف ووقت التشغيل.
• لا تستخدم إضافة سمة GTK 3 كمفتاح عام للوضع الداكن. فهي تحتوي على ملفات سمات لتطبيقات GTK 3 المتوافقة؛ أما دعم نظام الألوان فهو إعداد منفصل يجب أن يفهمه التطبيق والبوابة.
• لا تقم بإعادة تثبيت التطبيق قبل التحقق من ملحقاته وبيئة التشغيل الخاصة به. قد تؤدي إعادة التثبيت إلى جلب بيئة التشغيل نفسها دون تغيير السمة المفقودة أو حالة البوابة.
• لا تُغيّر إعدادات البوابة العامة كخطوة أولى. فخيارات واجهة المستخدم في أوبونتو جنوم مرتبطة بكل جلسة. وقد يؤثر تغيير إعدادات البوابة على مُنتقي الملفات وتكاملات سطح المكتب الأخرى، بالإضافة إلى تغيير المظهر.

قائمة التحقق من الصحة

• تعرض إعدادات أوبونتو النمط الفاتح أو الداكن المطلوب.
• اسم سمة GTK المضيفة معروف، ويتوفر ملحق GTK 3 مطابق لـ Flatpak.
• flatpak updateتم الانتهاء، والتطبيق وملحق القالب ضمن نطاق تثبيت متوافق.
• تم تثبيت الحزمة xdg-desktop-portal-gtk؛ وبعد إجراء التغييرات، تمت إعادة تشغيل جلسة المستخدم أو البوابة.
• تم إغلاق التطبيق المتأثر بالكامل ثم إعادة فتحه.
• لقد قارنت التطبيقات حسب مجموعة الأدوات: GTK 3، GTK 4/libadwaita، Qt، أو Electron يمكن أن تستجيب بشكل مختلف.

إذا اجتازت قائمة التحقق بنجاح وبقي أحد التطبيقات دون تغيير، فإن الخطوة التالية الأكثر فائدة هي مراجعة نظام تتبع المشكلات أو وثائق ذلك التطبيق، مع ذكر معرّف Flatpak الخاص به، ووقت التشغيل، ونوع جلسة Ubuntu (Wayland أو X11)، ومخرجات الأمرَين اللذين يعملان للقراءة فقط gsettings. يساعد هذا في التمييز بين خيار تصميم خاص بالتطبيق ومكوّن تكامل سطح المكتب المفقود، دون التأثير على بيئة الحماية.

يشرح دليل مستخدم أوبونتو الحالي عناصر التحكم في الوضع الفاتح/الداكن في الإعدادات > المظهر . قد يختلف سلوك Flatpak باختلاف إصداره، ووقت تشغيل التطبيق، وواجهة البوابة الخلفية، ومجموعة الأدوات، والبيانات الوصفية البعيدة؛ إذا لم يتم تضمين المظهر النشط في حزمة وقت التشغيل، فقد يستمر التطبيق في استخدام مظهره الافتراضي.