كيفية تفعيل واستخدام npm (مدير حزم Node.js) في ServBay

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

المتطلبات المسبقة

قبل استخدام npm، يجب أن تقوم بتثبيت Node.js عبر ServBay.

1. افتح تطبيق ServBay.
2. انتقل إلى لوحة "الحزم" (Packages).
3. ابحث عن حزمة Node.js وتأكد من أنها مثبتة وتعمل.

سيقوم ServBay تلقائيًا بإعداد بيئة Node.js، والتي تتضمن npm معه.

التأكد من تثبيت واستخدام npm

حزمة Node.js التي تُثبت من خلال ServBay تأتي مع npm مثبتًا ومفعّلًا افتراضيًا. يمكنك التأكد من أن npm مثبت وصالح للاستعمال عن طريق الطرفية بسرعة.

1. افتح تطبيق الطرفية لديك (مثل Terminal على macOS).

2. أدخل الأمر التالي لمعرفة إصدار npm:

   npm -v

   إذا تم تنفيذ الأمر بنجاح وتم عرض رقم الإصدار (مثلاً 10.2.0 أو أحدث)، فهذا يعني أن npm مثبت ويعمل بشكل صحيح في بيئتك الحالية.

   # مثال للمخرجات
   10.2.0

   إذا ظهرت لك رسالة خطأ مثل "command not found: npm"، تأكد أنك قمت بتثبيت حزمة Node.js عبر ServBay وأن متغيرات البيئة مفعّلة بشكل صحيح (غالباً، إعادة تشغيل الطرفية أو الجهاز تحل هذه المشكلة).

تحديث npm

رغم أن نسخة Node.js التي يتم تثبيتها مع ServBay غالباً ما تأتي مع نسخة مستقرة من npm، إلا أن npm نفسها يتم تحديثها بشكل منفصل عن Node.js. للحصول على أحدث الميزات والتحسينات، يمكنك تحديثها عبر الأمر التالي:

npm install -g npm@latest

هذا الأمر يقوم بتثبيت أحدث إصدار من npm بشكل عالمي (-g) بحيث يمكنك استخدامه في أي مكان من الطرفية.

بعد إتمام التحديث، تحقق من الإصدار مجددًا:

npm -v

الميزات الأساسية واستعمالات npm الشائعة

تكمن قوة npm في البيئة الضخمة مفتوحة المصدر وسهولة إدارة الاعتمادات. فيما يلي بعض الاستخدامات والأوامر الأساسية لـ npm في السيناريوهات اليومية:

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

لبداية مشروع Node.js جديد في مجلد فارغ، استخدم أمر npm init لإنشاء ملف package.json، وهو الملف الأساسي الذي يحتفظ ببيانات المشروع، الاعتمادات، والسكريبتات القابلة للتنفيذ.

cd /Applications/ServBay/www/my-new-project.servbay.demo
npm init

سيوجهك npm init لإدخال اسم المشروع، الإصدار، الوصف، ملف الدخول وغيرها. يمكنك كذلك استخدام npm init -y لإنشاء ملف package.json افتراضي بسرعة.

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

في مجلد المشروع (حيث يوجد ملف package.json)، يمكنك تثبيت جميع الاعتمادات المطلوبة بالأمر التالي:

cd /Applications/ServBay/www/my-project.servbay.demo
npm install

يقرأ هذا الأمر الاعتمادات المحددة في dependencies وdevDependencies داخل package.json ويقوم بتنزيلها إلى مجلد node_modules.

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

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

# تثبيت اعتماد للتشغيل مثل إطار Express
npm install express

# تثبيت اعتماد خاص بالتطوير مثل Mocha للاختبار
npm install mocha --save-dev

بشكل افتراضي، سيضيف npm install <package-name> الحزمة إلى مجلد node_modules ويحدث حقل dependencies في ملف package.json. عبر المعامل --save-dev، تتم إضافة الحزمة إلى devDependencies، وتكون عادة مخصصة لأدوات التطوير والاختبار والبناء.

إزالة اعتماد برمجي

إذا لم يعد مشروعك يحتاج لاعتماد معين، يمكنك إزالته بالأمر الآتي:

npm uninstall express

سيتم حذف الحزمة من node_modules وتحديث ملف package.json تلقائياً.

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

لضمان أن اعتمادات مشروعك هي الأحدث ضمن النطاق المحدد بـ package.json، استخدم الأمر التالي:

npm update

سيبحث الأمر في حزم مجلد node_modules ويقوم بتحديثها إلى أحدث إصدار متوافق حسب ما هو محدد في package.json.

استعمال سكريبتات npm (Scripts)

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

مثال على إضافة بعض السكريبتات إلى package.json:

{
  "name": "my-project",
  "version": "1.0.0",
  "scripts": {
    "start": "node index.js",
    "test": "mocha test/**/*.js",
    "build": "webpack --config webpack.config.js"
  },
  "dependencies": {
    "express": "^4.18.2"
  },
  "devDependencies": {
    "mocha": "^10.2.0",
    "webpack": "^5.89.0"
  }
}

بعدها يمكنك تنفيذ السكريبتات من الطرفية:

# تشغيل التطبيق
npm start

# تنفيذ اختبارات
npm test

# بناء المشروع
npm run build

تنبيه: بعض أسماء السكريبتات الخاصة مثل start, test, install, restart, stop يمكنك تشغيلها مباشرةً بدون كتابة run، مثلاً: npm start، npm test، إلخ.

أهم أوامر npm المختصرة

بالإضافة للأوامر الأساسية السابقة، إليك بعض الأوامر المفيدة الأخرى في npm:

• تثبيت حزمة بشكل عالمي: لتثبيت الأدوات التي يمكن استخدامها من أي مكان في النظام.

  npm install -g <package-name>
  # مثلاً، تثبيت npx لتشغيل أوامر مؤقتة (غالباً يرافق Node.js)
  npm install -g npx
  # تثبيت nodemon، أداة شائعة لإعادة تشغيل التطبيقات أوتوماتيكياً أثناء التطوير
  npm install -g nodemon

• تشغيل أوامر مؤقتة (npx): أداة npx مضمنة مع npm من الإصدار 5.2+ وتستخدم لتشغيل أوامر من node_modules/.bin أو تحميل وتشغيل حزمة مؤقتاً دون تثبيتها عالمياً.

  # إنشاء تطبيق React جديد بدون الحاجة لتثبيت create-react-app عالمياً
  npx create-react-app my-react-app

• عرض قائمة الحزم المثبتة عالمياً: لمعرفة جميع الحزم المثبتة عالمياً وإصداراتها.

  npm list -g --depth=0

• تنظيف كاش npm: إذا واجهت مشاكل أثناء التثبيت، قد يكون السبب الكاش؛ حاول حذفه.

  npm cache clean --force

• معلومات عن الحزمة: لرؤية جميع التفاصيل حول حزمة ما، مثل الإصدار، الاعتمادات، والريبو.

  npm view <package-name>

• البحث عن الحزم: للبحث عن الحزم في مستودع npm.

  npm search <keyword>

استكشاف المشاكل الشائعة

• npm command not found: تأكد من أنك ثبتت حزمة Node.js عبر ServBay وأن الطرفية بإمكانها الوصول لمسار تثبيت Node.js و npm. غالباً إعادة تشغيل الطرفية أو الجهاز تحل المشكلة.
• فشل تثبيت الاعتمادات: تحقق من اتصالك بالإنترنت. أحياناً قد تسبب إعدادات البروكسي في مكان العمل مشكلة ويحتاج الأمر لضبط إعدادات البروكسي في npm. يمكنك أيضاً محاولة تنظيف كاش npm (npm cache clean --force) وإعادة المحاولة.
• مشاكل الصلاحيات: على macOS، قد تصادف مشاكل صلاحيات مع التثبيت العالمي (npm install -g). يُنصح باستخدام Node Version Manager (nvm) أو التأكد أن ServBay ضبط مسار التثبيت بشكل سليم. تجنب استخدام sudo لتثبيت الحزم عالمياً لأن هذا قد يؤدي لمشاكل لاحقاً. في العادة، ServBay يعالج مشاكل الصلاحيات ويوفر بيئة آمنة داخل مجلد تثبيته.

خاتمة

مع ServBay، يمكنك تجهيز بيئة تطوير Node.js متكاملة وقوية على جهازك المحلي بسهولة والبدء فوراً في استخدام أداة npm القوية لإدارة الحزم وتطوير المشروع. إتقانك لأوامر npm الأساسية واستعمالاتها الشائعة سيرفع إنتاجيتك في التطوير بدرجة كبيرة. ومع تعمقك في نظام Node.js البيئي، ستكتشف أن npm شريك لا يمكن الاستغناء عنه في رحلتك البرمجية.