NPM: tvarkykite „JavaScript“ paketus

Įvadas NPM

Kas yra NPM?NPM („Node Package Manager“) yra „JavaScript“ paketų tvarkyklė, ji yra numatytoji „node.js“. Įdiegus mazgą, taip pat įdiegtas NPM. O ką tai reiškia? Na, per NPM galime įdiegti ir valdyti savo programų paketus.

Kai naudojame „Node.js“, turime greitai įdiegti naujus modulius (bibliotekas), nes „Node“, būdama labai modulinė sistema, praktiškai tuščia. Taigi daugumai operacijų turėsime įdiegti papildomus modulius. Ši operacija atliekama labai lengvai naudojant NPM įrankį.

Kaip įdiegti „Node.js“?Norėdami įdiegti „Node.js“, pirmiausia turime įeiti į oficialią svetainę:

https://nodejs.org/

Ir atsisiųskite diegimo programą pagal mūsų operacinę sistemą.

DIDELIS

Atsisiųsdami diegimo failą tiesiog dukart spustelėkite jį ir vykdome „Node.js“ diegimo vedlio instrukcijas.

Įdiegus „Windows“ vartotojams, „node.js“ konsolė bus pasiekiama iš paleidimo juostos, kaip parodyta šiame paveikslėlyje:

DIDELIS

„Mac“ vartotojai turės atidaryti savo operacinės sistemos terminalą, kaip parodyta šiame paveikslėlyje:

DIDELIS

Norėdami patikrinti, ar jis tinkamai įdiegtas, savo terminale vykdome šią komandą:

 neduok

(„Windows“ / „Linux“ / „Terminal OS X Console“)

Mes stumiame Įveskite ir mes įvedame šią eilutę:

 Console.log ('Node.js sėkmingai įdiegtas');

(„Windows“ / „Linux“ / „Terminal OS X Console“)

Paspaudus Įveskite, tai parodys mums pranešimą „Node.js sėkmingai įdiegtas“. Norėdami pamatyti „node.js“ leidžiamų komandų sąrašą, įvedame komandą .padėti kaip parodyta šioje nuotraukoje:

Norėdami peržiūrėti Įdiegta NPM versija, vykdome šią komandą:

 npm -v

Dėl to atsiras:

Paketų valdytojas
The NPM paketų tvarkyklė, šiek tiek skiriasi nuo kitų paketų tvarkytojų, kuriuos galbūt žinome, nes jis juos įdiegia vietoje projektuose. Tai yra, kai modulis atsisiunčiamas, jis pridedamas prie vietinio projekto, į kurį jį bus galima įtraukti. Nors taip pat yra galimybė įdiegti paketus visame pasaulyje mūsų sistemoje.

Pradedant naują projektą

Kai pradedame naują projektą naudodami node.js, būtina sukurti failą, pavadintą package.json. Tai yra tam tikras manifestas, kuriame savo ruožtu yra visų priklausomybių, kurias naudos jūsų projektas, sąrašas.

Naudojimas package.json

Geriausias būdas valdyti vietoje įdiegtus paketus yra sukurti paketą package.json, tai leidžia mums:

• Dokumentuokite, kokius paketus naudoja mūsų projektas.
• Nurodykite, kokią konkrečią paketo versiją naudos mūsų projektas.
• Tai leidžia mums lengvai pasidalyti savo priklausomybėmis su kitais kūrėjais.

Reikalavimai:

„Package.json“ faile turi būti bent:

1. Pavadinimas:

• Viskas mažosiomis raidėmis.
• Vienas žodis be vietos.
• Leidžiamas brūkšnys ir pabraukimas.

2. Versija:

Package.json pavyzdys:

 {"Pavadinimas": "project_package", "Version": "1.0.0"}

Jei norite sukurti naują package.json, yra 2 būdai tai padaryti:

1. Įkelkite numatytąjį paketą.json: Iš konsolės vykdome šią komandinę eilutę.

 npm init -taip

Dėl to atsiras:

Norėdami pakeisti šią konfigūraciją, tiesiog atidarome failą, sukurtą naudojant teksto redaktorių, ir pakeičiame norimus atributus.

2. Sukurkite package.json naudodami vedlį: Konsolėje vykdome šią komandą.

 npm init

Vedlys paklaus, ką norite pridėti prie kiekvieno atributo, todėl bus pateikta:

Priklausomybių diegimas

Svetainėje https://www.npmjs.com/ galite rasti šimtus projektų; kurios yra išdėstytos pagal skirtingus kriterijus (atsisiuntimų skaičius, populiarumas …). Interneto puslapyje tai yra greičiausias būdas, tačiau NPM taip pat turi paieškos parametrą, skirtą ieškoti paketų. Norėdami tai padaryti, turite paleisti šią komandinę eilutę:

Vietinis montavimas
Kai failas yra apibrėžtas package.json, galite pridėti joje priklausomybes ir pridėti viską, ko jums reikia:

 "priklausomybės": {"express": "*", "grunt": "*", "bower": "*"}

Kuris turėtų būti toks:

Įdiekite paketus, išvardytus package.jsonNorėdami įdiegti paketus package.json ir jų priklausomybes, turite būti kataloge, kuriame yra minėtas failas, ir vykdyti šią komandinę eilutę:

 npm įdiegti

Įdiekite paketusTu taip pat gali įdiekite naujus paketus ir išsaugokite juos iš terminalo, atlikdami šiuos veiksmus:

 npm įdiegti -išsaugoti naują paketo pavadinimą

Pašalinkite paketusPašalinti paketą ir ištrinkite jį iš package.json:

 npm pašalinti -išsaugoti paketo_pavadinimą

Įdiekite paketą tiesiai iš „Git“ saugyklos

 npm įdiegti git: //github.com/blured/mipaquete.git

Įdiekite konkrečią paketo versiją

 npm įdiegti [email protected]

Svarbu pažymėti, kad šis vietinis diegimo metodas reiškia, kad jūsų failai bus saugomi ir pasiekiami tik jūsų projekto kataloge.

Visuotinis diegimas
Kitas būdas įdiegti paketus yra tai padaryti visame pasaulyje. Tai dažniausiai naudojama paketams, kurie teikia funkcijas iš komandinės eilutės, pvz., „Grunt“, „Bower“, „Yeoman“ ir kt.

Paimkite, pavyzdžiui, JSHint paketas, kuris yra „JavaScript“ kodo analizatorius, leidžiantis parodyti taškus, kuriuose jūsų kodas neatitinka tam tikrų nustatytų „švaraus kodo“ taisyklių. Norėdami jį įdiegti visame pasaulyje, vykdome įdiegti komandą pridedant -g atributas ir su šaknies privilegija („Mac“ ir „Linux“ vartotojams).

 sudo npm įdiegti -g jshint

 npm įdiegti -g jshint

Norėdami patvirtinti diegimą, tiesiog paleiskite jo komandą, kad įvertintumėte, ar nėra „JavaScript“ failo klaidų. Kadangi mūsų diegimas buvo visuotinis, iš bet kurios vietos galime vykdyti „Jshint“, nurodydami kelią, kuriame yra „JavaScript“ failas. Pavyzdys:

 jshint projektas \ MiApp \ www \ js \ index.js

Dėl to įvyko klaida mūsų „JavaScript“ faile.

Norėdami sužinoti aplanką, kuriame saugomos visos šios visuotinės apimties bibliotekos, galime naudoti priešdėlio komanda ir nuo žymeklio pasaulinis -g, taip:

 npm priešdėlis -g

„OS X“ terminale jis duos tokį rezultatą:

C„Windows“ komandų eilutė rodomas kelias, kurio vienintelis kintamasis yra diegimą atlikusio vartotojo aplanko pavadinimas. Šiuo atveju būtų "Zhock":

„Windows“ sistemoje „NodeJS“ neturi ankstesnio aplanko, apibrėžto kaip visuotinis, kad jo bibliotekos būtų įtrauktos naudojant „Require“. Taigi, jei bandysime įtraukti pasaulinę biblioteką, gausime klaidą „Klaida: nepavyko rasti modulio“.

Norėdami tai išspręsti, turėsime apibrėžti sistemos kintamąjį NODE_PATH, nurodydami jam NPM visuotinio kelio reikšmę ir pabaigoje pridėdami aplanką \ node_modules \.

Kaip matome, „Windows 7“ pasaulinis NPM diegimo kelias yra:

 C: \ Users \ USER \ AppData \ Roaming \ npm \

Taigi NODE_PATH vertė bus:

 C: \ Users \ USER \ AppData \ Roaming \ npm \ node_modules \

Arba kas yra tas pats:

 % APPDATA% \ npm \ node_modules \

DIDELIS

Priklausomybės valdymas
NPM leidžia valdyti jūsų projektų priklausomybes ir jums reikalingas versijas. Kaip žinoma, atvirojo kodo projektai aktyviai juda ir dažnai keičia versiją. The package.json jis gali būti sukonfigūruotas valdyti šių tipų pakeitimus.

The versijos numeriai paprastai jie turi 3 elementus:

• Pagrindinė versija, kai ji sutrinka su ankstesnėmis funkcijomis, pavyzdžiui: 2.0.0
• Nedidelė versija su naujomis funkcijomis, kurios nepažeidžia esamų, pavyzdžiui: 1.1.0
• Išleistas pataisas su klaidų pataisymais ir kitais smulkiais pakeitimais, pavyzdžiui, 1.0.1

Apibrėžkite paketo versijas

Tarkime, jūs pradedate kurti naudodami tam tikras paketų versijas. Galite juos atnaujinti ir išlaikyti suderinamumą nurodydami priimamų pakeitimų diapazoną.

 "priklausomybės": {"Package1": "1.0.0", // priima tik 1.0.0 versiją "container2": "1.0.x", // bet kuri 1.0 versijos karštųjų pataisų versija "Package3": "*", / / naujausia versija, "Package4" nerekomenduojama: "> = 1.0.0", // pakeitimai po 1.0.0 "package5": "= 1.8.0 = 1.1.0 <2.0.0" package8 ":" naujausias " , // naujausios versijos žymos pavadinimas "package9": "", // tas pats kaip * ty naujausia versija "packageX": "= 2.3.1 = 2.5.2 <3.0.0"}

PastabaJei nesate tikri, kurią versiją naudoti, pridėkite * pakaitos simbolį ir paleiskite komandą npm update -save, kurią pamatysime vėliau šioje pamokoje.

Komanda:

 npm atnaujinimas -išsaugokite

Atnaujinkite paketus

Norėdami pamatyti visus vietoje įdiegtus paketus, naudokite komandą ls ir trumpam aprašymui pridėkite atributą -l. Norėdami peržiūrėti visame pasaulyje įdiegtus paketus, pridėkite atributą -g.

 npm ls -l

Norėdami patikrinti, kuris paketas gali būti atnaujintas vietoje ir visame pasaulyje, atlikite šiuos veiksmus:

 npm pasenęs npm pasenęs -g -gylis = 0

Norėdami vietiniu būdu perkelti paketą į naujesnę versiją nei dabartinė, atlikite šiuos veiksmus:

 npm atnaujinimas

Norėdami tai padaryti visame pasaulyje, pridėkite -g atributas

Talpyklos valdymas

Kai NPM įdiegia paketą, jis išsaugo jo kopiją, kai kitą kartą norite įdiegti paketą be interneto ryšio. Šios kopijos pagal numatytuosius nustatymus saugomos šiame kataloge:

 „Posix“ („Linux“, „Os X“): ~ / .npm „Windows“:% AppData% / npm-cache

Jei norite pamatyti, kuriame kataloge saugoma NPM talpykla, tiesiog paleiskite šią komandų eilutę:

 npm config gauti talpyklą

Šis katalogas paprastai yra užpildytas senais paketais, kurių nebenaudojame, todėl rekomenduojama periodiškai valyti šią komandinę eilutę:

 npm talpyklos išvalymas