Як обробляти помилку відновлення Node-Gyp на Mac (04.27.24)

node-gyp - це чудовий інструмент, який дозволяє розробникам компілювати вбудовані додаткові модулі Node на декількох платформах. Він дуже популярний і широко використовується сьогодні, тому його часто включають як залежність для більшості пакетів NPM.

У більшості операційних систем node-gyp не викликає жодних проблем. Встановлення node-gyp та решти пакетів NPM зазвичай працюють безперебійно та ефективно. Однак це стосується не всіх користувачів. Деякі розробники повідомляли, що мають проблеми з перебудовою node-gyp на macOS, що призводить до менш ніж зоряного досвіду для постраждалих розробників. Ця помилка також призводить до безлічі підводних каменів і дозволяє багатьом способам піти не так.

Ця проблема не є чимось новим. Розробники, які використовують старіші версії macOS, раніше стикалися з цією помилкою. З виходом macOS Catalina кілька розробників також повідомили, що після оновлення до нової версії macOS на Mac не вдається відновити node-gyp. Ця помилка завадила розробникам встановлювати необхідні їм пакети node-gyp.

Якщо ви зіткнулися з цією помилкою, ви зрозумієте, наскільки неприємним може бути відновлення node-gyp на Mac. Ви не можете продовжувати розробку свого додатка чи програмного забезпечення, якщо не усунете цю помилку. На щастя, ми зробили всю роботу за вас. Якщо вам здається, що через цю помилку неможливо продовжити роботу зі своїм проектом, ви можете вирішити будь-яке з перелічених нижче рішень, щоб її вирішити.

Що таке Node-Gyp?

node-gyp - це інструмент, який використовується для компіляції аддонів Node.js, які є рідними модулями Node.js, написаними на C або C ++. Ці модулі потрібно скомпілювати на вашому комп'ютері за допомогою такого інструменту, як node-gyp. Node-gyp працює у Windows, macOS та Linux.

Node-gyp, як правило, простий у використанні завдяки своєму стабільному інтерфейсу. Ви також можете використовувати одні й ті самі команди для побудови або відновлення вашого модуля на різних платформах. Node-gyp також підтримує кілька цільових версій Node.

Якщо ви отримуєте помилку npm gyp у Mojave або попередніх версіях macOS, вам потрібно ще раз перевірити вимоги до роботи node-gyp.

Ось вимоги, які потрібно встановити, щоб node-gyp працював на macOS:

  • Python v2.7, v3.5, v3.6 або v3. 7
  • Xcode - утиліта, яка дозволяє розробникам створювати додатки на macOS, iOS та iPadOS.

Також потрібно встановити правильну версію командного рядка Xcode Інструменти, які є частиною набору засобів розробки програмного забезпечення та бібліотек XCode.

Щоб встановити інструменти командного рядка Xcode, дотримуйтесь інструкцій нижче:

  • Запустіть Xcode на своєму Mac.
  • Виберіть Налаштування із меню Xcode.
  • На панелі Загальне натисніть Завантажити.
  • Коли відкриється вікно Завантаження, натисніть вкладку Компоненти .//li>
  • Натисніть кнопку Встановити поруч із Інструменти командного рядка.
  • Увійдіть, використовуючи свій обліковий запис розробника Apple, щоб завершити процес встановлення.

    • Якщо ви використовуєте macOS Catalina, ви можете завантажити відповідну версію інструментів командного рядка для 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: Перевірте обов’язкові компоненти.

    Перше, що вам потрібно коли ви отримуєте помилку npm gyp у 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 може бути клопотом, і з’ясування того, що пішло не так, може бути величезною втратою часу. Тож якщо ви зіткнулися з цією помилкою, зверніться до керівництва вище, щоб точно знати, що робити, щоб виправити помилку.

    Відео YouTube: Як обробляти помилку відновлення Node-Gyp на Mac

    04, 2024