NPM: pārvaldiet JavaScript paketes

Ievads NPM

Kas ir NPM?NPM (mezglu pakotņu pārvaldnieks) ir JavaScript pakotņu pārvaldnieks, tas ir noklusējums nodalījumam node.js. Instalējot mezglu, tiek instalēts arī NPM. Un ko tas nozīmē? Izmantojot NPM, mēs varam instalēt un pārvaldīt mūsu lietojumprogrammu paketes.

Izmantojot Node.js, mums ātri jāinstalē jauni moduļi (bibliotēkas), jo Node, kas ir ļoti modulāra sistēma, praktiski ir tukša. Tātad lielākajai daļai darbību mums būs jāinstalē papildu moduļi. Šo darbību ļoti viegli var veikt ar NPM rīku.

Kā instalēt Node.js?Lai instalētu Node.js, pirmā lieta, kas mums jādara, ir ieiet oficiālajā vietnē:

https://nodejs.org/

Un lejupielādējiet instalētāju atbilstoši mūsu operētājsistēmai.

PALIELINĀT

Lejupielādējot instalācijas failu, mēs vienkārši veicam dubultklikšķi uz tā un izpildām Node.js instalēšanas vedņa norādījumus.

Pēc instalēšanas Windows lietotājiem konsole nod.js būs pieejama no palaišanas joslas, kā parādīts šajā attēlā:

PALIELINĀT

Mac lietotājiem būs jāatver savas operētājsistēmas terminālis, kā parādīts šajā attēlā:

PALIELINĀT

Lai pārbaudītu, vai tas ir pareizi instalēts, mūsu terminālī izpildām šādu komandu:

 nedod

(Windows / Linux / Terminal OS X konsole)

Mēs spiežam Ievadiet un mēs ievadām šādu rindu:

 Console.log ('Node.js veiksmīgi instalēts');

(Windows / Linux / Terminal OS X konsole)

Nospiežot Ievadiet, tas parādīs mums ziņu "Node.js ir veiksmīgi instalēts". Lai redzētu node.js atļauto komandu sarakstu, mēs ievadām komandu .palīdzēt kā parādīts nākamajā attēlā:

Lai apskatītu Instalēta NPM versija, mēs izpildām šādu komandu:

 npm -v

Rezultāts būs šāds:

Iepakojuma vadītājs
NPM pakotņu pārvaldnieks, nedaudz atšķiras no citiem, iespējams, zināmiem pakotņu pārvaldniekiem, jo ​​tas tos instalē projektos lokāli. Tas ir, kad modulis tiek lejupielādēts, tas tiek pievienots vietējam projektam, kuram tas būs pieejams. Lai gan ir arī iespēja mūsu sistēmā globāli instalēt paketes.

Sākot jaunu projektu

Kad mēs sākam jaunu projektu, izmantojot node.js, ir jāizveido fails ar nosaukumu package.json. Tas ir sava veida manifests, kas savukārt satur visu jūsu projektā izmantoto atkarību sarakstu.

Izmantošana package.json

Labākais veids, kā pārvaldīt lokāli instalētas paketes, ir izveidot package.json failu, kas ļauj mums:

• Dokumentējiet, kādus iepakojumus izmanto mūsu projekts.
• Norādiet, kādu konkrētu pakotnes versiju izmantos mūsu projekts.
• Tas ļauj mums viegli koplietot savu atkarību ar citiem izstrādātājiem.

Prasības:

Failā package.json jābūt vismaz:

1. Vārds:

• Viss ar mazajiem burtiem.
• Viens vārds bez atstarpēm.
• Svītra un pasvītrojums ir atļauts.

2. Versija:

Package.json piemērs:

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

Ja vēlaties ģenerēt jaunu package.json, ir 2 veidi, kā to izdarīt:

1. Ielādējiet noklusējuma paketi.json: No konsoles mēs izpildām šādu komandrindu.

 npm init -jā

Rezultāts būs šāds:

Lai mainītu šo konfigurāciju, mēs vienkārši atveram ar teksta redaktoru izveidoto failu un modificējam vēlamos atribūtus.

2. Izveidojiet package.json ar vedni: Konsolē mēs izpildām šādu komandu.

 npm init

Vednis jautās, ko vēlaties pievienot katram atribūtam, kā rezultātā tiks parādīts sekojošais:

Atkarību instalēšana

Vietnē https://www.npmjs.com/ varat atrast simtiem projektu; kuras tiek pozicionētas pēc dažādiem kritērijiem (lejupielāžu skaits, popularitāte …). No tīmekļa lapas tas ir ātrākais veids, tomēr NPM ir arī meklēšanas parametrs pakešu meklēšanai. Lai to izdarītu, jums jāpalaiž šāda komandrinda:

Vietējā instalācija
Kad fails ir definēts package.json, varat pievienot tajā esošās atkarības un pievienot visu nepieciešamo:

 "atkarības": {"express": "*", "grunt": "*", "bower": "*"}

Kam vajadzētu būt šādam:

Instalējiet paketē package.json norādītās pakotnesLai instalētu paketē package.json uzskaitītās pakotnes un to atkarības, jums jāatrodas direktorijā, kurā atrodas minētais fails, un jāizpilda šāda komandrinda:

 npm instalēt

Instalējiet paketesJūs varat arī instalējiet jaunas paketes un saglabājiet tās no termināļa, izpildot sekojošo:

 npm instalēt -saglabāt jaunu_pakotnes_nosaukumu

Atinstalējiet paketesAtinstalēt pakotni un izdzēsiet to no package.json:

 npm atinstalēt -saglabāt paketes_nosaukumu

Instalējiet paketi tieši no Git krātuves

 npm instalējiet git: //github.com/blured/mipaquete.git

Instalējiet noteiktu pakotnes versiju

 npm instalējiet [email protected]

Ir svarīgi atzīmēt, ka šī vietējā instalēšanas metode nozīmē, ka jūsu faili tiks saglabāti un pieejami tikai jūsu projekta direktorijā.

Globālā instalācija
Vēl viens veids, kā instalēt paketes, ir to darīt visā pasaulē. To parasti izmanto pakotnēm, kas nodrošina funkcionalitāti no komandrindas, piemēram, grunt, bower, yeoman, cita starpā.

Ņemiet, piemēram, JSHint pakete, kas ir JavaScript kodu analizators, kas ļauj mums parādīt punktus, kuros jūsu kods neatbilst noteiktiem "tīra koda" noteikumiem. Lai to instalētu globāli, mēs palaižam instalēšanas komanda pievienojot -g atribūts un ar saknes privilēģija (Mac un Linux lietotājiem).

 sudo npm instalēt -g jshint

 npm instalēt -g jshint

Lai apstiprinātu tā instalēšanu, vienkārši palaidiet tās komandu, lai novērtētu, vai kādā JavaScript failā nav kļūdu. Tā kā mūsu instalācija bija globāla, no jebkuras vietas mēs varam izpildīt Jshint, norādot ceļu, kur atrodas mūsu JavaScript fails. Piemērs:

 jshint projekts \ MiApp \ www \ js \ index.js

Rezultātā mūsu JavaScript failā radās kļūda.

Lai uzzinātu mapi, kurā tiek glabātas visas šīs bibliotēkas ar globālu darbības jomu, mēs varam izmantot prefiksa komanda un no marķiera globāls -g, sekojoši:

 npm prefikss -g

OS X terminālī tas sniegs šādu rezultātu:

CWindows komandu uzvedne tiek parādīts ceļš, kura vienīgais mainīgais ir instalētāja lietotāja mapes nosaukums. Šajā gadījumā tā būtu "Zhock":

Operētājsistēmā Windows NodeJS iepriekšējā mape nav definēta kā globāla, lai iekļautu tās bibliotēkas, izmantojot prasību. Tātad, ja mēs mēģinām iekļaut globālu bibliotēku, mēs saņemsim kļūdu "Kļūda: Nevar atrast moduli".

Lai to atrisinātu, mums būs jādefinē sistēmas mainīgais NODE_PATH, piešķirot tam NPM globālā ceļa vērtību un beigās pievienojot mapi \ node_modules \.

Kā redzam, operētājsistēmā Windows 7 NPM globālais instalācijas ceļš ir šāds:

 C: \ Users \ USER \ AppData \ Viesabonēšana \ npm \

Tātad NODE_PATH vērtība būs:

 C: \ Users \ USER \ AppData \ Viesabonēšana \ npm \ node_modules \

Vai arī kas ir tas pats:

 % APPDATA% \ npm \ node_modules \

PALIELINĀT

Atkarības pārvaldība
NPM ļauj pārvaldīt savu projektu atkarības un nepieciešamās versijas. Kā zināms, atvērtā koda projekti aktīvi virzās un bieži maina versiju. package.json to var konfigurēt, lai kontrolētu šāda veida izmaiņas.

versijas numurus parasti tie satur 3 elementus:

• Galvenā versija, ja tā atšķiras no iepriekšējām funkcijām, piemēram: 2.0.0
• Neliela versija ar jaunām funkcijām, kas nepārkāpj esošās, piemēram: 1.1.0
• Ielādēts ielāps ar kļūdu labojumiem un citām nelielām izmaiņām, piemēram, 1.0.1

Definējiet pakotnes versijas

Pieņemsim, ka sākat izstrādāt ar noteiktām pakotņu versijām. Jūs varat tos atjaunināt un joprojām saglabāt saderību, norādot pieņemamo izmaiņu diapazonu.

 "atkarības": {"Package1": "1.0.0", // pieņem tikai versiju 1.0.0 "container2": "1.0.x", // jebkura labojumfaila versija versijā 1.0 "Package3": "*", / / jaunākā versija, "Package4" nav ieteicams: "> = 1.0.0", // izmaiņas pēc 1.0.0 "package5": "= 1.8.0 = 1.1.0 <2.0.0" package8 ":" jaunākais " , // jaunākās versijas taga nosaukums "package9": "", // tāds pats kā * ti, jaunākā versija "packageX": "= 2.3.1 = 2.5.2 <3.0.0"}

PiezīmeJa neesat pārliecināts, kuru versiju izmantot, pievienojiet * aizstājējzīmi un palaidiet komandu npm update -save, ko mēs redzēsim vēlāk šajā apmācībā.

Komanda:

 npm atjauninājums -saglabājiet

Atjauniniet paketes

Lai redzētu visas lokāli instalētās pakotnes, izmantojiet komandu ls un īsam aprakstam pievienojiet atribūtu -l. Lai apskatītu globāli instalētās pakotnes, pievienojiet atribūtu -g.

 npm ls -l

Lai pārbaudītu, kuru pakotni var atjaunināt lokāli un globāli, rīkojieties šādi:

 npm novecojis npm novecojis -g -dziļums = 0

Lai lokāli pārvietotu pakotni uz versiju, kas ir augstāka par pašreizējo, palaidiet šo:

 npm atjauninājums

Lai to izdarītu visā pasaulē, pievienojiet -g atribūts

Kešatmiņas pārvaldība

Kad NPM instalē pakotni, tā saglabā kopiju nākamajai reizei, kad vēlaties instalēt paketi, bez interneta savienojuma. Šīs kopijas pēc noklusējuma tiek saglabātas šajā direktorijā:

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

Ja vēlaties redzēt, kurā direktorijā tiek glabāta NPM kešatmiņa, vienkārši palaidiet šādu komandrindu:

 npm config iegūt kešatmiņu

Šis direktorijs parasti ir piepildīts ar vecām pakotnēm, kuras mēs vairs neizmantojam, tāpēc ieteicams periodiski tīrīt, izmantojot šādu komandrindu:

 npm kešatmiņa tīra