إدارة مشروعك

يتيح Volta للفرق والمتعاونين توحيد أدوات التطوير التي يستخدمونها في مشاريعهم. سيعلمك هذا الدليل كيفية استخدام Volta لإدارة مشروعك بفعالية.

تثبيت إصدارات الأدوات

أهم ميزة لإدارة المشروع في Volta هي القدرة على تثبيت إصدارات محددة من الأدوات لمشروعك:

تثبيت Node.js

لتحديد إصدار Node.js الذي يجب أن يستخدمه مشروعك:

volta pin node@16.14.2

يمكنك أيضًا التثبيت على الإصدار الرئيسي أو الثانوي، وسيستخدم Volta أحدث إصدار متطابق:

volta pin node@16

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

وبالمثل، يمكنك تثبيت إصدارات npm و Yarn:

volta pin npm@8.5.0
volta pin yarn@1.22.18

كيف يعمل التثبيت

عندما تثبت إصدار أداة، يقوم Volta بـ:

1. تحديث ملف package.json لمشروعك باستخدام قسم volta
2. إرسال هذه المعلومات إلى التحكم في الإصدار
3. ضمان استخدام الجميع في الفريق نفس الإصدار

إليك كيف سيبدو قسم volta في package.json الخاص بك:

{
  "name": "your-project",
  "version": "1.0.0",
  "volta": {
    "node": "16.14.2",
    "npm": "8.5.0",
    "yarn": "1.22.18"
  }
}

الأدوات المحلية للمشروع

يحترم Volta أيضًا تثبيت الأدوات المحلية للمشروع:

استخدام ملفات الحزم الثنائية المحلية

عندما تثبت حزمة محليًا في مشروعك:

npm install typescript
# أو
yarn add typescript

يمكنك تشغيل ملفاتها الثنائية عبر Volta:

volta run tsc
# أو ببساطة
tsc

سيستخدم Volta إصدار Node.js المثبت للمشروع لتشغيل هذه الأدوات.

دعم مساحة العمل

لإعدادات monorepo ذات مشاريع متعددة، يدعم Volta وراثة التكوين:

تمديد التكوين

في مساحة عمل بها مشاريع متعددة، يمكنك تعيين التكوين الأساسي في package.json الجذر:

{
  "volta": {
    "node": "16.14.2",
    "yarn": "1.22.18"
  }
}

ثم في ملفات package.json للمشاريع الفردية، مدد تكوين الجذر:

{
  "volta": {
    "extends": "../../package.json"
  }
}

هذا يسمح لك بالحفاظ على إصدارات الأدوات المتناسقة بين جميع المشاريع في مساحة العمل.

أفضل ممارسات إدارة المشروع

إليك بعض الممارسات الموصى بها لاستخدام Volta في إدارة المشروع:

1. ثبت أدواتك دائمًا

ثبت إصدارات Node.js ومديري الحزم لكل مشروع:

volta pin node
volta pin npm
# أو
volta pin yarn

هذا يضمن أن جميع أعضاء الفريق لديهم بيئة تطوير متناسقة.

2. أرسل تكوين Volta

أرسل دائمًا قسم volta في package.json إلى التحكم في الإصدار. هذه هي طريقة Volta لمشاركة التكوين مع فريقك.

3. وثق متطلبات الأدوات

في README لمشروعك، اذكر أنك تستخدم Volta لإدارة الأدوات:

## التطوير

يستخدم هذا المشروع [Volta](https://volta.sh) لضمان تناسق الأدوات.
قم بتثبيت Volta، وسيتم استخدام الإصدارات الصحيحة من Node.js و npm تلقائيًا.

4. استخدم تكامل CI/CD

في بيئة التكامل المستمر، اجعل تثبيت Volta جزءًا من عملية البناء:

# مثال GitHub Actions
- name: Install Volta
  uses: volta-cli/action@v1

# سيقوم Volta تلقائيًا باستخدام الإصدارات الصحيحة من Node.js و npm/yarn
- name: Install dependencies
  run: npm install

5. توحيد عبر المشاريع

للمؤسسات ذات المشاريع المتعددة، حقق التوحيد في إصدارات الأدوات قدر الإمكان لتقليل عدد الإصدارات التي يحتاج المطورون لتثبيتها.

من خلال استخدام Volta لإدارة مشروعك بفعالية، تضمن أن جميع أعضاء الفريق لديهم بيئة تطوير متناسقة، مما يقلل من مشاكل "يعمل على جهازي" ويجعل التعاون أكثر سلاسة.