.\" generated with Ronn-NG/v0.10.1
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
.TH "BUNDLE\-LOCK" "1" "September 2025" ""
.SH "نام (NAME)"
\fBbundle\-lock\fR \- ایجاد یا به‌روزرسانی یک lockfile بدون انجام نصب
.SH "خلاصه دستور (SYNOPSIS)"
\fBbundle lock\fR [\-\-update] [\-\-bundler[=BUNDLER]] [\-\-local] [\-\-print] [\-\-lockfile=PATH] [\-\-full\-index] [\-\-gemfile=GEMFILE] [\-\-add\-checksums] [\-\-add\-platform] [\-\-remove\-platform] [\-\-normalize\-platforms] [\-\-patch] [\-\-minor] [\-\-major] [\-\-pre] [\-\-strict] [\-\-conservative]
.SH "توضیحات (DESCRIPTION)"
قفل کردن gemهای مشخص‌شده در Gemfile\.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-\-update[=<list>]\fR
فایل lockfile موجود را نادیده می‌گیرد. وابستگی‌ها را بازسنجی کرده و سپس lockfile را به‌روزرسانی می‌کند. فهرستی از gemها را دریافت می‌کند یا در صورت مشخص نشدن فهرست، تمامی gemها را به‌روزرسانی می‌نماید.
.TP
\fB\-\-bundler[=BUNDLER]\fR
نسخهٔ قفل‌شدهٔ bundler را به نسخهٔ داده‌شده یا در صورت مشخص نشدن نسخه، به آخرین نسخه به‌روزرسانی می‌کند.
.TP
\fB\-\-local\fR
برای اتصال به \fBrubygems\.org\fR تلاش نمی‌کند. در عوض، Bundler از gemهای موجود در حافظهٔ موقت (کَش) Rubygems یا در \fBvendor/cache\fR استفاده خواهد کرد. توجه داشته باشید که اگر gem مناسب ویژه‌پلتفرمی در \fBrubygems\.org\fR موجود باشد، پیدا نخواهد شد.
.TP
\fB\-\-print\fR
به جای نوشتن روی سیستم فایل، lockfile را در خروجی استاندارد (STDOUT) چاپ می‌کند.
.TP
\fB\-\-lockfile=LOCKFILE\fR
مسیری که lockfile باید در آن نوشته شود.
.TP
\fB\-\-full\-index\fR
بازگشت به استفاده از نمایهٔ تک‌فایلی همهٔ gemها.
.TP
\fB\-\-gemfile=GEMFILE\fR
استفاده از gemfile مشخص‌شده به جای [\fBGemfile(5)\fR][Gemfile(5)]\.
.TP
\fB\-\-add\-checksums\fR
افزودن چکسام‌ها به lockfile\.
.TP
\fB\-\-add\-platform=<list>\fR
افزودن یک پلتفرم جدید به lockfile، و بازسنجی مجدد برای اضافه کردن آن پلتفرم.
.TP
\fB\-\-remove\-platform=<list>\fR
حذف یک پلتفرم از lockfile\.
.TP
\fB\-\-normalize\-platforms\fR
عادی‌سازی پلتفرم‌های lockfile\.
.TP
\fB\-\-patch\fR
در صورت به‌روزرسانی، ترجیح دادن به‌روزرسانی فقط به نسخهٔ patch بعدی.
.TP
\fB\-\-minor\fR
در صورت به‌روزرسانی، ترجیح دادن به‌روزرسانی فقط به نسخهٔ minor بعدی.
.TP
\fB\-\-major\fR
در صورت به‌روزرسانی، ترجیح دادن به‌روزرسانی به نسخهٔ major بعدی (پیش‌فرض).
.TP
\fB\-\-pre\fR
در صورت به‌روزرسانی، همیشه بالاترین نسخهٔ مجاز بدون توجه به وضعیت پیش‌انتشار (prerelease) انتخاب می‌شود.
.TP
\fB\-\-strict\fR
در صورت به‌روزرسانی، اجازه ندهید هیچ gemای فراتر از آخرین \-\-patch | \-\-minor | \-\-major به‌روزرسانی شود.
.TP
\fB\-\-conservative\fR
در صورت به‌روزرسانی، استفاده از رفتار به‌روزرسانی محافظه‌کارانهٔ bundle install و جلوگیری از به‌روزرسانی وابستگی‌های مشترک.
.SH "به‌روزرسانی همه GEMها (UPDATING ALL GEMS)"
اگر \fBbundle lock\fR را با گزینهٔ \fB\-\-update\fR و بدون مشخص کردن فهرستی از gemها اجرا کنید، bundler تمامی gemهای قبلاً نصب‌شده را نادیده می‌گیرد و همهٔ وابستگی‌ها را دوباره بر اساس آخرین نسخهٔ تمامی gemهای موجود در منابع بازسنجی می‌کند.
.SH "به‌روزرسانی فهرستی از GEMها (UPDATING A LIST OF GEMS)"
گاهی اوقات می‌خواهید یک gem تکی را در Gemfile(5) به‌روزرسانی کنید و بقیهٔ gemهای مشخص‌شده را روی نسخه‌های موجود در \fBGemfile\.lock\fR قفل نگه دارید.
.P
برای نمونه، اگر فقط می‌خواهید \fBnokogiri\fR را به‌روزرسانی کنید، \fBbundle lock \-\-update nokogiri\fR را اجرا کنید.
.P
دستور Bundler بستهٔ \fBnokogiri\fR و هر یک از وابستگی‌های آن را به‌روزرسانی می‌کند، اما مابقی gemهای مشخص‌شده را روی نسخه‌های موجود در \fBGemfile\.lock\fR قفل نگه می‌دارد.
.SH "پشتیبانی از پلتفرم‌های دیگر (SUPPORTING OTHER PLATFORMS)"
اگر می‌خواهید bundle شما از پلتفرم‌هایی غیر از پلتفرمی که به صورت محلی در حال اجرای آن هستید پشتیبانی کند، می‌توانید \fBbundle lock \-\-add\-platform PLATFORM\fR را اجرا کنید تا PLATFORM به lockfile اضافه شود، و bundler وادار شود تا وابستگی‌ها را مجدداً بازسنجی کرده و پلتفرم جدید را هنگام انتخاب gemها در نظر بگیرد؛ همهٔ این‌ها بدون نیاز به در دسترس داشتن دستگاهی سازگار با PLATFORM برای نصب gemهای مخصوص آن پلتفرم انجام می‌شود.
.P
برای توضیح کامل دربارهٔ پلتفرم‌های gem، دستور \fBgem help platform\fR را ببینید.
.SH "گزینه‌های سطح وصله (PATCH LEVEL OPTIONS)"
برای جزئیات بیشتر به bundle update(1) \fIbundle\-update\.1\.html\fR مراجعه کنید.