| 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 |