كيفية التعامل مع فشل إعادة إنشاء Node-Gyp على نظام Mac (04.19.24)

node-gyp هي أداة أنيقة تتيح للمطورين تجميع وحدات Node الإضافية الأصلية في أنظمة أساسية متعددة. إنه شائع جدًا ويستخدم على نطاق واسع اليوم ، لذلك غالبًا ما يتم تضمينه كاعتماد لمعظم حزم NPM.

في معظم أنظمة التشغيل ، لا يسبب node-gyp أي مشكلة. عادةً ما يعمل تثبيت node-gyp وباقي حزم NPM بسلاسة وكفاءة. ومع ذلك ، هذا ليس هو الحال بالنسبة لجميع المستخدمين. أبلغ بعض المطورين عن وجود مشكلة في إعادة إنشاء node-gyp على macOS ، مما أدى إلى تجربة أقل من ممتازة للمطورين المتأثرين. يؤدي هذا الخطأ أيضًا إلى العديد من المزالق ويسمح بعدة طرق لسوء الأمور.

هذه المشكلة ليست بالشيء الجديد. واجه المطورون الذين يستخدمون إصدارات أقدم من macOS هذا الخطأ من قبل. مع إصدار macOS Catalina ، أبلغ العديد من المطورين أيضًا عن فشل إعادة بناء node-gyp على Mac بعد الترقية إلى إصدار macOS الجديد. منع هذا الخطأ المطورين من تثبيت حزم node-gyp التي يحتاجون إليها.

إذا واجهت هذا الخطأ ، فسوف تفهم مدى الإحباط الذي يمكن أن يسببه فشل إعادة بناء node-gyp على Mac. لا يمكنك المضي قدمًا في تطوير تطبيقاتك أو برامجك ما لم يتم إصلاح هذا الخطأ. لحسن الحظ ، قمنا بكل العمل من أجلك. إذا وجدت أنه من المستحيل المضي قدمًا في مشروعك بسبب هذا الخطأ ، فيمكنك تجربة أي من الحلول المدرجة أدناه لحلها.

ما هو Node-Gyp؟

node-gyp هي أداة تستخدم لتجميع Node.js Addons ، وهي وحدات Node.js أصلية مكتوبة بلغة C أو C ++. يجب تجميع هذه الوحدات على جهازك باستخدام أداة مثل node-gyp. يعمل Node-gyp على أنظمة التشغيل Windows و macOS و Linux.

يسهل استخدام Node-gyp بشكل عام بسبب واجهته المتسقة. يمكنك أيضًا استخدام نفس الأوامر لبناء أو إعادة بناء الوحدة النمطية الخاصة بك على منصات مختلفة. يدعم Node-gyp أيضًا العديد من الإصدارات المستهدفة من Node.

إذا كنت تتلقى خطأ gyp npm على Mojave أو الإصدارات السابقة من macOS ، فأنت بحاجة إلى التحقق جيدًا من متطلبات عمل node-gyp.

فيما يلي المتطلبات التي تحتاج إلى تثبيتها لكي تعمل node-gyp على macOS:

  • Python v2.7 أو v3.5 أو v3.6 أو v3. 7
  • Xcode - أداة تتيح للمطورين إنشاء تطبيقات على macOS و iOS و iPadOS.

تحتاج أيضًا إلى تثبيت الإصدار الصحيح من Xcode Command Line الأدوات ، التي تُعد جزءًا من مجموعة XCode لأدوات تطوير البرامج والمكتبات.

لتثبيت أدوات سطر أوامر Xcode ، اتبع الإرشادات أدناه:

  • ابدأ Xcode على جهاز Mac.
  • حدد التفضيلات من قائمة Xcode.
  • ضمن لوحة عام ، انقر على التنزيلات .
  • عند فتح نافذة التنزيلات ، انقر فوق علامة التبويب المكونات .
  • انقر فوق الزر تثبيت بجوار أدوات سطر الأوامر.
  • تسجيل الدخول باستخدام حساب Apple Developer الخاص بك لإكمال عملية التثبيت.

    • إذا كنت تستخدم macOS Catalina ، فيمكنك تنزيل الإصدار المناسب من Command Line Tools لـ Xcode لإصدار Catalina الخاص بك من هنا. بالنسبة لنظام التشغيل macOS 10.15.3 ، يجب أن يكون اسم الملف Command_Line_Tools_for_Xcode_11.3.1.dmg. بمجرد تثبيت المكونات الصحيحة ، يجب أن تكون قادرًا على البناء باستخدام node-gyp بنجاح. إذا حدث فشل في إعادة بناء node-gyp على نظام التشغيل Mac ، فأنت بحاجة إلى مراجعة هذه المكونات لمعرفة الخطأ الذي حدث.

    كيفية حل خطأ إعادة بناء Node-gyp

    يعد تثبيت وحدة العقدة عملية سهلة. تحتاج فقط إلى تشغيل أوامر محددة ويجب أن تكون على ما يرام. إذا واجهت فشل إعادة إنشاء node-gyp على نظام التشغيل Mac ، فأنت بحاجة إلى التراجع لمعرفة ما حدث.

    ولكن قبل القيام بذلك ، إليك بعض الخطوات الأساسية لتحرّي الخلل وإصلاحه التي يجب أن تجربها:

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

    • إذا كنت ما زلت تتلقى خطأ إعادة بناء node-gyp ، ألق نظرة على الحلول أدناه واطلع على الحلول المناسبة لك.

    الإصلاح رقم 1: تحقق جيدًا من المكونات المطلوبة.

    أول شيء تحتاجه القيام بذلك عندما تحصل على خطأ gyp npm على Mojave أو إصدار macOS آخر هو التحقق مرة أخرى من متطلبات تثبيت node-gyp. كما هو مذكور في القسم أعلاه ، تحتاج إلى ثلاثة مكونات حتى تعمل ، وهي:

    • Python
    • Xcode
    • أدوات سطر أوامر Xcode

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

    الإصلاح رقم 2: تحديث مكونات Node-Gyp.

    أحيانًا لا يكفي تثبيت هذه المكونات. تحتاج إلى التأكد من أنك تستخدم الإصدار الصحيح لنظام macOS الخاص بك. يمكنك الاختيار بين Python v2.7 أو v3.5 أو v3.6 أو v3.7 ، اعتمادًا على الإصدار المناسب لك. بالنسبة إلى Xcode ، يمكنك تنزيله من هذا الرابط. تحتاج أيضًا إلى تثبيت أحدث إصدار من node-gyp فقط في حالة.

    الإصلاح رقم 3: إجراء اختبار الحمض.

    يمكنك التحقق مما إذا كانت أدوات سطر أوامر Xcode على جهاز الكمبيوتر الخاص بك مثبتة بشكل صحيح وستعمل باستخدام node-gyp ، يمكنك إجراء اختبار الحمض باتباع الخطوات التالية:

  • في Xcode ، قم بتشغيل هذا الأمر:
    / usr / sbin / pkgutil –packages | grep CL
  • إذا رأيت com.apple.pkg.CLTools_Executables كما هو مدرج ، فلن تواجهك مشكلة. إذا لم يكن كذلك ، فقد فشل هذا الاختبار وتحتاج إلى إعادة تثبيته.
  • قم بتشغيل الأمر التالي:
    / usr / sbin / pkgutil –pkg-info com.apple.pkg. CLTools_Executables
  • ستشاهد الإصدار: 11.0.0 (أو أحدث) كما هو مدرج. إذا لم يكن كذلك ، فإن هذا الاختبار فشل أيضًا وتحتاج إلى إعادة التثبيت.
    • الإصلاح رقم 4: التبديل إلى إصدار Python مختلف.

    لاحظ الكثير من المطورين المتأثرين أن تغيير إصدار Python المستخدم ساعدت البيئة النشطة في حل المشكلة بالنسبة لهم. هذا له علاقة بالتوافق بين إصدار macOS وإصدار Node وإصدار Python الذي تستخدمه. وجد بعض المستخدمين أن الإصدارات القديمة من Python ، مثل v2.7 ، أكثر استقرارًا من الإصدارات الأحدث. جرب إصدارات مختلفة واعرف أيها يناسبك.

    الملخص

    قد يكون الحصول على فشل إعادة بناء node-gyp على Mac أمرًا صعبًا وقد يكون اكتشاف الخطأ الذي حدث مضيعة للوقت. لذلك إذا واجهت هذا الخطأ ، فارجع إلى الدليل أعلاه حتى تعرف بالضبط ما يجب فعله لإصلاح الخطأ.

    فيديو يوتيوب: كيفية التعامل مع فشل إعادة إنشاء Node-Gyp على نظام Mac

    04, 2024