'\" t
.\"     Title: flatpak update
.\"    Author: Alexander Larsson <alexl@redhat.com>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 08/27/2026
.\"    Manual: flatpak update
.\"    Source: flatpak
.\"  Language: English
.\"
.TH "FLATPAK UPDATE" "1" "" "flatpak" "flatpak update"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
flatpak-update \- به‌روزرسانی یک برنامه یا محیط زمان اجرا (runtime)
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBflatpak\ update\fR\ 'u
\fBflatpak update\fR [OPTION...] [REF...]
.HP \w'\fBflatpak\ update\fR\ 'u
\fBflatpak update\fR [OPTION...] \-\-appstream [REMOTE]
.SH "توضیحات (DESCRIPTION)"
.PP
برنامه‌ها و محیط‌های زمان اجرا (runtimes) را به‌روزرسانی می‌کند\&.
REF
ارجاعی به برنامه یا محیط زمان اجرا برای به‌روزرسانی است\&. اگر هیچ
REF
مشخص نشود، همه چیز به‌روزرسانی خواهد شد، همراه با اطلاعات appstream برای تمام ریموت‌ها\&.
.PP
هر آرگومان
REF
یک شناسهٔ کامل یا جزئی در قالب ref فلت‌پک است که به صورت "(app|runtime)/ID/ARCH/BRANCH" می‌باشد\&. تمام بخش‌ها به جز ID اختیاری بوده و می‌توان آن‌ها را به همراه اسلش‌ها حذف کرد، بنابراین در بیشتر مواقع تنها کافی است ID را مشخص کنید\&. هر بخشِ حذف‌شده با موارد نصب‌شده مطابقت داده می‌شود و در صورت وجود چندین تطابق، پیام خطایی گزینه‌های موجود را فهرست خواهد کرد\&.
.PP
به‌طور پیش‌فرض این دستور به دنبال هر دو مورد برنامه‌ها و محیط‌های زمان اجرا با
REF
داده‌شده می‌گردد، اما می‌توانید این بررسی را با استفاده از گزینهٔ
\fB\-\-app\fR
یا
\fB\-\-runtime\fR،
یا با درج بخش ابتدایی در
REF
محدود کنید\&.
.PP
به‌طور معمول، این دستور برنامه را به آخرین کامیت شاخهٔ آن (tip of branch) به‌روزرسانی می‌کند\&. اما با گزینهٔ
\fB\-\-commit\fR
امکان بررسی و استفاده از کامیت دیگری نیز وجود دارد\&.
.PP
اگر ریموت پیکربندی‌شده برای مرجع (ref) در حال به‌روزرسانی، دارای یک شناسهٔ مجموعه (collection ID) باشد، فلت‌پک پوشه‌های
sideload\-repos
پیکربندی‌شده با گزینهٔ
\fB\-\-sideload\-repo\fR،
یا بر اساس هر نصب یا در سطح کل سیستم را جستجو خواهد کرد (نگاه کنید به
\fBflatpak\fR(1))\&.
.PP
برای ریموت‌های OCI، مخازن بارگذاری جانبی (sideload) را می‌توان به صورت
\fB\-\-sideload\-repo=oci:PATH\fR
یا
\fB\-\-sideload\-repo=oci\-archive:PATH\fR
نیز مشخص کرد، که در آن path به یک چیدمان ایمیج OCI یا بایگانی چیدمان ایمیج OCI اشاره دارد\&. (نگاه کنید به
\fBcontainers-transports\fR(5)\&.)
هنگامی که به این شیوه مشخص شود، ایمیج‌های موجود در چیدمان ایمیج بدون توجه به شناسهٔ مجموعه برای تمام ریموت‌های OCI در دسترس خواهند بود\&. به همین دلیل، معادل پوشه‌ای برای آن وجود ندارد \- تنها می‌توان آن را در خط فرمان مشخص کرد\&.
.PP
توجه داشته باشید که به‌روزرسانی یک ران‌تایم با نصب شاخه‌ای دیگر متفاوت است و انتظار می‌رود به‌روزرسانی‌های ران‌تایم سازگاری دقیق را حفظ کنند\&. اگر به‌روزرسانی یک برنامه مشکلی ایجاد کند، می‌توان با استفاده از گزینهٔ
\fB\-\-commit\fR
به نسخهٔ قبلی بازگشت\&.
.PP
علاوه بر به‌روزرسانی‌ها، این دستور پیشنهاد حذف ران‌تایم‌های بدون استفاده و به پایان عمر رسیده (end\-of\-life) را ارائه می‌دهد\&. ران‌تایم‌هایی که به صراحت نصب شده‌اند (نه به عنوان وابستگی) یا به صراحت سنجاق شده‌اند (نگاه کنید به
\fBflatpak-pin\fR(1))
حتی اگر بلااستفاده و به پایان عمر رسیده باشند، همچنان نصب‌شده باقی می‌مانند\&.
.PP
مگر اینکه با گزینه‌های
\fB\-\-user\fR،
\fB\-\-system\fR
یا
\fB\-\-installation\fR
نادیده گرفته شود، این دستور هرگونه ref منطبق را هم در نصب سراسری پیش‌فرض سیستم و هم در نصب ویژهٔ کاربر به‌روزرسانی می‌کند\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش گزینه‌های راهنما و خروج\&.
.RE
.PP
\fB\-u\fR, \fB\-\-user\fR
.RS 4
به‌روزرسانی در سطح نصب کاربری (per\-user)\&.
.RE
.PP
\fB\-\-system\fR
.RS 4
به‌روزرسانی در سطح نصب سراسری و پیش‌فرض سیستم\&.
.RE
.PP
\fB\-\-installation=NAME\fR
.RS 4
به‌روزرسانی یک نصب سراسری سیستم که با
NAME
از میان موارد تعریف‌شده در
/etc/flatpak/installations\&.d/
مشخص شده است\&. استفاده از
\fB\-\-installation=default\fR
معادل استفاده از
\fB\-\-system\fR
است\&.
.RE
.PP
\fB\-\-arch=ARCH\fR
.RS 4
معماری مورد نظر برای به‌روزرسانی\&. برای دیدن معماری‌های پشتیبانی‌شده توسط سیستم میزبان به
\fBflatpak \-\-supported\-arches\fR
مراجعه کنید\&.
.RE
.PP
\fB\-\-subpath=PATH\fR
.RS 4
نصب فقط یک زیرمسیر از مرجع (ref)\&. این گزینه عمدتاً برای نصب زیرمجموعه‌ای از زبان‌ها (locales) استفاده می‌شود\&. برای نصب چندین زیرمسیر می‌توان این گزینه را چندین بار تکرار کرد\&. در صورت عدم تعیین، زیرمسیرهای مشخص‌شده در زمان نصب مجدداً استفاده می‌شوند\&.
.RE
.PP
\fB\-\-commit=COMMIT\fR
.RS 4
به‌روزرسانی به این کامیت خاص به جای انتهای شاخه\&. می‌توانید کامیت‌ها را با استفاده از
\fBflatpak remote\-info \-\-log REMOTE REF\fR
پیدا کنید\&.
.RE
.PP
\fB\-\-no\-deploy\fR
.RS 4
دانلود آخرین نسخه، اما عدم استقرار (deploy) آن\&.
.RE
.PP
\fB\-\-no\-pull\fR
.RS 4
عدم دانلود آخرین نسخه و استقرار هر آنچه که در حال حاضر به صورت محلی در دسترس است\&.
.RE
.PP
\fB\-\-no\-related\fR
.RS 4
عدم دانلود افزونه‌های مرتبط، مانند داده‌های زبان (locale)\&.
.RE
.PP
\fB\-\-no\-deps\fR
.RS 4
عدم به‌روزرسانی یا نصب پیش‌نیازهای زمان اجرا هنگام نصب\&.
.RE
.PP
\fB\-\-app\fR
.RS 4
تنها جستجو برای برنامه‌ای با نام داده‌شده\&.
.RE
.PP
\fB\-\-appstream\fR
.RS 4
به‌روزرسانی appstream برای
REMOTE، یا تمام ریموت‌ها در صورت عدم تعیین ریموت\&.
.RE
.PP
\fB\-\-runtime\fR
.RS 4
تنها جستجو برای ران‌تایمی با نام داده‌شده\&.
.RE
.PP
\fB\-\-sideload\-repo=PATH\fR
.RS 4
افزودن یک مخزن محلی ostree اضافی به عنوان منبع نصب\&. این کار معادل استفاده از پوشه‌های
sideload\-repos
(نگاه کنید به
\fBflatpak\fR(1))
است، اما می‌تواند به ازای هر دستور انجام شود\&. هر مسیری که در اینجا افزوده شود علاوه بر مسیرهای آن پوشه‌ها استفاده خواهد شد\&.
.RE
.PP
\fB\-y\fR, \fB\-\-assumeyes\fR
.RS 4
پاسخ مثبت (بله) خودکار به تمام پرسش‌ها (یا انتخاب پاسخی با بالاترین اولویت)\&. برای خودکارسازی فرآیندها مفید است\&.
.RE
.PP
\fB\-\-noninteractive\fR
.RS 4
تولید حداقل خروجی و پرهیز از پرسیدن اکثر سوالات\&. برای استفاده در سناریوهای غیرتعاملی، مانند اسکریپت‌های بیلد مناسب است\&.
.RE
.PP
\fB\-\-force\-remove\fR
.RS 4
حذف فایل‌های قدیمی حتی اگر توسط یک برنامهٔ در حال اجرا استفاده شوند\&.
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
چاپ اطلاعات اشکال‌زدایی در طول پردازش دستور\&.
.RE
.PP
\fB\-\-ostree\-verbose\fR
.RS 4
چاپ اطلاعات اشکال‌زدایی OSTree در طول پردازش دستور\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
\fB$ flatpak \-\-user update org\&.gnome\&.gedit\fR
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBflatpak\fR(1),
\fBflatpak-install\fR(1),
\fBflatpak-list\fR(1),
\fBostree-find-remotes\fR(1)