كيفية تثبيت واستخدام Yarn Package Manager لـ Node.js

مقدمة

Yarn هو مدير حزم لـ Node.js، يُركز على السرعة والأمان والاستقرار. صُمم في الأصل لإصلاح بعض المشاكل في مدير الحزم الشهير NPM. على الرغم من تقارب وظائف وميزات مديري الحزم منذ ذلك الحين، إلا أن Yarn لا يزال شائعًا، خاصةً في عالم تطوير React.

تتضمن بعض ميزات Yarn الفريدة ما يلي:

• آلية التخزين في كل مشروع، مما يمكن أن يسرع بشكل كبير من التثبيت والبناء اللاحق.
• التثبيتات الثابتة والنهائية التي تضمن أن بنية المكتبات المثبتة هي نفسها دائمًا.
• اختبار تجميع جميع الحزم للتحقق من سلامتها
• “"مساحات العمل" التي تسهل استخدام Yarn في مستودع أحادي (مشاريع متعددة تم تطويرها في مستودع كود مصدر واحد).

في هذا البرنامج التعليمي، سوف تقوم بتثبيت Yarn عالميًا، وإضافة Yarn إلى مشروع معين، وتعلم بعض أوامر Yarn الأساسية.

المتطلبات الأساسية

قبل تثبيت واستخدام مدير حزم Yarn، يجب تثبيت Node.js. للتحقق من تثبيت Node.js، اكتب الأمر التالي في سطر الأوامر المحلي:

node -v

إذا رأيت رقم الإصدار مطبوعًا مثل v12.16.3، فهذا يعني أن Node.js مُثبّت لديك. إذا واجهت خطأ "لم يتم العثور على الأمر" (أو ما شابه)، يُرجى تثبيت Node.js قبل المتابعة.

الخطوة 1 – تثبيت YARN العالمي

يتميز Yarn بطريقة فريدة لتثبيته وتشغيله في مشاريع JavaScript. أولًا، ثبّت Yarn عالميًا، ثم استخدم أمر yarn العالمي لتثبيت إصدار محلي محدد من Yarn في مجلد مشروعك. هذا ضروري لضمان استخدام جميع العاملين في المشروع (وجميع أدوات الاختبار والنشر الآلية للمشروع) نفس إصدار Yarn، لتجنب أي تضارب في الأداء والنتائج.

يُوصي مُطوّرو Yarn بتثبيت Yarn عالميًا باستخدام مدير حزم NPM، المُضمّن افتراضيًا في جميع تثبيتات Node.js. للقيام بذلك، استخدم الأمر -g مع تثبيت npm:

sudo npm install -g yarn

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

yarn --version

Output
1.22.11

الآن بعد أن قمت بتثبيت أمر yarn عالميًا، يمكنك استخدامه لتثبيت Yarn في مشروع JavaScript محدد.

الخطوة 2 – تركيب الغزل في مشروعك

إذا كنت تستخدم Yarn للعمل على مشروع قائم قائم عليه، يمكنك تخطي هذه الخطوة. يجب أن يكون المشروع مُعدًّا مسبقًا بإصدار محلي من Yarn وجميع ملفات التكوين اللازمة لاستخدامه.

إذا كنت تبدأ مشروعًا جديدًا لنفسك، فستحتاج الآن إلى تكوين إصدار من Yarn مخصص للمشروع.

أولاً، انتقل إلى دليل المشروع الخاص بك:

cd ~/my-project

إذا لم يكن لديك دليل مشروع، فيمكنك إنشاء مجلد جديد باستخدام mkdir ثم إدخاله:

mkdir my-project
cd my-project

الآن من الأمر مجموعة خيوط لتعيين إصدار Berry استخدم:

yarn set version berry

سيؤدي هذا إلى تنزيل الإصدار الحالي المطوّر من Yarn - berry - وحفظه في دليل .yarn/releases/ في مشروعك، كما سيؤدي أيضًا إلى إعداد ملف تكوين .yarnrc.yml:

Output
Resolving berry to a url...
Downloading https://github.com/yarnpkg/berry/raw/master/packages/berry-cli/bin/berry.js...
Saving it into /home/sammy/my-project/.yarn/releases/yarn-berry.cjs...
Updating /home/sammy/my-project/.yarnrc.yml...
Done!

حاول الآن استخدام أمر yarn --version مرة أخرى:

yarn --version

Output
3.0.0

ستجد أن الإصدار هو 3.0.0 أو أعلى. هذا هو أحدث إصدار من Yarn.

تم الآن إعداد مشروعك باستخدام إصدار خاص من Yarn. سنلقي نظرة على بعض أوامر Yarn الشائعة الاستخدام لمساعدتك في البدء.

استخدام الغزل

يحتوي Yarn على العديد من الأوامر الفرعية، لكنك تحتاج فقط إلى بعضها للبدء. لنلقِ نظرة على أول الأوامر الفرعية التي ستحتاج إلى استخدامها.

عند البدء باستخدام أي أداة جديدة، من المفيد معرفة كيفية الوصول إلى تعليماتها عبر الإنترنت. في Yarn، يمكنك إضافة علامة --help إلى أي أمر للحصول على مزيد من المعلومات:

yarn --help

هذا يطبع تعليمات عامة لأمر الغزل. للحصول على معلومات أكثر تفصيلاً حول أمر فرعي، أضف –help بعده:

yarn install --help

سيؤدي هذا إلى طباعة تفاصيل حول كيفية استخدام أمر تثبيت yarn.

بدء مشروع YARN جديد

إذا كنت تبدأ مشروعًا من الصفر، فاستخدم الأمر الفرعي init لإنشاء الملفات الخاصة بـ Yarn التي تحتاجها:

yarn init

سيؤدي هذا إلى إضافة ملفي تكوين package.json وyarn.lock إلى دليلك. يحتوي ملف package.json على تكوين وقائمة التبعيات الخاصة بوحدتك. يُقفل ملف yarn.lock هذه التبعيات على إصدارات محددة، مما يضمن اتساق شجرة التبعيات دائمًا.

تثبيت جميع التبعيات للمشروع

لتنزيل جميع التبعيات وتثبيتها في مشروع قائم على Yarn، استخدم الأمر الفرعي install:

yarn install

سيؤدي هذا إلى تنزيل وتثبيت الوحدات التي تحتاجها للبدء.

إضافة اعتماد جديد إلى مشروع

استخدم الأمر الفرعي add لإضافة تبعيات جديدة إلى المشروع:

yarn add package-name

سيؤدي هذا إلى تنزيل الوحدة وتثبيتها وتحديث ملفات package.json وyarn.lock.

تحديث الملف .gitignore للغزل

يخزن Yarn الملفات في مجلد .yarn ضمن دليل مشروعك. يجب التحقق من بعض هذه الملفات في نظام التحكم بالإصدارات، وتجاهل بعضها الآخر. إعدادات Yarn الأساسية لملف .gitignore هي كما يلي:

.yarn/*
!.yarn/patches
!.yarn/releases
!.yarn/plugins
!.yarn/sdks
!.yarn/versions
.pnp.*

سيؤدي هذا إلى تجاهل دليل yarn. بأكمله ثم إضافة بعض الاستثناءات للمجلدات المهمة، بما في ذلك دليل الإصدارات الذي يحتوي على إصدار Yarn الخاص بمشروعك.

لمزيد من التفاصيل حول كيفية تكوين Git وYarn، يرجى الرجوع إلى وثائق Yarn الرسمية على .gitignore.

نتيجة

في هذا البرنامج التعليمي، ثبّتتَ Yarn وتعرّفتَ على بعض أوامره الفرعية. لمزيد من المعلومات حول استخدام Yarn، يُرجى الاطلاع على وثائق Yarn CLI الرسمية.