Kuinka käsitellä Node-Gyp-uudelleenrakennuksen epäonnistumista Macissa (03.28.24)

node-gyp on hieno työkalu, jonka avulla kehittäjät voivat koota natiivien Node-lisäosamoduulien useille alustoille. Se on erittäin suosittu ja nykyään laajalti käytetty, joten se sisältyy usein useimpien NPM-pakettien riippuvuuteen.

Useimmissa käyttöjärjestelmissä node-gyp ei aiheuta ongelmia. Node-gyp: n ja muiden NPM-pakettien asentaminen toimii yleensä sujuvasti ja tehokkaasti. Tämä ei kuitenkaan koske kaikkia käyttäjiä. Jotkut kehittäjät ilmoittivat olevansa vaikeita solmu-gyp: n uudelleenrakentamisessa macOS: ssä, mikä johti vähemmän tähtien kokemukseen asianomaisille kehittäjille. Tämä virhe johtaa myös lukuisiin sudenkuoppiin ja antaa monien tapojen mennä pieleen.

Tämä ongelma ei ole uusi asia. Kehittäjät, jotka käyttävät vanhempia macOS-versioita, ovat kohdanneet tämän virheen aiemmin. MacOS Catalina -julkaisun myötä useat kehittäjät ilmoittivat myös, että solmu-gyp-uudelleenrakennus epäonnistui Macissa päivityksen jälkeen uuteen macOS-versioon. Tämä virhe on estänyt kehittäjiä asentamasta tarvitsemiaan node-gyp-paketteja.

Jos olet havainnut tämän virheen, ymmärrät kuinka turhauttavaa voi olla node-gyp-uudelleenrakennuksen epäonnistuminen Macissa. Et voi edetä sovelluksesi tai ohjelmistokehityksesi kanssa, ellet korjaa tätä virhettä. Onneksi olemme tehneet kaiken työn puolestasi. Jos projektisi eteneminen on mahdotonta tämän virheen takia, voit kokeilla mitä tahansa alla luetelluista ratkaisuista sen ratkaisemiseksi.

Mikä on Node-Gyp?

node-gyp on työkalu, jota käytetään kääntämään Node.js-lisäosat, jotka ovat alkuperäisiä Node.js-moduuleja, jotka on kirjoitettu C- tai C ++ -muodolla. Nämä moduulit on koottava koneellesi työkalulla, kuten node-gyp. Node-gyp toimii Windowsissa, macOS: ssa ja Linuxissa.

Node-gyp on yleensä helppokäyttöinen yhtenäisen käyttöliittymänsä vuoksi. Voit käyttää samoja komentoja myös moduulin rakentamiseen tai uudelleenrakentamiseen eri alustoilla. Node-gyp tukee myös useita Node-kohdeversioita.

Jos saat npm gyp -virheen Mojavessa tai aiemmissa macOS-versioissa, sinun on tarkistettava uudelleen, että node-gyp toimii.

Tässä on asennettavia vaatimuksia, jotta node-gyp toimisi MacOS-käyttöjärjestelmässä:

  • Python v2.7, v3.5, v3.6 tai v3. 7
  • Xcode - apuohjelma, jonka avulla kehittäjät voivat luoda sovelluksia macOS-, iOS- ja iPadOS-käyttöjärjestelmissä.

Sinun on asennettava myös oikea Xcode-komentorivin versio Työkalut, jotka ovat osa XCoden ohjelmistokehitystyökalujen ja kirjastojen sarjaa.

Asenna Xcode-komentorivityökalut noudattamalla seuraavia ohjeita:

  • Käynnistä Xcode Macissa.
  • Valitse Asetukset Xcode-valikosta.
  • Napsauta Yleiset -paneelissa Lataukset
  • Kun Lataukset-ikkuna avautuu, napsauta Komponentit -välilehteä .
  • Napsauta Asenna -painiketta Komentorivityökalut vieressä.
  • Suorita asennus loppuun kirjautumalla sisään Apple Developer -tililläsi.
  • Jos käytössäsi on macOS Catalina, voit ladata Catalina-versiollesi sopivan version Xcode-komentorivityökaluista täältä. MacOS 10.15.3 -käyttöjärjestelmässä tiedostonimen on oltava Command_Line_Tools_for_Xcode_11.3.1.dmg. Kun olet asentanut oikeat komponentit, sinun pitäisi pystyä rakentamaan onnistuneesti node-gyp-sovelluksella. Jos saat node-gyp-palautuksen epäonnistuneen Macissa, sinun on tarkistettava nämä komponentit selvittääksesi, mikä meni pieleen.

    Kuinka ratkaista Node-gyp Rebuild -virhe

    Solmumoduulin asentaminen on helppoa. Sinun tarvitsee vain suorittaa tiettyjä komentoja, ja sinun pitäisi olla hyvä mennä. Jos kohtaat node-gyp-palautus epäonnistuu Macissa, sinun on palattava taaksepäin selvittääksesi, mitä tapahtui.

    Mutta ennen kuin teet, tässä on joitain vianmääritysvaiheita, joita sinun kannattaa kokeilla:

  • Käynnistä tietokone uudelleen päästäksesi eroon kaikista väliaikaisista virheistä, jotka saattavat vaikuttaa järjestelmään.
  • Sulje kaikki tarpeettomat sovellukset vapauttaaksesi tietokoneesi uudelleenkäynnistykset.
  • Poista tietoturvaohjelmisto, kuten virustorjunta- tai haittaohjelmien torjuntaohjelmat, väliaikaisesti käytöstä.
  • Siivoa järjestelmäsi Mac-korjaussovelluksella . saamme edelleen solmun ja gyp: n uudelleenrakennusvirheen, katso alla olevat ratkaisut ja katso, mikä niistä toimii sinulle.

    Korjaus # 1: Tarkista vaaditut komponentit.

    Ensimmäinen asia, jonka tarvitset Jos Mojave tai muu macOS-versio saa npm gyp -virheen, tarkista node-gyp: n asennusvaatimukset uudelleen. Kuten yllä olevassa osiossa mainittiin, tarvitset kolme komponenttia, jotta se toimisi:

    • Python
    • Xcode
    • Xcode-komentorivityökalut

    Älä unohda asentaa C- ja C ++ -kieliä, joita tarvitaan moduulien kokoamiseen. Jos jokin näistä puuttuu tai ei toimi, saat varmasti virheellisen virheen. Puuttuvan tai viallisen komponentin uudelleenasentamisen pitäisi auttaa korjaamaan ongelma.

    Korjaus # 2: Päivitä Node-Gyp-komponentit.

    Joskus näiden komponenttien asentaminen ei riitä. Varmista, että käytät oikeaa versiota MacOS: lle. Voit valita Python v2.7, v3.5, v3.6 tai v3.7, riippuen siitä, mikä versio toimii sinulle. Voit ladata Xcode-koodin tästä linkistä. Sinun on myös asennettava uusin node-gyp-versio joka tapauksessa.

    Korjaus # 3: Suorita happotesti.

    Voit tarkistaa, onko tietokoneesi Xcode-komentorivityökalut asennettu oikein ja toimivatko ne. node-gyp: n avulla voit suorittaa happotestin seuraavasti:

  • Suorita Xcodessa tämä komento:
    / usr / sbin / pkgutil –packages | grep CL
  • Jos näet luettelossa com.apple.pkg.CLTools_Executables , sinulla ei ole ongelmaa. Jos se ei ole, tämä testi on epäonnistunut ja sinun on asennettava se uudelleen.
  • Suorita seuraava komento:
    / usr / sbin / pkgutil –pkg-info com.apple.pkg. CLTools_Executables
  • Sinun pitäisi nähdä luettelossa versio: 11.0.0 (tai uudempi). Jos se ei ole, niin tämä testi epäonnistui ja sinun on asennettava uudelleen.
  • Korjaus # 4: Vaihda toiseen Python-versioon.

    Monet asianomaiset kehittäjät huomauttivat, että aktiivinen ympäristö auttoi korjaamaan ongelman heille. Tällä on jotain tekemistä macOS-version, Solmun version ja käyttämäsi Python-version yhteensopivuuden kanssa. Jotkut käyttäjät havaitsivat, että Pythonin vanhemmat versiot, kuten v2.7, ovat vakaampia kuin uudemmat. Kokeile erilaisia ​​versioita ja katso, mikä niistä sopii sinulle.

    Yhteenveto

    Solmun ja gyp: n uudelleenrakentamisen epäonnistuminen Macissa voi olla hässäkkää ja vikaa selvittäminen voi olla valtava ajanhukka. Joten jos kohtaat tämän virheen, katso yllä olevaa opasta, jotta tiedät tarkalleen, mitä pitäisi tehdä virheen korjaamiseksi.


    YouTube-video: Kuinka käsitellä Node-Gyp-uudelleenrakennuksen epäonnistumista Macissa

    03, 2024