إدارة حزم Node.js باستخدام Yarn في ServBay

يأتي ServBay كبيئة تطوير ويب محلية قوية مع دعم مدمج لـ Node.js. تعتبر أداة  Yarn، التي طورتها شركة Facebook، من أدوات إدارة الحزم السريعة والموثوقة والآمنة، والتي تشبه npm لكنها توفر سرعات تثبيت أعلى، ودعماً أفضل للعمل دون اتصال، واستقراراً أكبر في إدارة الاعتمادات. باستعمال Yarn ضمن بيئة Node.js في ServBay، يمكن للمطورين إدارة اعتمادات المشاريع بكفاءة أعلى وزيادة الإنتاجية البرمجية.

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

قبل البدء باستخدام Yarn، تأكد من أنك قمت بتثبيت وتفعيل حزمة Node.js عبر ServBay. تسمح لك خاصية إدارة الحزم في ServBay بتثبيت وتبديل نسخ Node.js المختلفة بسهولة.

تثبيت وتفعيل Yarn

عادةً تأتي حزمة Node.js المثبتة من خلال ServBay متضمنة أداة Corepack، وهي أداة تجريبية في Node.js لإدارة ونشر مديري الحزم (مثل npm وYarn وpnpm). تضمن Corepack غالباً إمكانية استخدامك لأمر yarn، كما تقوم بتوجيهك لتثبيت نسخة محددة من Yarn عند الحاجة.

التحقق من تثبيت Yarn

قبل البدء باستخدام Yarn، يفضل التأكد من توفره في بيئة ServBay لديك. افتح الطرفية (Terminal) وادخل الأمر التالي لعرض رقم نسخة Yarn:

yarn -v

إذا كان Yarn مثبتاً وموجوداً ضمن PATH النظام، ستظهر لك نتيجة رقم النسخة مشابهة لما يلي:

1.22.19

أو إصدار أحدث.

تثبيت أو تحديث Yarn عبر Corepack

عند تشغيل أمر yarn للمرة الأولى، إذا اكتشفت Corepack أنه بحاجة لتثبيت نسخة محددة من Yarn، فغالباً ستظهر الرسالة التالية:

$ yarn -v
! Corepack is about to download https://registry.yarnpkg.com/yarn/-/yarn-1.22.22.tgz
? Do you want to continue? [Y/n]

هذه رسالة من Corepack تسألك الإذن لتحميل وتثبيت نسخة Yarn المشار إليها. أدخل Y ثم اضغط Enter للمتابعة. بعد انتهاء التثبيت، ستستخدم Corepack النسخة الجديدة تلقائياً وتعرض رقم الإصدار:

1.22.22

تثبيت أو تحديث Yarn يدوياً عبر npm

إذا لم تظهر لك رسالة Corepack، أو رغبت في تثبيت أو تحديث نسخة Yarn عالمياً عبر npm، استخدم الأمر التالي:

npm install -g yarn

يقوم هذا الأمر بتثبيت أو تحديث أداة Yarn بشكل عالمي باستعمال npm المثبت على النظام.

بعد انتهاء التثبيت أو التحديث، تحقق مجدداً من نسخة Yarn للتأكد من تفعيله بنجاح:

yarn -v

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

مزايا Yarn واستخداماته الأساسية

تتجلى قوة Yarn في سرعته بتثبيت الاعتمادات، ودعمه المتطور للعمل دون اتصال، واعتماديته العالية في حل التعارضات بين الحزم. فيما يلي بعض الأوامر الأساسية التي تحتاجها أثناء العمل مع Yarn:

تهيئة مشروع جديد

في المجلد الجذر للمشروع، يمكنك تهيئة مشروع Node.js جديد وإنشاء ملف package.json باستخدام:

yarn init

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

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

بداخل مجلد المشروع الذي يحتوي على package.json، يمكنك تثبيت جميع الاعتمادات المدرجة عبر الأمر التالي:

yarn install

سيتم بناء جميع الحزم المطلوبة وفقاً لـ package.json و yarn.lock وتثبيتها في مجلد node_modules.

إضافة اعتماد جديد

لإضافة اعتماد إنتاجي جديد (سيضاف إلى قسم dependencies):

yarn add lodash

وللإضافة إلى اعتمادات التطوير (devDependencies):

yarn add --dev jest

وللحزم العامة (رغم أن الأفضل عدم استخدامها إلا للضرورة، ويفضل npx أو أدوات التثبيت العالمية):

yarn global add <package-name>

إزالة اعتماد

لإزالة حزمة معينة من المشروع:

yarn remove lodash

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

تحديث اعتمادات المشروع

لتحديث جميع الاعتمادات إلى أحدث نسخة مطابقة لنطاقات الإصدارات في package.json:

yarn upgrade

أما إذا احتجت لتحديث إطلاق رئيسي أو ثانوي أو تصحيحي، يمكنك استعمال yarn upgrade --latest أو أدوات مثل yarn-upgrade-all.

تشغيل سكريبتات المشروع

يتيح لك Yarn تعريف سكريبتات مخصصة في خانة "scripts" ضمن package.json، لتنفيذ مهام مخصصة للمشروع (مثل تشغيل سيرفر التطوير، تنفيذ الاختبارات، بناء المشروع...إلخ).

مثال لتعريف سكريبتات داخل package.json:

"scripts": {
  "start": "node app.js",
  "test": "jest",
  "build": "webpack --config webpack.config.js"
}

ويمكنك فيما بعد تشغيل هذه السكريبتات عبر الأوامر التالية:

yarn start
yarn test
yarn build

أوامر Yarn الشائعة الأخرى

• تثبيت الحزم العامة:

  yarn global add <package-name>

  كمثال لتثبيت أداة create-react-app عالمياً:

  yarn global add create-react-app

• عرض الحزم المثبتة عالمياً:

  yarn global list

• تنظيف التخزين المؤقت: يقوم Yarn بتخزين الحزم لتسريع عمليات التثبيت المستقبلية. إذا واجهت مشاكل في الكاش، يمكنك تنظيفه باستخدام:

  yarn cache clean

  للمزيد حول تنظيف الكاش لإصدارات Yarn 2 وما بعدها، يرجى مراجعة وثائق النسخة ذات الصلة.

الخلاصة

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