.\" generated with Ronn-NG/v0.10.1
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
.TH "BUNDLE\-CACHE" "1" "September 2025" ""
.SH "نام (NAME)"
\fBbundle\-cache\fR \- بسته‌بندی فایل‌های \fB\.gem\fR مورد نیاز درون برنامه شما
.SH "خلاصه دستور (SYNOPSIS)"
\fBbundle cache\fR [\fIOPTIONS\fR]
.P
نام‌های مستعار: \fBpackage\fR، \fBpack\fR
.SH "توضیحات (DESCRIPTION)"
تمام فایل‌های \fB\.gem\fR مورد نیاز برای اجرای برنامه را در دایرکتوری \fBvendor/cache\fR کپی می‌کند\. در آینده، هنگام اجرای \fBbundle install(1)\fR \fIbundle\-install\.1\.html\fR، جم‌های موجود در حافظه موقت (کَش) نسبت به جم‌های موجود در \fBrubygems\.org\fR در اولویت قرار خواهند گرفت\.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-\-all\-platforms\fR
شامل کردن جم‌ها برای تمام پلتفرم‌های موجود در lockfile، نه فقط پلتفرم فعلی\.
.TP
\fB\-\-cache\-path=CACHE\-PATH\fR
مشخص کردن مسیری متفاوت برای کَش به‌جای مسیر پیش‌فرض (vendor/cache)\.
.TP
\fB\-\-gemfile=GEMFILE\fR
استفاده از gemfile مشخص‌شده به‌جای Gemfile\.
.TP
\fB\-\-no\-install\fR
جم‌ها را نصب نکن، فقط کَش را به‌روزرسانی کن\.
.TP
\fB\-\-quiet\fR
فقط هشدارها و خطاها را خروجی بده\.
.SH "جم‌های GIT و PATH (GIT AND PATH GEMS)"
دستور \fBbundle cache\fR می‌تواند علاوه بر فایل‌های \.gem، وابستگی‌های \fB:git\fR و \fB:path\fR را نیز بسته‌بندی کند\. این قابلیت را می‌توان با تنظیم \fBcache_all\fR روی مقدار false غیرفعال کرد\.
.SH "پشتیبانی از چند پلتفرم (SUPPORT FOR MULTIPLE PLATFORMS)"
هنگام استفاده از جم‌هایی که بسته‌های متفاوتی برای پلتفرم‌های گوناگون دارند، Bundler از کَش کردن جم‌ها برای سایر پلتفرم‌هایی که Gemfile برای آن‌ها حل شده است (یعنی در lockfile حضور دارند) در \fBvendor/cache\fR پشتیبانی می‌کند\. این ویژگی باید از طریق گزینه \fB\-\-all\-platforms\fR فعال شود\. این تنظیم در پیکربندی محلی bundler شما ذخیره خواهد شد\.
.SH "دریافت از راه دور (REMOTE FETCHING)"
به‌طور پیش‌فرض، اگر پس از اجرای bundle cache(1) \fIbundle\-cache\.1\.html\fR دستور \fBbundle install(1)\fR \fIbundle\-install\.1\.html\fR را اجرا کنید، bundler همچنان به \fBrubygems\.org\fR متصل می‌شود تا بررسی کند آیا نسخه ویژه‌ای برای پلتفرم شما برای هر یک از جم‌های درون \fBvendor/cache\fR وجود دارد یا خیر\.
.P
برای نمونه، این Gemfile(5) را در نظر بگیرید:
.IP "" 4
.nf
source "https://rubygems\.org"

gem "nokogiri"
.fi
.IP "" 0
.P
اگر \fBbundle cache\fR را در C Ruby اجرا کنید، bundler نسخه \fBnokogiri\fR مخصوص پلتفرم \fB"ruby"\fR را دریافت خواهد کرد\. اگر برنامه را روی JRuby مستقر کرده و \fBbundle install\fR را اجرا کنید، bundler مجبور است بررسی کند آیا نسخه‌ای از \fBnokogiri\fR برای پلتفرم \fB"java"\fR وجود دارد یا خیر\.
.P
اگرچه جم \fBnokogiri\fR برای پلتفرم Ruby \fIاز نظر فنی\fR روی JRuby قابل قبول است، اما دارای یک افزونه C است که روی JRuby اجرا نمی‌شود\. در نتیجه، bundler به‌طور پیش‌فرض همچنان به \fBrubygems\.org\fR متصل خواهد شد تا بررسی کند آیا نسخه اختصاصی‌تری از یکی از جم‌های شما برای پلتفرم شما وجود دارد یا خیر\.
.P
این مشکل همچنین تنها به پلتفرم \fB"java"\fR محدود نمی‌شود\. مشکل مشابه (و رایجی) ممکن است هنگام توسعه در Windows و استقرار روی Linux، یا حتی هنگام توسعه در OSX و استقرار روی Linux رخ دهد\.
.P
اگر مطمئن هستید که جم‌های بسته‌بندی‌شده در \fBvendor/cache\fR برای پلتفرمی که روی آن هستید مناسب هستند، می‌توانید \fBbundle install \-\-local\fR را اجرا کنید تا از بررسی برای جم‌های مناسب‌تر صرف‌نظر کرده و از موارد موجود در \fBvendor/cache\fR استفاده کند\.
.P
یک راه برای اطمینان از اینکه نسخه‌های متناسب با پلتفرم صحیح را برای تمام جم‌های خود دارید، این است که \fBbundle cache\fR را روی ماشینی کاملاً یکسان اجرا کرده و جم‌ها را تحویل مخزن (check in) دهید\. برای نمونه، می‌توانید در طول فرایند staging، دستور \fBbundle cache\fR را روی یک ماشین staging یکسان اجرا کنید و پیش از استقرار در محیط عملیاتی (production)، محتویات \fBvendor/cache\fR را ثبت کنید\.
.P
به‌طور پیش‌فرض، bundle cache(1) \fIbundle\-cache\.1\.html\fR جم‌ها را واکشی کرده و آن‌ها را در مکان پیش‌فرض نیز نصب می‌کند\. برای بسته‌بندی وابستگی‌ها در \fBvendor/cache\fR بدون نصب آن‌ها در محل نصب محلی، می‌توانید \fBbundle cache \-\-no\-install\fR را اجرا کنید\.
.SH "تاریخچه (HISTORY)"
در Bundler 2\.1، دستور \fBcache\fR قابلیت‌های \fBpackage\fR را در خود جای داد و اکنون \fBpackage\fR و \fBpack\fR نام‌های مستعار \fBcache\fR هستند\.