FLATPAK UPDATE(1) flatpak update FLATPAK UPDATE(1)

flatpak-update - به‌روزرسانی یک برنامه یا محیط زمان اجرا (runtime)

flatpak update [OPTION...] [REF...]

flatpak update [OPTION...] --appstream [REMOTE]

برنامه‌ها و محیط‌های زمان اجرا (runtimes) را به‌روزرسانی می‌کند. REF ارجاعی به برنامه یا محیط زمان اجرا برای به‌روزرسانی است. اگر هیچ REF مشخص نشود، همه چیز به‌روزرسانی خواهد شد، همراه با اطلاعات appstream برای تمام ریموت‌ها.

هر آرگومان REF یک شناسهٔ کامل یا جزئی در قالب ref فلت‌پک است که به صورت "(app|runtime)/ID/ARCH/BRANCH" می‌باشد. تمام بخش‌ها به جز ID اختیاری بوده و می‌توان آن‌ها را به همراه اسلش‌ها حذف کرد، بنابراین در بیشتر مواقع تنها کافی است ID را مشخص کنید. هر بخشِ حذف‌شده با موارد نصب‌شده مطابقت داده می‌شود و در صورت وجود چندین تطابق، پیام خطایی گزینه‌های موجود را فهرست خواهد کرد.

به‌طور پیش‌فرض این دستور به دنبال هر دو مورد برنامه‌ها و محیط‌های زمان اجرا با REF داده‌شده می‌گردد، اما می‌توانید این بررسی را با استفاده از گزینهٔ --app یا --runtime، یا با درج بخش ابتدایی در REF محدود کنید.

به‌طور معمول، این دستور برنامه را به آخرین کامیت شاخهٔ آن (tip of branch) به‌روزرسانی می‌کند. اما با گزینهٔ --commit امکان بررسی و استفاده از کامیت دیگری نیز وجود دارد.

اگر ریموت پیکربندی‌شده برای مرجع (ref) در حال به‌روزرسانی، دارای یک شناسهٔ مجموعه (collection ID) باشد، فلت‌پک پوشه‌های sideload-repos پیکربندی‌شده با گزینهٔ --sideload-repo، یا بر اساس هر نصب یا در سطح کل سیستم را جستجو خواهد کرد (نگاه کنید به flatpak(1)).

برای ریموت‌های OCI، مخازن بارگذاری جانبی (sideload) را می‌توان به صورت --sideload-repo=oci:PATH یا --sideload-repo=oci-archive:PATH نیز مشخص کرد، که در آن path به یک چیدمان ایمیج OCI یا بایگانی چیدمان ایمیج OCI اشاره دارد. (نگاه کنید به containers-transports(5).) هنگامی که به این شیوه مشخص شود، ایمیج‌های موجود در چیدمان ایمیج بدون توجه به شناسهٔ مجموعه برای تمام ریموت‌های OCI در دسترس خواهند بود. به همین دلیل، معادل پوشه‌ای برای آن وجود ندارد - تنها می‌توان آن را در خط فرمان مشخص کرد.

توجه داشته باشید که به‌روزرسانی یک ران‌تایم با نصب شاخه‌ای دیگر متفاوت است و انتظار می‌رود به‌روزرسانی‌های ران‌تایم سازگاری دقیق را حفظ کنند. اگر به‌روزرسانی یک برنامه مشکلی ایجاد کند، می‌توان با استفاده از گزینهٔ --commit به نسخهٔ قبلی بازگشت.

علاوه بر به‌روزرسانی‌ها، این دستور پیشنهاد حذف ران‌تایم‌های بدون استفاده و به پایان عمر رسیده (end-of-life) را ارائه می‌دهد. ران‌تایم‌هایی که به صراحت نصب شده‌اند (نه به عنوان وابستگی) یا به صراحت سنجاق شده‌اند (نگاه کنید به flatpak-pin(1)) حتی اگر بلااستفاده و به پایان عمر رسیده باشند، همچنان نصب‌شده باقی می‌مانند.

مگر اینکه با گزینه‌های --user، --system یا --installation نادیده گرفته شود، این دستور هرگونه ref منطبق را هم در نصب سراسری پیش‌فرض سیستم و هم در نصب ویژهٔ کاربر به‌روزرسانی می‌کند.

گزینه‌های زیر پشتیبانی می‌شوند:

-h, --help

نمایش گزینه‌های راهنما و خروج.

-u, --user

به‌روزرسانی در سطح نصب کاربری (per-user).

--system

به‌روزرسانی در سطح نصب سراسری و پیش‌فرض سیستم.

--installation=NAME

به‌روزرسانی یک نصب سراسری سیستم که با NAME از میان موارد تعریف‌شده در /etc/flatpak/installations.d/ مشخص شده است. استفاده از --installation=default معادل استفاده از --system است.

--arch=ARCH

معماری مورد نظر برای به‌روزرسانی. برای دیدن معماری‌های پشتیبانی‌شده توسط سیستم میزبان به flatpak --supported-arches مراجعه کنید.

--subpath=PATH

نصب فقط یک زیرمسیر از مرجع (ref). این گزینه عمدتاً برای نصب زیرمجموعه‌ای از زبان‌ها (locales) استفاده می‌شود. برای نصب چندین زیرمسیر می‌توان این گزینه را چندین بار تکرار کرد. در صورت عدم تعیین، زیرمسیرهای مشخص‌شده در زمان نصب مجدداً استفاده می‌شوند.

--commit=COMMIT

به‌روزرسانی به این کامیت خاص به جای انتهای شاخه. می‌توانید کامیت‌ها را با استفاده از flatpak remote-info --log REMOTE REF پیدا کنید.

--no-deploy

دانلود آخرین نسخه، اما عدم استقرار (deploy) آن.

--no-pull

عدم دانلود آخرین نسخه و استقرار هر آنچه که در حال حاضر به صورت محلی در دسترس است.

--no-related

عدم دانلود افزونه‌های مرتبط، مانند داده‌های زبان (locale).

--no-deps

عدم به‌روزرسانی یا نصب پیش‌نیازهای زمان اجرا هنگام نصب.

--app

تنها جستجو برای برنامه‌ای با نام داده‌شده.

--appstream

به‌روزرسانی appstream برای REMOTE، یا تمام ریموت‌ها در صورت عدم تعیین ریموت.

--runtime

تنها جستجو برای ران‌تایمی با نام داده‌شده.

--sideload-repo=PATH

افزودن یک مخزن محلی ostree اضافی به عنوان منبع نصب. این کار معادل استفاده از پوشه‌های sideload-repos (نگاه کنید به flatpak(1)) است، اما می‌تواند به ازای هر دستور انجام شود. هر مسیری که در اینجا افزوده شود علاوه بر مسیرهای آن پوشه‌ها استفاده خواهد شد.

-y, --assumeyes

پاسخ مثبت (بله) خودکار به تمام پرسش‌ها (یا انتخاب پاسخی با بالاترین اولویت). برای خودکارسازی فرآیندها مفید است.

--noninteractive

تولید حداقل خروجی و پرهیز از پرسیدن اکثر سوالات. برای استفاده در سناریوهای غیرتعاملی، مانند اسکریپت‌های بیلد مناسب است.

--force-remove

حذف فایل‌های قدیمی حتی اگر توسط یک برنامهٔ در حال اجرا استفاده شوند.

-v, --verbose

چاپ اطلاعات اشکال‌زدایی در طول پردازش دستور.

--ostree-verbose

چاپ اطلاعات اشکال‌زدایی OSTree در طول پردازش دستور.

$ flatpak --user update org.gnome.gedit

flatpak(1), flatpak-install(1), flatpak-list(1), ostree-find-remotes(1)

flatpak