flatpak - بناء وتثبيت وتشغيل التطبيقات ووقت التشغيل
ملخص
flatpak [خيار...] {أمر}
الوصف
Flatpak هي أداة لإدارة التطبيقات وأوقات التشغيل التي تستخدمها. في نموذج Flatpak، يمكن بناء التطبيقات وتوزيعها بشكل مستقل عن نظام التشغيل المضيف الذي يتم استخدامها عليه، وهي معزولة عن نظام التشغيل المضيف ('معزولة') إلى حد ما، في وقت التشغيل.
يمكن أن يعمل Flatpak في وضع على مستوى النظام أو على مستوى المستخدم. تقع بيانات النظام على مستوى النظام (أوقات التشغيل والتطبيقات والتكوين) في $prefix/var/lib/flatpak/، وتقع بيانات المستخدم في $HOME/.local/share/flatpak/. أسفل هذه المواقع، يوجد مستودع محلي في الدليل الفرعي repo/ والتطبيقات وأوقات التشغيل المثبتة في الدليل الفرعي المقابل runtime/ و app/.
يمكن تكوين عمليات التثبيت على مستوى النظام بشكل ثابت عن طريق وضع ملفات flatpakrepo(5) في /usr/share/flatpak/remotes.d/ و /etc/flatpak/remotes.d/. إذا كان هناك ملف بنفس الاسم في كليهما، فسيكون الملف الموجود في /etc هو الأسبقية.
بالإضافة إلى التثبيت على مستوى النظام في $prefix/var/lib/flatpak/، والذي يعتبر دائمًا التثبيت الافتراضي ما لم يتم تجاوزه، يمكن تحديد المزيد من عمليات التثبيت على مستوى النظام عبر ملفات التكوين في /etc/flatpak/installations.d/، والتي يجب أن تحدد على الأقل معرف التثبيت والمسار المطلق إليه. يتم أيضًا دعم معلمات اختيارية أخرى مثل DisplayName و Priority أو StorageType.
يستخدم Flatpak OSTree لتوزيع ونشر البيانات. المستودعات التي يستخدمها هي مستودعات OSTree ويمكن معالجتها باستخدام أداة ostree. يتم توزيع أوقات التشغيل والتطبيقات المثبتة كعمليات فحص OSTree.
تتضمن الأوامر الأساسية لبناء حزم flatpak مثل build-init و build و build-finish في أداة flatpak. للحصول على دعم بناء على مستوى أعلى، راجع أداة flatpak-builder(1) المنفصلة.
يدعم Flatpak التثبيت من مستودعات جانبية. هذه نسخ جزئية من المستودع (تم إنشاؤها بواسطة flatpak create-usb) والتي تستخدم كمصدر تثبيت عندما تكون غير متصل بالإنترنت (وعلى الإنترنت كتحسين للأداء). يتم تكوين هذه المستودعات عن طريق إنشاء روابط رمزية للمصادر الجانبية في الدليل الفرعي sideload-repos في دليل التثبيت (أي عادةً /var/lib/flatpak/sideload-repos أو ~/.local/share/flatpak/sideload-repos). بالإضافة إلى ذلك، يمكن إنشاء روابط رمزية في /run/flatpak/sideload-repos وهو موقع أفضل للمصادر غير الدائمة (حيث يتم مسحه عند إعادة التشغيل). يمكن أن تشير هذه الروابط الرمزية إما إلى الدليل المقدم إلى flatpak create-usb والذي يكتب افتراضيًا إلى المسار الفرعي .ostree/repo، أو مباشرة إلى مستودع ostree.
الخيارات
تُفهم الخيارات العامة التالية. لكل أمر خيارات خاصة به.
-h، --help
عرض خيارات المساعدة والخروج.
-v، --verbose
عرض معلومات التصحيح أثناء معالجة الأوامر. استخدم -vv لمزيد من التفاصيل.
--ostree-verbose
عرض معلومات تصحيح OSTree أثناء معالجة الأوامر.
--version
اطبع معلومات الإصدار واخرج.
--default-arch
اطبع البنية الافتراضية واخرج.
--supported-arches
اطبع البنيات المدعومة بترتيب الأولوية واخرج.
--gl-drivers
اطبع قائمة برامج تشغيل GL النشطة واخرج.
--installations
اطبع مسارات عمليات تثبيت النظام واخرج.
--print-system-only
عند تشغيل الأمر flatpak --print-updated-env، اطبع فقط البيئة لعمليات تثبيت flatpak للنظام، ولا تشتمل على عملية التثبيت في دليل المستخدم.
--print-updated-env
اطبع مجموعة متغيرات البيئة المطلوبة لاستخدام flatpaks، مع تعديل مجموعة متغيرات البيئة الحالية. هذا مخصص للاستخدام في مُنشئ بيئة systemd، ولا ينبغي تشغيله يدويًا.
الأوامر
أوامر لإدارة التطبيقات ووقت التشغيل المثبتة:
flatpak-install(1)
تثبيت تطبيق أو وقت تشغيل من مستودع بعيد أو حزمة.
flatpak-update(1)
تحديث تطبيق أو وقت تشغيل مثبت.
flatpak-uninstall(1)
إلغاء تثبيت تطبيق أو وقت تشغيل مثبت.
flatpak-mask(1)
إخفاء التحديثات والتثبيت التلقائي.
flatpak-pin(1)
تثبيت وقت التشغيل لمنع الإزالة التلقائية.
flatpak-list(1)
عرض قائمة بالتطبيقات ووقت التشغيل المثبتة.
flatpak-info(1)
عرض معلومات لتطبيق أو وقت تشغيل مثبت.
flatpak-history(1)
عرض السجل.
flatpak-config(1)
إدارة تكوين flatpak.
flatpak-repair(1)
إصلاح تثبيت flatpak.
flatpak-create-usb(1)
نسخ التطبيقات و/أو وقت التشغيل إلى وسائط قابلة للإزالة.
أوامر للعثور على التطبيقات ووقت التشغيل:
flatpak-search(1)
البحث عن التطبيقات ووقت التشغيل.
أوامر لإدارة التطبيقات قيد التشغيل:
flatpak-run(1)
تشغيل تطبيق.
flatpak-kill(1)
إيقاف تطبيق قيد التشغيل.
flatpak-override(1)
تجاوز الأذونات لتطبيق.
flatpak-make-current(1)
تحديد الإصدار الافتراضي الذي سيتم تشغيله.
flatpak-enter(1)
الدخول إلى مساحة اسم التطبيق قيد التشغيل.
أوامر لإدارة الوصول إلى الملفات:
flatpak-document-export(1)
منح تطبيق حق الوصول إلى ملف معين.
flatpak-document-unexport(1)
إلغاء حق الوصول إلى ملف معين.
flatpak-document-info(1)
عرض معلومات حول ملف معين.
flatpak-documents(1)
عرض قائمة بالملفات المصدرة.
أوامر لإدارة مخزن الأذونات الديناميكي:
flatpak-permission-remove(1)
إزالة عنصر من مخزن الأذونات.
flatpak-permissions(1)
عرض قائمة بالأذونات.
flatpak-permission-show(1)
عرض أذونات التطبيق.
flatpak-permission-reset(1)
إعادة تعيين أذونات التطبيق.
flatpak-permission-set(1)
تعيين أذونات التطبيق.
أوامر لإدارة المستودعات البعيدة:
flatpak-remotes(1)
عرض قائمة بجميع المستودعات البعيدة التي تم تكوينها.
flatpak-remote-add(1)
إضافة مستودع جديد.
flatpak-remote-modify(1)
تعديل خصائص مستودع مُكوّن.
flatpak-remote-delete(1)
حذف مستودع مُكوّن.
flatpak-remote-ls(1)
عرض محتويات مستودع مُكوّن.
flatpak-remote-info(1)
عرض معلومات حول مرجع في مستودع مُكوّن.
أوامر لبناء التطبيقات:
flatpak-build-init(1)
تهيئة دليل البناء.
flatpak-build(1)
تنفيذ أمر بناء في دليل بناء.
flatpak-build-finish(1)
ينهي دليل البناء للتصدير.
flatpak-build-export(1)
تصدير دليل البناء إلى مستودع.
flatpak-build-bundle(1)
إنشاء ملف حزمة من مرجع في مستودع محلي.
flatpak-build-import-bundle(1)
استيراد ملف حزمة إلى مستودع محلي.
flatpak-build-sign(1)
توقيع تطبيق أو بيئة تشغيل بعد تصديره.
flatpak-build-update-repo(1)
تحديث ملف الملخص في مستودع.
flatpak-build-commit-from(1)
إنشاء التزام جديد بناءً على مرجع موجود.
flatpak-repo(1)
طباعة معلومات حول مستودع.
الأوامر المتاحة داخل البيئة المعزولة:
flatpak-spawn(1)
تشغيل أمر في بيئة معزولة أخرى.
تنسيقات الملفات
تنسيقات الملفات التي تستخدمها أوامر Flatpak:
flatpakref(5)
مرجع لمستودع لتطبيق أو بيئة تشغيل
flatpakrepo(5)
مرجع لمستودع
flatpak-remote(5)
تكوين لمستودع
flatpak-installation(5)
تكوين لموقع تثبيت
flatpak-metadata(5)
معلومات حول تطبيق أو بيئة تشغيل
البيئة
بالإضافة إلى متغيرات البيئة القياسية مثل XDG_DATA_DIRS و XDG_DATA_HOME، يقوم Flatpak باستشارة بعض متغيرات البيئة الخاصة به.
FLATPAK_BINARY
المسار إلى ملف Flatpak القابل للتنفيذ الذي سيتم كتابته في ملفات .desktop والنصوص المصدرة
عند تثبيت تطبيق. الافتراضي هو /usr/bin/flatpak، ما لم يتم تجاوزه في وقت الإنشاء بواسطة
--bindir.
FLATPAK_BWRAP
المسار إلى ملف bwrap(1) القابل للتنفيذ الذي سيتم استخدامه لإنشاء البيئة المعزولة. اعتمادًا على كيفية
تكوين Flatpak في وقت الإنشاء، فإن الافتراضي هو إما البحث في PATH، أو استخدام نسخة مجمعة
عادةً ما يتم تثبيتها على أنها /usr/libexec/flatpak-bwrap.
FLATPAK_CONFIG_DIR
موقع تكوين موقع Flatpak. إذا لم يتم تعيين هذا، فسيتم استخدام /etc/flatpak (ما لم يتم تجاوزه في وقت الإنشاء بواسطة --sysconfdir).
FLATPAK_DATA_DIR
موقع الإعدادات الافتراضية لـ Flatpak على مستوى نظام التشغيل وخطافات التكامل. إذا لم يتم تعيين هذا، فسيتم استخدام
/usr/share/flatpak، ما لم يتم تجاوزه في وقت الإنشاء بواسطة --datadir.
FLATPAK_DBUSPROXY
المسار إلى ملف xdg-dbus-proxy(1) القابل للتنفيذ الذي سيتم استخدامه لتصفية حركة مرور D-Bus بين
البيئة المعزولة ونظام التشغيل المضيف. اعتمادًا على كيفية تكوين Flatpak في وقت الإنشاء، فإن
الافتراضي هو إما البحث في PATH، أو استخدام نسخة مجمعة عادةً ما يتم تثبيتها على أنها
/usr/libexec/flatpak-dbus-proxy.
FLATPAK_DOWNLOAD_TMPDIR
المسار إلى دليل سيتم استخدامه مؤقتًا عند تنزيل طبقات OCI، وربما للتنزيلات الأخرى في المستقبل. لا يتم استخدام
TMPDIR القياسي لهذا، لأن تطبيقات Flatpak تكون في الغالب كبيرة جدًا بحيث لا يمكن أن تتناسب مع tmpfs.
FLATPAK_FANCY_OUTPUT
يمكن تعيينه على 0 لتجنب التنسيق الفاخر عند إخراج البيانات إلى الطرفية. يتم تعطيل هذه الميزة تلقائيًا عندما لا يكون الإخراج القياسي عبارة عن طرفية، أو عندما يتم تعيين G_MESSAGES_DEBUG.
FLATPAK_FORCE_TEXT_AUTH
يمكن تعيينه على 1 لفرض استخدام وكيل polkit(8) مدمج بسيط عند الحاجة إلى المصادقة لتعديل التثبيت على مستوى النظام. بشكل افتراضي، يتم استخدام وكيل polkit الخاص ببيئة سطح المكتب، إذا كان متاحًا، مما يؤدي عادةً إلى ظهور مطالبة رسومية.
FLATPAK_GL_DRIVERS
قائمة مفصولة بنقطتين بامتدادات برنامج تشغيل الرسومات التي سيتم محاولة استخدامها لـ OpenGL و Vulkan وواجهات برمجة التطبيقات المماثلة، مع إعطاء الأولوية للأكثر تفضيلاً أولاً. الافتراضي هو تحديد برنامج تشغيل الرسومات تلقائيًا. تتطابق القيم في هذه القائمة مع المكون الأخير المفصول بنقطة من أسماء الامتدادات ذات حالة active-gl-driver. تتضمن القيم النموذجية default أو mesa-git أو nvidia-550-120 (مع استبدال رقم الإصدار برقم الإصدار الرئيسي والثانوي لوحدة نمط nvidia kernel module).
FLATPAK_RUN_DIR
موقع الملفات العامة لوقت تشغيل flatpak. إذا لم يتم تعيين هذا، فسيتم استخدام /run/flatpak.
FLATPAK_SYSTEM_CACHE_DIR
الموقع الذي سيتم فيه إنشاء المستودعات الفرعية المؤقتة أثناء عمليات الجلب إلى التثبيت على مستوى النظام. إذا لم يتم تعيين هذا، فسيتم استخدام دليل في /var/tmp/. هذا مفيد لأنه من المرجح أن يكون على نفس نظام الملفات مثل مستودع النظام (وبالتالي زيادة فرص نسخ الروابط، على سبيل المثال)، ويمكننا تجنب ملء دليل المستخدم بالبيانات المؤقتة.
FLATPAK_SYSTEM_DIR
موقع التثبيت الافتراضي على مستوى النظام. إذا لم يتم تعيين هذا، فسيتم استخدام /var/lib/flatpak (إلا إذا تم تجاوزه في وقت الإنشاء بواسطة --localstatedir أو -Dsystem_install_dir).
FLATPAK_TTY_PROGRESS
يمكن تعيينه على 1 لتمكين الإبلاغ عن التقدم القابل للقراءة آليًا إلى الطرفية. لا يتم تمكين هذه الميزة افتراضيًا لأنها تستخدم تسلسل OSC 9;4، والذي تفسره بعض محاكيات الطرفية على أنها إشعار منبثق.
FLATPAK_USER_DIR
موقع التثبيت الخاص بالمستخدم. إذا لم يتم تعيين هذا، فسيتم استخدام $XDG_DATA_HOME/flatpak.
انظر أيضا
ostree(1)، ostree.repo(5)، flatpak-remote(5)، flatpak-installation(5)، https://www.flatpak.org