volta pin

أمر volta pin سيثبت ملف package.json للمشروع لاستخدام الإصدار المحدد من الأداة. له الصيغة التالية:

تثبيت وقت التشغيل أو مدير الحزم لمشروعك

الاستخدام:
    volta pin [FLAGS] <tool[@version]>...

الأعلام:
        --verbose    تمكين التشخيص المفصل
        --quiet      منع المخرجات غير الضرورية
    -h, --help       طباعة معلومات المساعدة

المعاملات:
    <tool[@version]>...    الأداة المراد تثبيتها، مثل `node@lts` أو `yarn@^1.14`.

ملاحظةvolta pin ينطبق فقط على Node ومديري الحزم (مثل npm أو Yarn). للتبعيات، يجب استخدام npm install أو yarn add لتحديث الإصدار المحدد.

أمثلة

تثبيت Node.js

# تثبيت أحدث إصدار LTS من Node
volta pin node

# تثبيت إصدار محدد من Node
volta pin node@16.14.2

# تثبيت نطاق إصدار Node
volta pin node@16

عندما تثبت إصدار Node.js، يضيف Volta قسم volta في ملف package.json للمشروع:

{
  "volta": {
    "node": "16.14.2"
  }
}

تثبيت مديري الحزم

# تثبيت أحدث إصدار npm
volta pin npm

# تثبيت إصدار محدد من Yarn
volta pin yarn@1.22.19

# تثبيت pnpm (إذا تم تمكين علم الميزة)
VOLTA_FEATURE_PNPM=1 volta pin pnpm@7.0.0

تثبيت مديري الحزم يضيفها إلى قسم volta في package.json:

{
  "volta": {
    "node": "16.14.2",
    "npm": "8.5.0"
  }
}

حالات الاستخدام

أمر volta pin ضروري لـ:

• إنشاء بيئة تطوير متناسقة في فريقك
• ضمان استخدام الجميع الذين يعملون على المشروع نفس إصدار Node.js ومدير الحزم
• منع مشاكل "يعمل على جهازي"
• توثيق إصدار Node.js المتوافق مع مشروعك

تأثير التثبيت

عندما تثبت أداة:

1. إذا لم تكن لديك الأداة بعد، سيتم تثبيتها تلقائيًا
2. يتم كتابة الإصدار في قسم volta من package.json
3. أي شخص يستخدم Volta للعمل على المشروع سيستخدم تلقائيًا الإصدار المحدد
4. أنظمة CI/CD التي تستخدم Volta ستستخدم الإصدار الصحيح

الأدوات المثبتة لها أولوية على إصدارات الأدوات الافتراضية المعينة باستخدام volta install.

تفاصيل package.json

يمكن أن يتضمن قسم volta في package.json:

{
  "volta": {
    "node": "16.14.2",    // إصدار دقيق
    "npm": "^8.5.0",      // نطاق Semver
    "yarn": "1.22.19",    // إصدار دقيق
    "pnpm": "7.0.0"       // إذا تم تمكين دعم pnpm
  }
}

يمكن أن تكون محددات الإصدار:

• إصدار دقيق: 16.14.2
• الإصدار الرئيسي: 16
• الإصدار الرئيسي.الثانوي: 16.14
• نطاق Semver: ^16.14.0
• العلامات: lts، latest