برامج التثبيت

تفاصيل حول كيفية عمل برامج التثبيت وكيفية إنشاء برامج تثبيت/توزيع مخصصة خاصة بك للتثبيت المستضاف.

برامج التثبيت الحالية

اعتبارًا من Volta 0.7.0، تعمل جميع برامج التثبيت الرسمية بنفس الطريقة:

1. استخراج الملفات الثنائية لـ Volta
2. استدعاء volta setup باستخدام الملف الثنائي المستخرج volta (انظر volta setup لمزيد من المعلومات)

برنامج تثبيت Windows

برنامج تثبيت Windows يستخرج جميع الملفات الثنائية إلى Program Files\Volta ويضيف تلك المجلد إلى متغير البيئة Path للنظام. كما سينشئ shims في ذلك الدليل للأدوات التالية:

• node
• npm
• npx
• yarn

برامج تثبيت Unix

برامج تثبيت Unix تستخرج جميع الملفات الثنائية إلى ~/.volta/bin، لذا فهي تثبت فقط لمستخدم محدد.

تخطي إعداد Volta

إذا كنت ترغب في تشغيل برنامج التثبيت ولكن لا تريد أن يعدل volta setup سكريبتات ملفات التكوين الخاصة بك، يمكنك تمرير خيار --skip-setup إلى برنامج التثبيت:

curl https://get.volta.sh | bash -s -- --skip-setup

WARNING

نحن لا ندعم حاليًا تخطي volta setup على Windows.

Github CI

للراحة، نوفر Github action مخصص سيقوم تلقائيًا بتحميل Volta، تخزينه مؤقتًا، وتحميل الأدوات المثبتة في package.json للمشروع.

تثبيت الإصدارات القديمة

سكريبت برنامج التثبيت الافتراضي المقدم من get.volta.sh يدعم فقط تثبيت Volta 1.1.0 والإصدارات الأحدث. إذا كنت ترغب في تثبيت إصدار أقدم، يمكنك استخدام السكريبت التالي على Unix، مع استبدال 1.0.8 بالإصدار الذي تريد تثبيته:

curl https://raw.githubusercontent.com/volta-cli/volta/8f2074f423c65405dfba9858d9bcf393c38ffb45/dev/unix/volta-install.sh | bash -s -- --version 1.0.8

لـ Windows، يمكنك تحميل وتثبيت ملف برنامج التثبيت .msi لإصدار محدد.

WARNING

Volta لا يدعم التخفيض، لذا للتخفيض، تحتاج إلى إلغاء تثبيت Volta بالكامل، ثم تثبيت الإصدار الأقل.

برامج التثبيت المخصصة

لإنشاء برامج تثبيت/طرق توزيع مخصصة، هناك خطوتان مطلوبتان وخطوة اختيارية:

توزيع الملفات الثنائية

الملفات الثنائية نفسها تحتاج إلى نقلها إلى الجهاز المستهدف. volta.manifest في ملف الإصدار سيحدد قائمة الملفات الثنائية المطلوبة. اعتبارًا من Volta 0.7.0، الملفات المطلوبة هي:

• volta[.exe]
• volta-shim[.exe]
• volta-migrate[.exe]

جميع هذه الملفات الثنائية تحتاج إلى توزيعها في نفس الدليل، ويجب أن يكون ذلك الدليل في PATH حتى تعمل استدعاءات أمر volta بشكل صحيح.

دليل الـ Shims

دليل Volta shims يحتاج أيضًا إلى إضافته إلى PATH حتى تعمل الـ shims كما هو متوقع. يقع دليل الـ shims في $VOLTA_HOME/bin (%VOLTA_HOME%\bin على Windows)، حيث VOLTA_HOME افتراضيًا هو:

• ~/.volta على Unix
• %LOCALAPPDATA%\Volta على Windows

إذا لزم الأمر، يمكن إدارة تحديث PATH يدويًا، أو يمكن استدعاء volta setup (كما تفعل برامج التثبيت الرسمية، كما هو موضح أعلاه).

دليل Volta الرئيسي المخصص (اختياري)

إذا كنت ترغب في استخدام دليل مختلف عن VOLTA_HOME الافتراضي المذكور في القسم السابق لبيانات Volta، فستحتاج إلى تعيين متغير البيئة VOLTA_HOME إلى ذلك الدليل. إذا تم تعيين هذا المتغير، فإن volta setup لا يزال يعمل بشكل صحيح لدليل البيانات المخصص.