BUNDLE-ADD(1)               General Commands Manual              BUNDLE-ADD(1)

نام (NAME)
       bundle-add - افزودن gem به Gemfile و اجرای bundle install

خلاصه دستور (SYNOPSIS)
       bundle add GEM_NAME [--group=GROUP] [--version=VERSION]
       [--source=SOURCE] [--path=PATH] [--git=GIT|--github=GITHUB]
       [--branch=BRANCH] [--ref=REF] [--quiet] [--skip-install]
       [--strict|--optimistic]

توضیحات (DESCRIPTION)
       جم مشخص‌شده را به [Gemfile(5)][Gemfile(5)] اضافه کرده و bundle install
       را اجرا می‌کند. با استفاده از پرچم --skip-install می‌توان از اجرای bundle
       install صرف‌نظر کرد.

گزینه‌ها (OPTIONS)
       --version=VERSION, -v=VERSION
              مشخص کردن نیازمندی(های) نسخه برای جم اضافه‌شده.

       --group=GROUP, -g=GROUP
              مشخص کردن گروه(های) مربوط به جم اضافه‌شده. گروه‌های چندگانه باید
              با کاما از یکدیگر جدا شوند.

       --source=SOURCE, -s=SOURCE
              مشخص کردن منبع (source) برای جم اضافه‌شده.

       --require=REQUIRE, -r=REQUIRE
              مسیر require را به جم اضافه می‌کند. مقدار false یا یک مسیر به
              صورت رشته متنی وارد کنید.

       --path=PATH
              مشخص کردن مسیر فایل‌سیستم برای جم اضافه‌شده.

       --git=GIT
              مشخص کردن منبع git برای جم اضافه‌شده.

       --github=GITHUB
              مشخص کردن منبع github برای جم اضافه‌شده.

       --branch=BRANCH
              مشخص کردن شاخه git برای جم اضافه‌شده.

       --ref=REF
              مشخص کردن git ref برای جم اضافه‌شده.

       --glob=GLOB
              مشخص کردن مکان فایل .gemspec وابستگی، که درون Ruby بسط می‌یابد
              (استفاده از نقل‌قول تکی پیشنهاد می‌شود).

       --quiet
              اطلاعات پیشرفت را در خروجی استاندارد چاپ نمی‌کند.

       --skip-install
              جم را به Gemfile اضافه می‌کند اما آن را نصب نمی‌کند.

       --optimistic
              تعریف خوش‌بینانه (optimistic) نسخه را اضافه می‌کند.

       --strict
              تعریف دقیق و سخت‌گیرانه (strict) نسخه را اضافه می‌کند.

مثال‌ها (EXAMPLES)
       1.  می‌توانید جم rails را بدون هیچ محدودیت نسخه‌ای به Gemfile اضافه کنید.
           منبع جم، منبع سراسری (global source) خواهد بود.

           bundle add rails

       2.  می‌توانید جم rails را با نسخه بزرگ‌تر از 1.1 (بدون شامل شدن خود 1.1)
           و کوچک‌تر از 3.0 اضافه کنید.

           bundle add rails --version "> 1.1, < 3.0"

       3.  می‌توانید از منبع سفارشی https://gems.example.com استفاده کرده و جم
           را به یک گروه اختصاص دهید.

           bundle add rails --version "~> 5.0.0" --source
           "https://gems.example.com" --group "development"

       4.  دستور زیر مدخل gem را بدون نصب کردن به Gemfile اضافه می‌کند.
           می‌توانید بعداً جم‌ها را با bundle install نصب کنید.

           bundle add rails --skip-install

       5.  می‌توانید جم را به بیش از یک گروه اختصاص دهید.

           bundle add rails --group "development, test"




همچنین ببینید (SEE ALSO)
       Gemfile(5) https://bundler.io/man/gemfile.5.html, bundle-remove(1)
       bundle-remove.1.html

                                September 2025                   BUNDLE-ADD(1)