كيفية تثبيت واستخدام مدير حزم Yarn لـ Node.js

مقدمة

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

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

• A per-project caching mechanism, that can greatly speed up subsequent installs and builds
• التثبيت المتسق والحاسم الذي يضمن أن بنية المكتبات المثبتة دائمًا نفسها
• فحص التحقق من التماسك لجميع الحزم للتحقق من سلامتها
• “مساحات العمل”، التي تسهل استخدام Yarn في مستودع مصدر واحد (مشاريع متعددة تطور في مستودع مصدر واحد)

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

تثبيت واستخدام مدير حزم Yarn لـ Node.js

1. تثبيت Yarn بشكل عام
2. تثبيت Yarn في مشروعك
3. استخدام Yarn

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

قبل تثبيت واستخدام مدير حزم Yarn، ستحتاج إلى تثبيت Node.js. للتحقق مما إذا كان لديك Node.js بالفعل مثبتًا، اكتب الأمر التالي في وحدة التحكم المحلية:

node -v

إذا رأيت رقم إصدار مثل v12.16.3 مطبوعًا، فإنك تملك Node.js مثبتًا. إذا حصلت على خطأ “الأمر غير موجود” (أو عبارة مماثلة)، يرجى تثبيت Node.js قبل المتابعة.

لتثبيت Node.js، اتبع البرنامج التعليمي الخاص بنا لـ أوبونتو، ديبيان، سنت أو إس، أو ماكوس.

بمجرد تثبيت Node.js، انتقل إلى الخطوة 1 لتثبيت مدير حزم Yarn.

الخطوة 1 — تثبيت Yarn بشكل عام

Yarn لديه طريقة فريدة لتثبيت نفسه وتشغيله في مشاريعك بلغة الجافا سكريبت. أولاً، قم بتثبيت أمر yarn بشكل عام، ثم استخدم أمر yarn العام لتثبيت نسخة محلية محددة من Yarn في دليل مشروعك. هذا ضروري لضمان أن الجميع الذين يعملون على مشروع (وجميع أدوات الاختبار التلقائي ونشر المشروع) يقومون بتشغيل نفس الإصدار من yarn، لتجنب السلوكيات والنتائج غير المتسقة.يوصي أصحاب Yarn بتثبيت Yarn بشكل عام باستخدام مدير حزم NPM، الذي يتم تضمينه افتراضيًا مع جميع تثبيتات Node.js. استخدم العلامة -g مع npm install للقيام بذلك:

يوصي محترفو النسخة المحفوظة من الغزل بتثبيت الغزل على نطاق واسع باستخدام مدير الحزمة NPM، الذي يأتي بشكل افتراضي مع جميع تثبيتات Node.js. استخدم علامة -g مع npm install للقيام بذلك:

sudo npm install -g yarn

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

yarn --version

Output
1.22.11

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

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

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

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

أولاً، ابحث عن دليل مشروعك:

cd ~/my-project

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

mkdir my-project
cd my-project

الآن استخدم الأمر yarn set لتعيين الإصدار إلى 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 على العديد من الأوامر الفرعية، لكنك تحتاج فقط إلى عدد قليل منها للبدء. دعونا نلقي نظرة على أول الأوامر الفرعية التي سترغب في استخدامها.

الحصول على مساعدة

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

yarn --help

سيطبع هذا المساعدة الشاملة لأمر yarn. للحصول على معلومات أكثر تحديدًا حول أمر فرعي، أضف --help بعد الأمر الفرعي:

yarn install --help

سيطبع هذا تفاصيلًا حول كيفية استخدام أمر yarn install.

بدء مشروع 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/*
!.yarn/patches
!.yarn/releases
!.yarn/plugins
!.yarn/sdks
!.yarn/versions
.pnp.*

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

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

الخاتمة

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

لمزيد من المساعدة حول Node.js و JavaScript بشكل عام، يرجى زيارة الصفحات Node.js و JavaScript الخاصة بنا، حيث ستجد برامج تعليمية متعلقة، محاضرات تكنولوجيا المعلومات، وأسئلة المجتمع والإجابات عليها.