Kuidas käituda Node-Gyp'i ebaõnnestumise korral Macis (04.23.24)

node-gyp on vahva tööriist, mis võimaldab arendajatel mitmel platvormil kompileerida natiivseid Node lisandmooduleid. See on tänapäeval väga populaarne ja laialt kasutatav, seetõttu lisatakse see enamiku NPM-i pakettide sõltuvusse.

Enamikes operatsioonisüsteemides ei tekita node-gyp mingit probleemi. Node-gyp ja ülejäänud NPM-i pakettide installimine töötab tavaliselt sujuvalt ja tõhusalt. Kuid see ei kehti kõigi kasutajate puhul. Mõned arendajad teatasid, et neil on probleeme MacOS-i node-gyp taastamisega, mille tulemuseks on mõjutatud arendajatele vähem kui tähe kogemus. See viga toob kaasa ka palju lõkse ja võimaldab paljudel viisidel valesti minna.

See probleem pole midagi uut. Arendajad, kes kasutavad macOS-i vanemaid versioone, on seda viga varem kohanud. MacOS Catalina väljaandmisega teatasid ka mitmed arendajad, et pärast uuele macOS-i versioonile üleminekut ebaõnnestus Macis sõlme-gyp taastamine. See viga on takistanud arendajatel vajalikke node-gyp-pakette installimast.

Kui olete selle veaga kokku puutunud, saate aru, kui pettumuslik võib olla Macis nurjunud node-gyp-i ülesehitamine. Rakenduse või tarkvaraarendusega saate edasi liikuda, kui see viga pole lahendatud. Õnneks oleme kõik tööd teie eest ära teinud. Kui teil on selle vea tõttu võimatu oma projektiga edasi liikuda, võite selle lahendamiseks proovida mõnda allpool loetletud lahendust.

Mis on Node-Gyp?

node-gyp on tööriist, mida kasutatakse Node.js-i lisandmoodulite kompileerimiseks, mis on algupärased Node.js-moodulid, mis on kirjutatud C- või C ++ -ga. Need moodulid tuleb teie masinas kompileerida sellise tööriista abil nagu node-gyp. Node-gyp töötab Windowsis, MacOS-is ja Linuxis.

Node-gyp-i on selle järjekindla liidese tõttu üldiselt lihtne kasutada. Samade käskude abil saate moodulit erinevatele platvormidele üles ehitada või uuesti üles ehitada. Node-gyp toetab ka mitut Node'i sihtversiooni.

Kui näete noja gyp-tõrke Mojave'is või MacOS-i varasemates versioonides, peate uuesti kontrollima node-gyp-i töötamise nõudeid.

Siin on nõuded, mis peate installima, et node-gyp töötaks MacOS-is:

  • Python v2.7, v3.5, v3.6 või v3. 7
  • Xcode - utiliit, mis võimaldab arendajatel luua rakendusi macOS-is, iOS-is ja iPadOS-is.

Samuti peate installima Xcode käsurea õige versiooni Tööriistad, mis on osa XCode tarkvaraarendustööriistade ja teekide komplektist.

Xcode'i käsurea tööriistade installimiseks järgige allolevaid juhiseid:

  • käivitage oma Macis Xcode .
  • Valige Eelistused menüüst Xcode.
  • Klõpsake paneeli Üldine all valikul Laadi alla .
  • Kui avaneb aken Allalaadimised, klõpsake vahekaarti Komponendid .
  • Klõpsake nuppu Install käsurea tööriistade kõrval.
  • Installiprotsessi lõpuleviimiseks logige sisse oma Apple'i arendajakontoga.

    • Kui kasutate macOS Catalina, saate siit alla laadida oma Catalina versiooni Xcode'i käsurea tööriistade sobiva versiooni. MacOS 10.15.3 puhul peaks failinimi olema Command_Line_Tools_for_Xcode_11.3.1.dmg. Kui olete õiged komponendid installinud, peaksite saama node-gyp-i abil edukalt ehitada. Kui teil on Macis ebaõnnestunud node-gyp-i ümberehitamine, peate need komponendid üle vaatama, et teada saada, mis valesti läks.

    Kuidas lahendada Node-gyp-i ümberehitamise viga

    Sõlmemooduli installimine on lihtne protsess. Peate lihtsalt käivitama konkreetsed käsud ja teil peaks olema hea minna. Kui leiate Macis sõlmede-gyp-i abil ülesehitamise ebaõnnestumisi, peate toimunu selgitamiseks tagasi astuma.

    Kuid enne toimingut peate proovima järgmisi põhilisi tõrkeotsingu samme: > Taaskäivitage arvuti, et vabaneda kõigist ajutistest vigadest, mis võivad teie süsteemi mõjutada.

  • Sulgege kõik mittevajalikud rakendused, et vabastada arvuti reimgid.
  • Keelake ajutiselt oma turvatarkvara, näiteks viirusetõrje või pahavaratõrjeprogrammid.
  • Puhastage süsteem, kasutades Maci remondirakendust .

    • Kui ikka tekib node-gyp-i ümberehitamise viga, vaadake allolevaid lahendusi ja vaadake, milline neist teie jaoks sobib.

    Parandus nr 1: kontrollige vajalikke komponente uuesti.

    Esimene asi, mida peate Kui Mojave või mõne muu macOS-i versiooni puhul ilmneb npm gyp-tõrge, kontrollige uuesti node-gyp-i installinõudeid. Nagu ülaltoodud jaotises mainitud, vajate selle toimimiseks kolme komponenti:

    • Python
    • Xcode
    • Xcode käsurea tööriistad

    Ärge unustage installida C ja C ++ keeli, mida on vaja moodulite kompileerimiseks. Kui mõni neist puudub või ei tööta, saate kindlasti vea taastamise vea. Puuduva või vigase komponendi uuesti installimine peaks probleemi lahendama.

    Parandus # 2: värskendage oma Node-Gyp komponente.

    Mõnikord ei piisa nende komponentide installimisest. Peate veenduma, et kasutate oma macOS-i jaoks õiget versiooni. Võite valida Pythoni v2.7, v3.5, v3.6 või v3.7 vahel, sõltuvalt sellest, milline versioon teile sobib. Xcoodi jaoks saate selle sellelt lingilt alla laadida. Samuti peate igaks juhuks installima uusima versiooni node-gyp.

    Parandus # 3: tehke happekatse.

    Saate kontrollida, kas teie arvuti Xcode'i käsurea tööriistad on õigesti installitud ja töötab node-gyp abil saate happekatse käivitada järgmiselt:

  • Xcode'is käivitage see käsk:
    / usr / sbin / pkgutil –packages | grep CL
  • Kui näete loendis com.apple.pkg.CLTools_Executables loendit, pole teil probleeme. Kui see pole nii, siis see test nurjus ja peate selle uuesti installima.
  • Käivitage järgmine käsk:
    / usr / sbin / pkgutil –pkg-info com.apple.pkg. CLTools_Executables
  • Loendis peaksite nägema versioon: 11.0.0 (või uuemat). Kui see pole nii, siis ebaõnnestus ka see test ning peate uuesti installima.
    • Parandage probleem nr 4: lülituge teisele Pythoni versioonile.

    Paljud mõjutatud arendajad märkisid, et aktiivne keskkond aitas nende jaoks probleemi lahendada. See on midagi pistmist MacOS-versiooni, sõlme versiooni ja kasutatava Pythoni versiooni ühilduvusega. Mõned kasutajad leidsid, et Pythoni vanemad versioonid, näiteks v2.7, on uuematest stabiilsemad. Katsetage erinevate versioonidega ja vaadake, milline neist teie jaoks sobib.

    Kokkuvõte

    Node-gyp-i ümberehitamise ebaõnnestumine Macis võib olla vaev ja valesti välja selgitamine võib olla tohutu ajaraisk. Nii et kui teil on seda viga, lugege ülaltoodud juhendit, et teaksite täpselt, mida vea parandamiseks teha.

    Youtube video: Kuidas käituda Node-Gyp'i ebaõnnestumise korral Macis

    04, 2024