نام (NAME)

apk-upgrade - ارتقای بسته‌های نصب‌شده

خلاصه دستور (SYNOPSIS)

apk upgrade [<گزینه‌ها>...] [<بسته‌ها>...]

توضیحات (DESCRIPTION)

دستور apk upgrade بسته‌های نصب‌شده را به جدیدترین نسخه موجود در مخازن پیکربندی‌شده بسته (نگاه کنید به apk-repositories(5)) ارتقا می‌دهد. هنگامی که هیچ بسته‌ای مشخص نشده باشد، در صورت امکان تمامی بسته‌ها ارتقا می‌یابند. اگر فهرستی از بسته‌ها ارائه شود، تنها همان بسته‌ها همراه با وابستگی‌های مورد نیازشان ارتقا خواهند یافت.

اگر وابستگی‌های ذکرشده در --preupgrade-depends (نگاه کنید به apk(8)) با بسته‌ای قابل ارتقا مطابقت داشته باشند، مرحله پیش‌ارتقا انجام می‌شود. در طول مرحله پیش‌ارتقا، بسته‌های نصب‌شده مطابق با وابستگی‌های پیش‌ارتقا در صورت امکان ارتقا می‌یابند - وابستگی‌های آن‌ها اعمال می‌شوند (اما ارتقا داده نمی‌شوند مگر اینکه توسط وابستگی‌های بسته جدید الزامی شده باشند).

یک وابستگی پیش‌ارتقای ضمنی برای بسته‌ای که مالک فایل اجرایی apk است ایجاد می‌شود.

گزینه‌ها (OPTIONS)

دستور apk upgrade از گزینه‌های commit توضیح داده‌شده در apk(8) و همچنین گزینه‌های زیر پشتیبانی می‌کند:

--available, -a

بازنشانی تمام بسته‌ها به نسخه‌های موجود در مخازن فعلی. این گزینه تمام وابستگی‌های دارای نسخه را در world بازنشانی می‌کند (نگاه کنید به apk-world(5)). علاوه بر این، در صورت امکان بسته‌ها از مخازن فعال انتخاب می‌شوند، حتی اگر این کار به معنای جایگزینی یا تنزل نسخه (downgrade) بسته باشد.

این قابلیت برای بازنشانی سیستم در برابر مجموعه جدیدی از بسته‌ها پس از به‌روزرسانی مخازن مفید است.

--ignore

ارتقای تمام بسته‌های دیگر به‌جز موارد فهرست‌شده. این گزینه فهرست نام‌های بسته ارائه‌شده را معکوس می‌کند تا به معنای بسته‌هایی باشد که نباید ارتقا یابند.

--latest, -l

همیشه جدیدترین بسته بر اساس نسخه انتخاب شود. با این حال، نسخه‌های مد نظر بر اساس پین‌کردن بسته (package pinning) هستند. این گزینه در درجه اول روش اکتشافی (heuristic) پیش‌فرض را لغو می‌کند و در صورتی که همه وابستگی‌ها برآورده نشوند، باعث نمایش خطا خواهد شد.

--preupgrade[=BOOL]

در صورت غیرفعال شدن، مرحله پیش‌ارتقا را غیرفعال می‌کند.

--preupgrade-only

تنها مرحله پیش‌ارتقا را انجام می‌دهد.

--prune

پاک‌سازی world از طریق حذف بسته‌هایی که دیگر در هیچ‌یک از مخازن پیکربندی‌شده موجود نیستند.