Com gestionar els errors de reconstrucció de Node-Gyp a Mac (04.25.24)

node-gyp és una eina intel·ligent que permet als desenvolupadors compilar mòduls complementaris de Node natius en diverses plataformes. Actualment és molt popular i s’utilitza àmpliament, de manera que sovint s’inclou com a dependència per a la majoria de paquets NPM.

En la majoria de sistemes operatius, node-gyp no causa cap problema. La instal·lació de node-gyp i la resta de paquets NPM solen funcionar sense problemes i amb eficàcia. Tot i això, no és el cas de tots els usuaris. Alguns desenvolupadors van informar que tenien problemes per reconstruir el node-gyp a macOS, cosa que va resultar en una experiència menys que estel·lar per als desenvolupadors afectats. Aquest error també condueix a una gran quantitat de trampes i permet moltes coses perquè les coses no funcionin bé.

Aquest problema no és nou. Els desenvolupadors que utilitzen versions anteriors de macOS han tingut aquest error abans. Amb el llançament de macOS Catalina, diversos desenvolupadors també van informar que la reconstrucció de node-gyp falla a Mac després d’actualitzar a la nova versió de macOS. Aquest error ha impedit als desenvolupadors instal·lar els paquets node-gyp que necessiten.

Si heu trobat aquest error, entendreu el frustrant que pot ser la fallida de la reconstrucció del node-gyp a Mac. No podeu avançar amb l'aplicació o el desenvolupament de programari tret que solucioneu aquest error. Afortunadament, hem fet tota la feina per vosaltres. Si és impossible avançar amb el vostre projecte a causa d'aquest error, podeu provar qualsevol de les solucions que s'enumeren a continuació per resoldre'l.

Què és Node-Gyp?

node-gyp és una eina que s’utilitza per compilar complements Node.js, que són mòduls Node.js natius escrits en C o C ++. Aquests mòduls s'han de compilar a la vostra màquina mitjançant una eina com node-gyp. Node-gyp funciona a Windows, macOS i Linux.

Node-gyp és generalment fàcil d'utilitzar a causa de la seva interfície consistent. També podeu utilitzar les mateixes ordres per crear o reconstruir el mòdul en plataformes diferents. Node-gyp també admet diverses versions de destinació de Node.

Si rebeu un error npm gyp a Mojave o versions anteriors de macOS, heu de comprovar els requisits perquè funcioni node-gyp.

Aquests són els requisits que heu d’instal·lar perquè el node-gyp funcioni a macOS:

  • Python v2.7, v3.5, v3.6 o v3. 7
  • Xcode: una utilitat que permet als desenvolupadors crear aplicacions a macOS, iOS i iPadOS.

També heu d’instal·lar la versió correcta de la línia d’ordres de Xcode. Eines, que formen part del conjunt d'eines i biblioteques de desenvolupament de programari de XCode.

Per instal·lar les eines de línia d'ordres de Xcode, seguiu les instruccions següents:

  • Inicieu Xcode al vostre Mac.
  • Seleccioneu Preferències al menú Xcode.
  • Al tauler General , feu clic a Descàrregues/
  • Quan s’obri la finestra de baixades, feu clic a la pestanya Components .
  • Feu clic al botó Instal·la al costat de Eines de línia d’ordres.
  • Inicieu la sessió amb el vostre compte de desenvolupador d'Apple per completar el procés d'instal·lació.

    • Si utilitzeu macOS Catalina, podeu descarregar la versió adequada de les eines de línia d’ordres per a Xcode per a la vostra versió de Catalina des d’aquí. Per a macOS 10.15.3, el nom del fitxer ha de ser Command_Line_Tools_for_Xcode_11.3.1.dmg. Un cop hàgiu instal·lat els components correctes, hauríeu de ser capaços de construir amb node-gyp amb èxit. Si es produeix un error en la reconstrucció de node-gyp a Mac, haureu de revisar aquests components per saber què ha fallat.

    Com resoldre l'error de reconstrucció de Node-gyp

    Instal·lar un mòdul de node és un procés senzill. Només heu d’executar ordres específiques i hauríeu d’anar bé. Si trobeu un error de reconstrucció de node-gyp a Mac, heu de fer un pas enrere per esbrinar què va passar.

    Però abans de fer-ho, aquí teniu alguns passos bàsics de resolució de problemes que heu de provar:

  • Reinicieu l'ordinador per eliminar qualsevol error temporal que pugui afectar el vostre sistema.
  • Tanqueu totes les aplicacions innecessàries per alliberar les notificacions de l'ordinador.
  • Desactiveu temporalment el vostre programari de seguretat, com ara programes antivirus o antimalware.
  • Neteja el sistema mitjançant l’aplicació de reparació de Mac .

    • Encara apareix un error de reconstrucció de node-gyp, mireu les solucions següents i veureu quina us funciona.

    Solució núm. 1: comproveu de nou els components necessaris.

    El primer que heu de fer és fer quan s'obté un error npm gyp a Mojave o una altra versió de macOS és comprovar de nou els requisits d'instal·lació del node-gyp. Com es va esmentar a la secció anterior, necessiteu tres components perquè funcioni, a saber:

    • Python
    • Xcode
    • Eines de línia d’ordres Xcode

    No oblideu instal·lar els llenguatges C i C ++, que seran necessaris per compilar els mòduls. Si falta algun d’aquests o no funciona, definitivament obtindreu l’error de fallada en la reconstrucció. Si torneu a instal·lar el component que falta o és defectuós, hauríeu de solucionar el problema.

    Solució núm. 2: actualitzeu els components Node-Gyp.

    De vegades, no és suficient instal·lar aquests components. Heu d’assegurar-vos que utilitzeu la versió correcta per al vostre macOS. Podeu triar entre Python v2.7, v3.5, v3.6 o v3.7, segons la versió que us funcioni. Per al Xcode, el podeu descarregar des d’aquest enllaç. També heu d’instal·lar la versió més recent de node-gyp per si de cas.

    Solució núm. 3: realitzeu una prova d’àcid.

    Podeu comprovar si les eines de línia d’ordres Xcode del vostre equip estan instal·lades correctament i funcionaran amb node-gyp, podeu executar una prova d’àcid seguint aquests passos:

  • A Xcode, executeu aquesta ordre:
    / usr / sbin / pkgutil –packages | grep CL
  • Si veieu com.apple.pkg.CLTools_Executables a la llista, no tindreu cap problema. Si no és així, la prova ha fallat i heu de tornar-la a instal·lar.
  • Executeu l'ordre següent:
    / usr / sbin / pkgutil –pkg-info com.apple.pkg. CLTools_Executables
  • Hauríeu de veure la versió: 11.0.0 (o posterior) tal com apareix a la llista. Si no és així, la prova també ha fallat i heu de tornar a instal·lar-la.
    • Solució núm. 4: canvieu a una versió diferent de Python.

    Molts desenvolupadors afectats van assenyalar que canviant la versió de Python utilitzada un entorn actiu els va ajudar a solucionar el problema. Això té a veure amb la compatibilitat entre la versió de macOS, la versió de Node i la versió de Python que utilitzeu. Alguns usuaris van trobar que les versions anteriors de Python, com la v2.7, són més estables que les versions més recents. Experimenteu amb diferents versions i vegeu quina us funciona.

    Resum

    Falla la reconstrucció de node-gyp a Mac pot ser una molèstia i esbrinar què ha fallat pot suposar una pèrdua de temps enorme. Per tant, si trobeu aquest error, consulteu la guia anterior per saber exactament què cal fer per solucionar-lo.

    Vídeo de YouTube: Com gestionar els errors de reconstrucció de Node-Gyp a Mac

    04, 2024