يعد Node Package Manager ، المعروف باسم npm ، مستودعًا عبر الإنترنت لنشر حزم ومكتبات NodeJS.
إنها أيضًا أداة سطر أوامر تتيح لك التفاعل مع الحزم المسجلة. يمكن أن يساعد في تثبيت الحزمة وإدارة الإصدار وإدارة التبعية.
ينشر المطورون مكتبات JavaScript الخاصة بهم على npm كل يوم. العملية بسيطة إلى حد ما ، لذا يمكنك أيضًا نشر حزمة على npm.
الخطوة 1: تثبيت NodeJS
للتفاعل مع npm ، يجب أن يكون مثبتًا عالميًا على نظامك.
ابدأ ب تثبيت NodeJS و npm على أوبونتو, على نظام التشغيل Windows، أو باتباع التعليمات الموجودة على NodeJS موقع الكتروني.
الخطوة 2: إنشاء حساب npm
لنشر الحزم الخاصة بك على npm ، يجب عليك إنشاء حساب npm على موقع npm الرسمي.
اتبع الخطوات أدناه لإنشاء حساب npm:
- اذهب إلى تسجيل npm صفحة.
- املأ بياناتك ، ووافق على الترخيص وسياسة الخصوصية ، وانقر على "إنشاء حساب".
- تحقق من بريدك الإلكتروني باستخدام الرابط الذي ستتلقاه من npm في صندوق البريد الخاص بك.
إذا لم تتحقق من عنوان بريدك الإلكتروني ، فإن npm ستظهر خطأ عند محاولة نشر الحزم الخاصة بك.
الخطوة 3: تهيئة مستودع Git
بعد ذلك ، تحتاج إلى تهيئة مستودع Git لتتبع جميع التغييرات التي ستجريها على مشروعك.
على الجهاز الطرفي ، انتقل إلى الدليل الجذر لمشروعك وقم بتشغيل الأمر التالي لتهيئة مستودع Git فارغ.
بوابة الحرف الأول
إنشاء .gitignore ملف وأضف أي ملفات لا تريد أن يتتبعها Git. ثم قم بتشغيل الأمر التالي لتتبع الملفات المتبقية:
بوابة add -A
بعد ذلك ، قم بتشغيل الأمر التالي لأخذ اللقطة الأولى عن طريق إرسال الكود إلى Git.
شخص سخيف ارتكب م مبدئي-ارتكب
يمكنك أن تختار استضف مستودع Git الخاص بك على GitHub أو خدمة مماثلة مثل Gitlab لتعاون سلس.
الخطوة 4: تهيئة npm في مشروعك
بعد ذلك ، قم بتهيئة npm في مشروعك لإضافة تفاصيل حول مشروعك إلى ملف package.json. ستكون هذه التفاصيل عامة في npm.
على الجهاز الطرفي ، انتقل إلى الدليل الجذر لمشروعك وقم بتشغيل الأمر التالي لتهيئة npm في مشروعك.
الحرف الأول npm
سيؤدي الأمر أعلاه إلى تشغيل مجموعة من المطالبات في سطر الأوامر:
- اسم الحزمة: هذا هو اسم حزمة npm الخاصة بك ؛ يجب أن يكون فريدًا إذا كنت تريد نشر الحزمة على npm ؛ وإلا ، فإن npm سيؤدي إلى حدوث خطأ.
- إصدار: تشير هذه الخاصية إلى الإصدار الحالي من الحزمة الخاصة بك. يجب عليك زيادتها في كل مرة تقوم فيها بتحديث الحزمة الخاصة بك وإلا ستؤدي npm إلى حدوث خطأ. القيمة الافتراضية هي 1.0.0.
- وصف: هذه الخاصية هي وصف الحزمة الخاصة بك. ستكون علنية عند نشر الحزمة الخاصة بك.
- نقطة الدخول: تشير هذه الخاصية إلى اسم الملف الذي يبدأ فيه تنفيذ التعليمات البرمجية.
- أمر الاختبار: تشير هذه الخاصية إلى الأمر الذي سيتم تشغيله عند التنفيذ تشغيل اختبار npm.
- مستودع بوابة: هذه الخاصية هي عنوان URL لمستودع Git البعيد.
- الكلمات الدالة: تشير هذه الخاصية إلى الكلمات الرئيسية ذات الصلة بمشروعك والتي ستساعد محرك البحث في العثور عليها.
- مؤلف: يجب أن تكون هذه الخاصية اسمك أو اسمك المستعار.
- رخصة: هذا هو الترخيص الذي تريد نشر الحزمة بموجبه. الترخيص الافتراضي هو ترخيص Internet Systems Consortium (ISC).
بعد إعداد هذا ، يمكنك إنشاء الحزمة الخاصة بك.
الخطوة 5: اختبار الحزمة الخاصة بك
بعد الانتهاء من إنشاء الحزمة الخاصة بك ، يجب عليك اختبارها محليًا لمعرفة كيفية عملها بعد نشرها على npm.
لاختبار الحزمة محليًا ، قم أولاً بتشغيل الأمر التالي في دليل مشروعك:
رابط npm
يسمح لك الأمر أعلاه بالإشارة إلى الحزمة الخاصة بك محليًا كما تفعل مع الحزمة المستضافة npm.
بعد ذلك ، أنشئ مجلدًا آخر في الدليل الجذر لمشروعك وأقرصه.
مكدير اختبار
قرص مضغوطاختبار
في مجلد الاختبار ، قم بتشغيل الأمر التالي لربط الحزمة الخاصة بك بالمجلد:
اسم ارتباط npm الخاص بكحزمة
أخيرًا ، أنشئ ملفًا وهميًا لاختبار وظائف الحزمة الخاصة بك.
بعد الانتهاء من الاختبارات الخاصة بك ، يمكنك حذف مجلد الاختبار الخاص بك بأمان.
الخطوة 6: تسجيل الدخول إلى npm على نظامك
بعد ذلك ، يجب عليك تسجيل الدخول إلى حساب npm الخاص بك على نظامك.
قم بتشغيل الأمر التالي لتسجيل الدخول إلى حساب npm الخاص بك:
تسجيل الدخول npm
سيطالبك هذا بملء اسم المستخدم وكلمة المرور ورمز المصادقة الثنائي (إذا قمت بتمكينه في حسابك).
الخطوة 7: نشر الحزمة الخاصة بك
بعد الانتهاء من جميع الخطوات المذكورة أعلاه ، قم بتشغيل الأمر التالي لنشر الحزمة الخاصة بك على npm.
نشر npm
يتطلب هذا الأمر كلمة مرور لمرة واحدة ستكون لبريدك الإلكتروني. بعد ذلك ، سيتم نشر الحزمة الخاصة بك على npm.
يمكنك عرض الحزم التي نشرتها على npm. قم بتسجيل الدخول إلى حساب npm الخاص بك على npmjs.com وانتقل إلى قسم الحزم في لوحة معلومات ملفك الشخصي.
لتثبيت الحزمة الخاصة بك واستخدامها كاعتماد على أي من مشاريعك ، قم بتشغيل:
npm تثبيتاسم-من-لك-حزمة
حذف الحزمة الخاصة بك من npm
لا يزال لديك سيطرة كاملة على الحزم الخاصة بك على npm ، مما يعني أنه يمكنك تعديل الحزمة الخاصة بك وحذفها نهائيًا من npm. يمكنك حذف الحزم الخاصة بك بالانتقال إلى قسم الإعدادات في الحزمة الخاصة بك وتحديد خيار حذف الحزمة.