دليل المطور: فرض استخدام Yarn أو npm في مشاريعك لضمان التوافقية والانضباط

مقدمة: لماذا نحتاج لتوحيد مدير الحزم؟

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

أهمية توحيد مدير الحزم في المشاريع البرمجية

قد يبدو فرض استخدام مدير حزم معين خطوة إضافية، لكنها تحمل في طياتها فوائد جمة تسهم في استقرار المشروع وسلاسة سير العمل:

تجنب أخطاء التبعيات

على الرغم من أن npm و Yarn يقومان بنفس الوظيفة الأساسية، إلا أن هناك اختلافات دقيقة في كيفية حل التبعيات وتخزينها. قد يؤدي استخدام مدير حزم مختلف إلى تثبيت إصدارات غير متوافقة من المكتبات، أو حتى إنشاء بنية مجلدات مختلفة لـ node_modules، مما يتسبب في أخطاء غريبة يصعب تتبعها أثناء التشغيل أو البناء.

تعزيز التعاون وتوحيد بيئة التطوير

عندما يلتزم جميع أعضاء الفريق بمدير حزم واحد، فإن ذلك يضمن أن بيئة التطوير لكل منهم متطابقة قدر الإمكان. هذا يقلل من عبارة “يعمل على جهازي!” الشهيرة، ويسهل عملية دمج الكود واختباره، ويوفر وقتاً ثميناً كان سيضيع في تصحيح الأخطاء المتعلقة بالتبعيات.

الخطوات الأساسية لفرض استخدام مدير حزم محدد

تتمحور هذه الآلية حول تعديل ملفين رئيسيين في جذر مشروعك: .npmrc و package.json.

تهيئة ملف .npmrc

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

// .npmrc file
engine-strict = true

الخاصية engine-strict = true تخبر مدير الحزم بضرورة الالتزام بالإصدارات المحددة للمحركات (engines) في ملف package.json بدقة. هذا هو المفتاح الأول في آليتنا.

تعديل ملف package.json

ملف package.json هو قلب أي مشروع يعتمد على Node.js، ويحتوي على معلومات حول المشروع وتبعيته. سنقوم بإضافة قسم engines أو تعديله إذا كان موجوداً بالفعل. هذا القسم يتيح لنا تحديد إصدارات معينة لـ node، npm، و Yarn التي يتوقعها المشروع.

لنفترض أننا نريد فرض استخدام Yarn ومنع استخدام npm. سنقوم بتعديل قسم engines كالتالي:

// package.json
{
  ...
  "engines": {
    "npm": "please-use-yarn",
    "yarn": ">= 1.19.1"
  },
  ...
}

في هذا المثال:

• حددنا أن إصدار Yarn المطلوب هو 1.19.1 أو أحدث (>= 1.19.1).
• بالنسبة لـ npm، قمنا بتحديد إصدار غير موجود على الإطلاق: please-use-yarn.

عندما يحاول مطور تشغيل npm install (أو أي أمر npm آخر) بعد تفعيل engine-strict، سيقوم npm بالتحقق من قسم engines. وبما أن الإصدار المطلوب لـ npm (وهو please-use-yarn) لا يتطابق مع أي إصدار فعلي، فسيقوم npm بإلقاء خطأ، مانعاً بذلك استخدامه وموجهاً المطور لاستخدام Yarn بدلاً من ذلك.

اختبار الآلية: محاولة استخدام مدير الحزم غير المرغوب فيه

بعد تطبيق التغييرات المذكورة أعلاه في ملفي .npmrc و package.json، حاول تشغيل npm install في مجلد مشروعك. ستلاحظ أن العملية لن تكتمل بنجاح، وستتلقى رسالة خطأ مشابهة لهذه:

npm ERR! code ENOTSUP
npm ERR! notsup Unsupported engine for my-app@0.1.0: wanted: {"npm":"please-use-yarn","yarn":">= 1.19.1"} (current: {"node":"12.16.3","npm":"6.14.4"})
npm ERR! notsup Not compatible with your version of node/npm: my-app@0.1.0
npm ERR! notsup Required: {"npm":"please-use-yarn","yarn":">= 1.19.1"}
npm ERR! notsup Actual: {"npm":"6.14.4","node":"12.16.3"}
npm ERR! A complete log of this run can be found in :
npm ERR! C:\Users\YourUser\AppData\Roaming\npm-cache\_logs\2020-05-21T10_21_04_676Z-debug.log

توضح رسالة الخطأ هذه بوضوح أن مدير الحزم npm غير مدعوم للإصدارات المحددة، وتحديداً يبرز أن الإصدار المطلوب لـ npm هو please-use-yarn، وهو ما لا يتطابق مع الإصدار الحالي المثبت (6.14.4 في هذا المثال). هذه هي الطريقة التي تضمن بها أن المطورين سيستخدمون Yarn.

تطبيق الآلية لفرض استخدام npm بدلاً من Yarn

إذا كان هدفك هو العكس، أي فرض استخدام npm ومنع استخدام Yarn، يمكنك ببساطة عكس التكوين في قسم engines بملف package.json ليصبح كالتالي:

// package.json
{
  ...
  "engines": {
    "npm": ">= 6.14.4", // أو أي إصدار npm مطلوب
    "yarn": "please-use-npm"
  },
  ...
}

بهذه الطريقة، سيتم منع استخدام Yarn وإجبار المطورين على استخدام npm.

الخلاصة التقنية

تعتبر هذه الطريقة البسيطة والفعالة لفرض استخدام مدير حزم معين في مشاريعك البرمجية ممارسة احترافية لا غنى عنها في بيئات التطوير الحديثة. إنها لا تقتصر فقط على تجنب المشاكل التقنية المتعلقة بالتبعيات، بل تمتد لتشمل تعزيز الانضباط وتوحيد المعايير داخل الفريق. من خلال بضعة أسطر من التكوين في ملفي .npmrc و package.json، يمكنك ضمان بيئة عمل متسقة وموثوقة، مما يقلل من الأخطاء ويزيد من إنتاجية المطورين. تذكر دائماً أن توحيد الأدوات هو خطوة أساسية نحو بناء برمجيات قوية ومستقرة.