.\" generated with Ronn-NG/v0.10.1
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
.TH "BUNDLE\-ADD" "1" "September 2025" ""
.SH "نام (NAME)"
\fBbundle\-add\fR \- افزودن gem به Gemfile و اجرای bundle install
.SH "خلاصه دستور (SYNOPSIS)"
\fBbundle add\fR \fIGEM_NAME\fR [\-\-group=GROUP] [\-\-version=VERSION] [\-\-source=SOURCE] [\-\-path=PATH] [\-\-git=GIT|\-\-github=GITHUB] [\-\-branch=BRANCH] [\-\-ref=REF] [\-\-quiet] [\-\-skip\-install] [\-\-strict|\-\-optimistic]
.SH "توضیحات (DESCRIPTION)"
جم مشخص‌شده را به [\fBGemfile(5)\fR][Gemfile(5)] اضافه کرده و \fBbundle install\fR را اجرا می‌کند\. با استفاده از پرچم \fB\-\-skip\-install\fR می‌توان از اجرای \fBbundle install\fR صرف‌نظر کرد\.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-\-version=VERSION\fR, \fB\-v=VERSION\fR
مشخص کردن نیازمندی(های) نسخه برای جم اضافه‌شده\.
.TP
\fB\-\-group=GROUP\fR, \fB\-g=GROUP\fR
مشخص کردن گروه(های) مربوط به جم اضافه‌شده\. گروه‌های چندگانه باید با کاما از یکدیگر جدا شوند\.
.TP
\fB\-\-source=SOURCE\fR, \fB\-s=SOURCE\fR
مشخص کردن منبع (source) برای جم اضافه‌شده\.
.TP
\fB\-\-require=REQUIRE\fR, \fB\-r=REQUIRE\fR
مسیر require را به جم اضافه می‌کند\. مقدار false یا یک مسیر به صورت رشته متنی وارد کنید\.
.TP
\fB\-\-path=PATH\fR
مشخص کردن مسیر فایل‌سیستم برای جم اضافه‌شده\.
.TP
\fB\-\-git=GIT\fR
مشخص کردن منبع git برای جم اضافه‌شده\.
.TP
\fB\-\-github=GITHUB\fR
مشخص کردن منبع github برای جم اضافه‌شده\.
.TP
\fB\-\-branch=BRANCH\fR
مشخص کردن شاخه git برای جم اضافه‌شده\.
.TP
\fB\-\-ref=REF\fR
مشخص کردن git ref برای جم اضافه‌شده\.
.TP
\fB\-\-glob=GLOB\fR
مشخص کردن مکان فایل \.gemspec وابستگی، که درون Ruby بسط می‌یابد (استفاده از نقل‌قول تکی پیشنهاد می‌شود)\.
.TP
\fB\-\-quiet\fR
اطلاعات پیشرفت را در خروجی استاندارد چاپ نمی‌کند\.
.TP
\fB\-\-skip\-install\fR
جم را به Gemfile اضافه می‌کند اما آن را نصب نمی‌کند\.
.TP
\fB\-\-optimistic\fR
تعریف خوش‌بینانه (optimistic) نسخه را اضافه می‌کند\.
.TP
\fB\-\-strict\fR
تعریف دقیق و سخت‌گیرانه (strict) نسخه را اضافه می‌کند\.
.SH "مثال‌ها (EXAMPLES)"
.IP "1." 4
می‌توانید جم \fBrails\fR را بدون هیچ محدودیت نسخه‌ای به Gemfile اضافه کنید\. منبع جم، منبع سراسری (global source) خواهد بود\.
.IP
\fBbundle add rails\fR
.IP "2." 4
می‌توانید جم \fBrails\fR را با نسخه بزرگ‌تر از 1\.1 (بدون شامل شدن خود 1\.1) و کوچک‌تر از 3\.0 اضافه کنید\.
.IP
\fBbundle add rails \-\-version "> 1\.1, < 3\.0"\fR
.IP "3." 4
می‌توانید از منبع سفارشی \fBhttps://gems\.example\.com\fR استفاده کرده و جم را به یک گروه اختصاص دهید\.
.IP
\fBbundle add rails \-\-version "~> 5\.0\.0" \-\-source "https://gems\.example\.com" \-\-group "development"\fR
.IP "4." 4
دستور زیر مدخل \fBgem\fR را بدون نصب کردن به Gemfile اضافه می‌کند\. می‌توانید بعداً جم‌ها را با \fBbundle install\fR نصب کنید\.
.IP
\fBbundle add rails \-\-skip\-install\fR
.IP "5." 4
می‌توانید جم را به بیش از یک گروه اختصاص دهید\.
.IP
\fBbundle add rails \-\-group "development, test"\fR
.IP "" 0
.SH "همچنین ببینید (SEE ALSO)"
Gemfile(5) \fIhttps://bundler\.io/man/gemfile\.5\.html\fR, bundle\-remove(1) \fIbundle\-remove\.1\.html\fR