כיצד לטפל בבניית מחדש של צומת כשלים ב- Mac (04.20.24)

node-gyp הוא כלי נוח המאפשר למפתחים לקמפל מודולי תוספות של Node במספר פלטפורמות. זה מאוד פופולרי ונמצא בשימוש נרחב כיום, ולכן הוא נכלל לעיתים קרובות כתלות ברוב חבילות ה- NPM.

ברוב מערכות ההפעלה, node-gyp אינו גורם לשום בעיה. התקנת node-gyp ושאר חבילות ה- NPM פועלות בדרך כלל בצורה חלקה ויעילה. עם זאת, זה לא המקרה עבור כל המשתמשים. כמה מפתחים דיווחו כי הם מתקשים לבנות מחדש את ה- node-gyp ב- macOS, וכתוצאה מכך המפתחים המושפעים חווים פחות ממכוכבים. שגיאה זו מובילה גם להרבה מלכודות ומאפשרת דרכים רבות לדברים להשתבש.

בעיה זו אינה משהו חדש. מפתחים המשתמשים בגרסאות ישנות יותר של ה- macOS נתקלו בשגיאה זו בעבר. עם שחרורו של macOS Catalina, מספר מפתחים דיווחו גם על כישלון בנייה מחדש של צומת gyp ב- Mac לאחר שדרוג לגרסת ה- MacOS החדשה. שגיאה זו מנעה ממפתחים להתקין את חבילות ה- gyp-node שהם זקוקים לה.

אם נתקלת בשגיאה זו, תבין עד כמה מתסכל בניית ה- gyp-gyp יכול להיכשל ב- Mac. אינך יכול להתקדם באפליקציה או בפיתוח התוכנה שלך אלא אם תקנת שגיאה זו. למרבה המזל, עשינו את כל העבודה בשבילך. אם אתה מוצא את זה בלתי אפשרי להתקדם עם הפרויקט שלך בגלל שגיאה זו, אתה יכול לנסות את אחד הפתרונות המפורטים להלן כדי לפתור אותה.

מהו Node-Gyp?

node-gyp הוא כלי המשמש להידור תוספי Node.js, שהם מודולים מקוריים של Node.js שנכתבו ב- C או C ++. יש לקמפל את המודולים הללו במחשב שלך באמצעות כלי כמו צומת gyp. Node-gyp עובד ב- Windows, macOS ו- Linux.

Node-gyp בדרך כלל קל לשימוש בגלל הממשק העקבי שלו. אתה יכול גם להשתמש באותן פקודות כדי לבנות או לבנות מחדש את המודול שלך בפלטפורמות שונות. Node-gyp תומך גם במספר גרסאות יעד של Node.

אם אתה מקבל שגיאת gyp npm ב- Mojave או בגירסאות קודמות של macOS, עליך לבדוק שוב את הדרישות כדי ש- node-gyp יעבוד.

להלן הדרישות שעליך להתקין כדי ש- gyp-node יעבוד ב- macOS:

  • Python v2.7, v3.5, v3.6 או v3. 7
  • Xcode - כלי עזר המאפשר למפתחים ליצור אפליקציות ב- MacOS, iOS ו- iPadOS.

כמו כן, עליך להתקין את הגרסה הנכונה של שורת הפקודה Xcode כלים, שהם חלק מחבילת הכלים והספריות של פיתוח תוכנה של XCode.

להתקנת כלי שורת הפקודה Xcode, פעל לפי ההוראות שלהלן:

  • התחל Xcode ב- Mac שלך.
  • בחר העדפות מתפריט Xcode.
  • תחת החלונית כללי לחץ על הורדות .
  • כאשר חלון ההורדות נפתח, לחץ על רכיבים כרטיסייה.
  • לחץ על התקן ליד כלי שורת הפקודה.
  • היכנס באמצעות חשבון המפתח של Apple שלך ​​כדי להשלים את תהליך ההתקנה.

    • אם אתה מפעיל את MacOS Catalina, תוכל להוריד מכאן את הגרסה המתאימה של כלי שורת הפקודה עבור Xcode עבור גרסתך. עבור macOS 10.15.3, שם הקובץ צריך להיות Command_Line_Tools_for_Xcode_11.3.1.dmg. לאחר התקנת הרכיבים הנכונים, אתה אמור להיות מסוגל לבנות באמצעות node-gyp בהצלחה. אם אתה מקבל בנייה מחדש של צומת-צופים נכשל ב- Mac, עליך לבדוק רכיבים אלה כדי לברר מה השתבש.

    כיצד לפתור את שגיאת הבנייה מחדש של הצומת-gyp

    התקנת מודול צומת היא תהליך קל. אתה רק צריך להפעיל פקודות ספציפיות ואתה אמור להיות טוב ללכת. אם אתה נתקל בבניית מחדש של צומת-gyp נכשל ב- Mac, עליך לסגת לאחור כדי להבין מה קרה.

    אך לפני שתעשה זאת, הנה כמה שלבים בסיסיים לפתרון בעיות שעליך לנסות:

  • הפעל מחדש את המחשב שלך כדי להיפטר מכל באגים זמניים שעשויים להשפיע על המערכת שלך.
  • סגור את כל היישומים המיותרים כדי לפנות את החיובי המחשב שלך מחדש.
  • השבת זמנית את תוכנת האבטחה שלך, כגון תוכניות אנטי-וירוס או תוכנות זדוניות.
  • נקה את המערכת באמצעות אפליקציית תיקון מק .

    • אם אתה אתה עדיין מקבל שגיאת בנייה מחדש של צומת גופים, בדוק את הפתרונות שלמטה וראה איזה מהם עובד בשבילך.

    תיקון מס '1: בדוק שוב את הרכיבים הנדרשים.

    הדבר הראשון שאתה צריך לעשות כאשר אתה מקבל שגיאת gyp npm ב- Mojave או בגרסת MacOS אחרת היא לבדוק פעמיים את דרישות ההתקנה של ה- gyp. כפי שצוין בסעיף לעיל, אתה זקוק לשלושה רכיבים כדי שזה יעבוד, כלומר:

    • Python
    • Xcode
    • Xcode Line Command Tools

    אל תשכח להתקין את השפות C ו- C ++, שיהיה צורך להרכיב את המודולים. אם כל אחד מאלה חסר או לא עובד, בהחלט תקבל את שגיאת הכשל מחדש. התקנה מחדש של הרכיב החסר או הפגום אמורה לסייע בתיקון הבעיה.

    תיקון מס '2: עדכן את רכיבי הצומת שלך.

    לפעמים אין די בהתקנת רכיבים אלה. עליך לוודא שאתה משתמש בגרסה הנכונה עבור ה- MacOS שלך. אתה יכול לבחור בין Python v2.7, v3.5, v3.6 או v3.7, תלוי בגרסה המתאימה לך. עבור ה- Xcode, אתה יכול להוריד אותו מקישור זה. עליך גם להתקין את הגרסה האחרונה של צומת הגיוס לכל מקרה.

    תקן מס '3: בצע בדיקת חומצה.

    תוכל לבדוק אם כלי שורת הפקודה Xcode במחשב שלך מותקנים כהלכה ויעבדו באמצעות node-gyp, תוכל להריץ בדיקת חומצה על ידי ביצוע השלבים הבאים:

  • ב- Xcode, הפעל פקודה זו:
    / usr / sbin / pkgutil –packages | grep CL
  • אם אתה רואה את com.apple.pkg.CLTools_Exablesables רשום, לא תהיה לך בעיה. אם לא, בדיקה זו נכשלה ועליך להתקין אותה מחדש.
  • הפעל את הפקודה הבאה:
    / usr / sbin / pkgutil –pkg-info com.apple.pkg. CLTools_Exablesables
  • אתה אמור לראות את הגרסה גרסה: 11.0.0 (ואילך). אם לא, גם בדיקה זו נכשלה ועליך להתקין מחדש.
    • תקן מס '4: עבור לגרסת פיתון אחרת.

    הרבה מפתחים מושפעים ציינו כי שינוי גרסת ה- Python המשמשת עבור סביבה פעילה סייעה לפתור את הבעיה עבורם. זה קשור לתאימות בין גרסת ה- macOS, גרסת ה- Node וגרסת ה- Python בה אתה משתמש. חלק מהמשתמשים מצאו שגרסאות ישנות יותר של Python, כגון v2.7, יציבות יותר מהגרסאות החדשות יותר. התנסו בגרסאות שונות ובדקו איזו מהן מתאימה עבורכם.

    סיכום

    כישלון בנייה מחדש של צומת gyp נכשל ב- Mac יכול להיות טרחה ולהבין מה השתבש יכול להיות בזבוז זמן עצום. אז אם אתה נתקל בשגיאה זו, עיין במדריך שלמעלה כדי שתדע בדיוק מה לעשות כדי לתקן את השגיאה.

    סרטון יוטיוב: כיצד לטפל בבניית מחדש של צומת כשלים ב- Mac

    04, 2024