.\" Generated by scdoc 1.11.5
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "apk\-upgrade" "8" "2026\-08\-31"
.PP
.SH "نام (NAME)"
.PP
apk-upgrade \- ارتقای بسته‌های نصب‌شده
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBapk upgrade\fR [<\fIگزینه‌ها\fR>.\&.\&.\&] [<\fIبسته‌ها\fR>.\&.\&.\&]
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
دستور \fBapk upgrade\fR بسته‌های نصب‌شده را به جدیدترین نسخه موجود در مخازن پیکربندی‌شده بسته (نگاه کنید به \fBapk\-repositories\fR(5)) ارتقا می‌دهد.\& هنگامی که هیچ بسته‌ای مشخص نشده باشد، در صورت امکان تمامی بسته‌ها ارتقا می‌یابند.\& اگر فهرستی از بسته‌ها ارائه شود، تنها همان بسته‌ها همراه با وابستگی‌های مورد نیازشان ارتقا خواهند یافت.\&
.PP
اگر وابستگی‌های ذکرشده در \fB\-\-preupgrade\-depends\fR (نگاه کنید به \fBapk\fR(8)) با بسته‌ای قابل ارتقا مطابقت داشته باشند، مرحله پیش‌ارتقا انجام می‌شود.\& در طول مرحله پیش‌ارتقا، بسته‌های نصب‌شده مطابق با وابستگی‌های پیش‌ارتقا در صورت امکان ارتقا می‌یابند \- وابستگی‌های آن‌ها اعمال می‌شوند (اما ارتقا داده نمی‌شوند مگر اینکه توسط وابستگی‌های بسته جدید الزامی شده باشند).\&
.PP
یک وابستگی پیش‌ارتقای ضمنی برای بسته‌ای که مالک فایل اجرایی apk است ایجاد می‌شود.\&
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
دستور \fBapk upgrade\fR از گزینه‌های commit توضیح داده‌شده در \fBapk\fR(8) و همچنین گزینه‌های زیر پشتیبانی می‌کند:
.PP
\fB\-\-available\fR, \fB\-a\fR
.RS 4
بازنشانی تمام بسته‌ها به نسخه‌های موجود در مخازن فعلی.\&
این گزینه تمام وابستگی‌های دارای نسخه را در \fIworld\fR بازنشانی می‌کند (نگاه کنید به \fBapk\-world\fR(5)).\&
علاوه بر این، در صورت امکان بسته‌ها از مخازن فعال انتخاب می‌شوند، حتی اگر این کار به معنای جایگزینی یا تنزل نسخه (downgrade) بسته باشد.\&
.PP
این قابلیت برای بازنشانی سیستم در برابر مجموعه جدیدی از بسته‌ها پس از به‌روزرسانی مخازن مفید است.\&
.PP
.RE
\fB\-\-ignore\fR
.RS 4
ارتقای تمام بسته‌های دیگر به‌جز موارد فهرست‌شده.\& این گزینه فهرست نام‌های بسته ارائه‌شده را معکوس می‌کند تا به معنای بسته‌هایی باشد که نباید ارتقا یابند.\&
.PP
.RE
\fB\-\-latest\fR, \fB\-l\fR
.RS 4
همیشه جدیدترین بسته بر اساس نسخه انتخاب شود.\& با این حال، نسخه‌های مد نظر بر اساس پین‌کردن بسته (package pinning) هستند.\& این گزینه در درجه اول روش اکتشافی (heuristic) پیش‌فرض را لغو می‌کند و در صورتی که همه وابستگی‌ها برآورده نشوند، باعث نمایش خطا خواهد شد.\&
.PP
.RE
\fB\-\-preupgrade\fR[=\fIBOOL\fR]
.RS 4
در صورت غیرفعال شدن، مرحله پیش‌ارتقا را غیرفعال می‌کند.\&
.PP
.RE
\fB\-\-preupgrade\-only\fR
.RS 4
تنها مرحله پیش‌ارتقا را انجام می‌دهد.\&
.PP
.RE
\fB\-\-prune\fR
.RS 4
پاک‌سازی \fIworld\fR از طریق حذف بسته‌هایی که دیگر در هیچ‌یک از مخازن پیکربندی‌شده موجود نیستند.\&
.RE