'\" t
.TH "CARGO\-UPDATE" "1"
.nh
.ad l
.ss \n[.ss] 0
.SH "نام (NAME)"
cargo\-update \- به‌روزرسانی وابستگی‌های ثبت‌شده در فایل قفل محلی
.SH "خلاصه دستور (SYNOPSIS)"
\fBcargo update\fR [\fIگزینه‌ها\fR] \fIspec\fR
.SH "توضیحات (DESCRIPTION)"
این دستور وابستگی‌های موجود در فایل \fBCargo.lock\fR را به آخرین نسخه به‌روزرسانی می‌کند. اگر فایل \fBCargo.lock\fR وجود نداشته باشد، با جدیدترین نسخه‌های موجود ایجاد خواهد شد.
.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های به‌روزرسانی (Update Options)"
.sp
\fIspec\fR\[u2026]
.RS 4
فقط بسته‌های مشخص‌شده را به‌روزرسانی می‌کند. این پرچم را می‌توان چندین بار مشخص کرد. برای اطلاع از قالب SPEC به \fBcargo\-pkgid\fR(1) مراجعه کنید.
.sp
اگر بسته‌ها با \fIspec\fR مشخص شوند، یک به‌روزرسانی محافظه‌کارانه روی فایل قفل انجام خواهد شد. این بدان معناست که تنها وابستگی مشخص‌شده توسط SPEC به‌روزرسانی می‌شود. وابستگی‌های گذارای (transitive) آن تنها در صورتی به‌روزرسانی می‌شوند که SPEC بدون به‌روزرسانی وابستگی‌ها امکان به‌روزرسانی نداشته باشد. تمام وابستگی‌های دیگر روی نسخه‌های ثبت‌شده فعلی‌شان قفل باقی خواهند ماند.
.sp
اگر \fIspec\fR مشخص نشود، تمام وابستگی‌ها به‌روزرسانی می‌شوند.
.RE
.sp
\fB\-\-recursive\fR
.RS 4
هنگامی که همراه با \fIspec\fR استفاده شود، وابستگی‌های \fIspec\fR نیز مجبور به به‌روزرسانی می‌شوند. نمی‌تواند همراه با \fB\-\-precise\fR استفاده شود.
.RE
.sp
\fB\-\-precise\fR \fIprecise\fR
.RS 4
هنگامی که همراه با \fIspec\fR استفاده شود، به شما امکان می‌دهد شماره نسخه مشخصی را برای تنظیم بسته تعیین کنید. اگر بسته از یک مخزن git باشد، این مقدار می‌تواند یک بازبینی (revision) در git باشد (مانند هش SHA یا تگ).
.sp
اگرچه توصیه نمی‌شود، اما می‌توانید یک نسخه yanked (حذف/باطل‌شده) از بسته را مشخص کنید. در صورت امکان، سایر نسخه‌های سازگار با SemVer که yanked نشده‌اند را امتحان کنید یا از نگهدارندگان بسته راهنمایی بخواهید.
.sp
یک نسخه سازگار \fBpre\-release\fR را نیز می‌توان مشخص کرد، حتی زمانی که الزامات نسخه در \fBCargo.toml\fR شامل هیچ شناسه‌ای برای پیش‌انتشار نباشد (فقط در nightly).
.RE
.sp
\fB\-\-breaking\fR \fIdirectory\fR
.RS 4
به‌روزرسانی \fIspec\fR به آخرین نسخه‌ای که ناسازگار با SemVer است (تغییرات عمده و شکننده).
.sp
الزامات نسخه (version requirements) برای مجاز کردن این به‌روزرسانی تغییر خواهند کرد.
.sp
این مورد تنها زمانی برای وابستگی‌ها اعمال می‌شود که:
.sp
.RS 4
\h'-04'\(bu\h'+03'بسته، وابستگی یکی از اعضای فضای کاری (workspace member) باشد
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'نام وابستگی تغییر داده نشده باشد
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'یک نسخه ناسازگار با SemVer در دسترس باشد
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'از «عملگر SemVer» استفاده شده باشد (\fB^\fR که پیش‌فرض است)
.RE
.sp
این گزینه ناپایدار است و فقط در
\fIکانال nightly\fR <https://doc.rust\-lang.org/book/appendix\-07\-nightly\-rust.html>
در دسترس است و برای فعال‌سازی به پرچم \fB\-Z unstable\-options\fR نیاز دارد.
برای اطلاعات بیشتر <https://github.com/rust\-lang/cargo/issues/12425> را ببینید.
.RE
.sp
\fB\-w\fR, 
\fB\-\-workspace\fR
.RS 4
تلاش برای به‌روزرسانی تنها بسته‌های تعریف‌شده در فضای کاری (workspace). بسته‌های دیگر تنها در صورتی به‌روزرسانی می‌شوند که از قبل در فایل قفل وجود نداشته باشند. این گزینه برای به‌روزرسانی \fBCargo.lock\fR پس از تغییر شماره نسخه‌ها در \fBCargo.toml\fR مفید است.
.RE
.sp
\fB\-\-dry\-run\fR
.RS 4
آنچه را که به‌روزرسانی خواهد شد نمایش می‌دهد، اما در عمل چیزی در فایل قفل نمی‌نویسد.
.RE
.SS "گزینه‌های نمایش (Display Options)"
.sp
\fB\-v\fR, 
\fB\-\-verbose\fR
.RS 4
استفاده از خروجی پرگو (verbose). برای خروجی «بسیار پرگو» که شامل خروجی‌های اضافی مانند هشدارهای وابستگی و خروجی اسکریپت ساخت است، می‌تواند دو بار مشخص شود. همچنین می‌تواند با \fIمقدار پیکربندی\fR \fBterm.verbose\fR <https://doc.rust\-lang.org/cargo/reference/config.html> مشخص شود.
.RE
.sp
\fB\-q\fR, 
\fB\-\-quiet\fR
.RS 4
پیام‌های لاگ cargo را چاپ نمی‌کند. همچنین می‌تواند با \fIمقدار پیکربندی\fR \fBterm.quiet\fR <https://doc.rust\-lang.org/cargo/reference/config.html> مشخص شود.
.RE
.sp
\fB\-\-color\fR \fIwhen\fR
.RS 4
کنترل زمان استفاده از خروجی رنگی. مقادیر معتبر:
.sp
.RS 4
\h'-04'\(bu\h'+03'\fBauto\fR (پیش‌فرض): تشخیص خودکار در دسترس بودن پشتیبانی از رنگ در ترمینال.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fBalways\fR: همیشه رنگ‌ها را نمایش می‌دهد.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fBnever\fR: هرگز رنگ‌ها را نمایش نمی‌دهد.
.RE
.sp
همچنین می‌تواند با \fIمقدار پیکربندی\fR \fBterm.color\fR <https://doc.rust\-lang.org/cargo/reference/config.html> مشخص شود.
.RE
.SS "گزینه‌های مانیفست (Manifest Options)"
.sp
\fB\-\-manifest\-path\fR \fIpath\fR
.RS 4
مسیر فایل \fBCargo.toml\fR. به طور پیش‌فرض، Cargo فایل \fBCargo.toml\fR را در دایرکتوری فعلی یا هر یک از دایرکتوری‌های والد جستجو می‌کند.
.RE
.sp
\fB\-\-ignore\-rust\-version\fR
.RS 4
مشخصه \fBrust\-version\fR را در بسته‌ها نادیده می‌گیرد.
.RE
.sp
\fB\-\-locked\fR
.RS 4
تضمین می‌کند که دقیقاً همان وابستگی‌ها و نسخه‌هایی که هنگام تولید اولیه فایل \fBCargo.lock\fR فعلی ثبت شده‌اند استفاده شوند. در صورت بروز هر یک از سناریوهای زیر، Cargo با خطا خارج می‌شود:
.sp
.RS 4
\h'-04'\(bu\h'+03'فایل قفل موجود نباشد.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'Cargo به دلیل حل و فصل وابستگی متفاوت، تلاش کند فایل قفل را تغییر دهد.
.RE
.sp
این گزینه می‌تواند در محیط‌هایی که ساخت‌های قطعی (deterministic) مورد نیاز است، مانند خطوط لوله CI، استفاده شود.
.RE
.sp
\fB\-\-offline\fR
.RS 4
از دسترسی Cargo به شبکه به هر دلیلی جلوگیری می‌کند. بدون این پرچم، اگر Cargo نیاز به دسترسی به شبکه داشته باشد و شبکه در دسترس نباشد، با خطا متوقف خواهد شد. با این پرچم، Cargo در صورت امکان تلاش می‌کند بدون شبکه پیش برود.
.sp
توجه داشته باشید که این ممکن است به حل و فصل وابستگی متفاوتی نسبت به حالت برخط منجر شود. Cargo خود را به crateهایی که به صورت محلی دانلود شده‌اند محدود می‌کند، حتی اگر طبق نسخه محلی نمایه (index)، نسخه جدیدتری وجود داشته باشد. برای دانلود وابستگی‌ها قبل از رفتن به حالت آفلاین، دستور \fBcargo\-fetch\fR(1) را ببینید.
.sp
همچنین می‌تواند با \fIمقدار پیکربندی\fR \fBnet.offline\fR <https://doc.rust\-lang.org/cargo/reference/config.html> مشخص شود.
.RE
.sp
\fB\-\-frozen\fR
.RS 4
معادل مشخص کردن هم‌زمان هر دو پرچم \fB\-\-locked\fR و \fB\-\-offline\fR است.
.RE
.SS "گزینه‌های عمومی (Common Options)"
.sp
\fB+\fR\fItoolchain\fR
.RS 4
اگر Cargo توسط rustup نصب شده باشد و اولین آرگومان \fBcargo\fR با \fB+\fR آغاز شود، به عنوان نام زنجیره ابزار rustup تفسیر خواهد شد (مانند \fB+stable\fR یا \fB+nightly\fR).
برای اطلاعات بیشتر درباره نحوه عملکرد بازنویسی‌های زنجیره ابزار، به \fIمستندات rustup\fR <https://rust\-lang.github.io/rustup/overrides.html> مراجعه کنید.
.RE
.sp
\fB\-\-config\fR \fIKEY=VALUE\fR یا \fIPATH\fR
.RS 4
یک مقدار پیکربندی Cargo را بازنویسی می‌کند. این آرگومان باید در ساختار نحوی TOML به صورت \fBKEY=VALUE\fR باشد، یا به عنوان مسیر یک فایل پیکربندی اضافی ارائه شود. این پرچم را می‌توان چندین بار مشخص کرد.
برای اطلاعات بیشتر به \fIبخش بازنویسی‌های خط فرمان\fR <https://doc.rust\-lang.org/cargo/reference/config.html#command\-line\-overrides> مراجعه کنید.
.RE
.sp
\fB\-C\fR \fIPATH\fR
.RS 4
پیش از اجرای هرگونه عملیات مشخص‌شده، دایرکتوری کاری فعلی را تغییر می‌دهد. این امر بر مواردی چون محل جستجوی پیش‌فرض مانیفست پروژه (\fBCargo.toml\fR) توسط cargo و همچنین دایرکتوری‌های مورد جستجو برای یافتن فایل‌هایی نظیر \fB\&.cargo/config.toml\fR اثر می‌گذارد. این گزینه باید قبل از نام دستور ظاهر شود، به عنوان مثال \fBcargo \-C path/to/my\-project build\fR\&.
.sp
این گزینه فقط در \fIکانال nightly\fR <https://doc.rust\-lang.org/book/appendix\-07\-nightly\-rust.html> در دسترس است و برای فعال‌سازی به پرچم \fB\-Z unstable\-options\fR نیاز دارد (به \fI#10098\fR <https://github.com/rust\-lang/cargo/issues/10098> مراجعه کنید).
.RE
.sp
\fB\-h\fR, 
\fB\-\-help\fR
.RS 4
اطلاعات راهنما را چاپ می‌کند.
.RE
.sp
\fB\-Z\fR \fIflag\fR
.RS 4
پرچم‌های ناپایدار (فقط nightly) برای Cargo. برای جزئیات، دستور \fBcargo \-Z help\fR را اجرا کنید.
.RE
.SH "محیط (ENVIRONMENT)"
برای جزئیات متغیرهای محیطی که Cargo می‌خواند، به \fIمرجع\fR <https://doc.rust\-lang.org/cargo/reference/environment\-variables.html> مراجعه کنید.
.SH "وضعیت خروج (EXIT STATUS)"
.sp
.RS 4
\h'-04'\(bu\h'+03'\fB0\fR: کار با موفقیت به پایان رسید.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fB101\fR: اجرای Cargo با شکست مواجه شد.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
.RS 4
\h'-04' 1.\h'+01'به‌روزرسانی تمام وابستگی‌ها در فایل قفل:
.sp
.RS 4
.nf
cargo update
.fi
.RE
.RE
.sp
.RS 4
\h'-04' 2.\h'+01'به‌روزرسانی تنها وابستگی‌های مشخص:
.sp
.RS 4
.nf
cargo update foo bar
.fi
.RE
.RE
.sp
.RS 4
\h'-04' 3.\h'+01'تنظیم یک وابستگی خاص روی یک نسخه مشخص:
.sp
.RS 4
.nf
cargo update foo \-\-precise 1.2.3
.fi
.RE
.RE
.SH "همچنین ببینید (SEE ALSO)"
\fBcargo\fR(1), \fBcargo\-generate\-lockfile\fR(1)