Introducere NPM
Ce este NPM?NPM (Node Package Manager) este un manager de pachete pentru JavaScript, este implicit pentru node.js. Când instalați nodul, este instalat și NPM. Și ce înseamnă asta? Ei bine, prin NPM putem instala și gestiona pachetele pentru aplicațiile noastre.
Când folosim Node.js, trebuie să instalăm rapid module noi (biblioteci), deoarece Node, fiind un sistem puternic modular, este practic gol. Deci, pentru majoritatea operațiunilor va trebui să instalăm module suplimentare. Această operațiune se face foarte ușor cu instrumentul NPM.
Cum se instalează Node.js?Pentru a instala Node.js, primul lucru pe care trebuie să-l facem este să intrăm pe site-ul oficial:
https://nodejs.org/
Și descărcați programul de instalare conform sistemului nostru de operare.
MARI
La descărcarea fișierului de instalare, facem dublu clic pe el și urmăm instrucțiunile expertului de instalare Node.js.
Odată instalată pentru utilizatorii Windows, consola node.js va fi accesibilă din bara de lansare, așa cum se arată în următoarea imagine:
MARI
Utilizatorii de Mac vor trebui să deschidă terminalul sistemului de operare așa cum se arată în următoarea imagine:
MARI
Pentru a verifica dacă este instalat corect, executăm următoarea comandă în terminalul nostru:
nu da(Consola Windows / Linux / Terminal OS X)
Împingem introduce și intrăm în următoarea linie:
Console.log ('Node.js instalat cu succes');(Consola Windows / Linux / Terminal OS X)
Prin apăsarea introduce, ne va arăta mesajul "Node.js instalat cu succes". Pentru a vedea lista de comenzi permise de node.js, introducem comanda .Ajutor așa cum se arată în următoarea imagine:
Pentru a vizualiza Versiunea NPM instalată, executăm următoarea comandă:
npm -vCeea ce va avea ca rezultat următoarele:
Manager de pachete
Manager de pachete NPM, este puțin diferit de alți manageri de pachete pe care este posibil să-i cunoaștem, deoarece îi instalează local în proiecte. Adică, atunci când un modul este descărcat, acesta este adăugat la un proiect local, care este cel care îl va avea disponibil să fie inclus. Deși există și posibilitatea de a instala pachetele la nivel global pe sistemul nostru.
Începerea unui nou proiect
Când începem un nou proiect folosind node.js este necesar să creăm un fișier numit package.json. Acesta este un fel de manifest care la rândul său conține lista tuturor dependențelor pe care proiectul dvs. le va folosi.
Utilizarea de pachet.json
Cel mai bun mod de a gestiona pachetele instalate local este de a crea un fișier package.json, aceasta ne permite să:
- Documentați ce pachete folosește proiectul nostru.
- Specificați ce versiune specifică de pachet va utiliza proiectul nostru.
- Ne permite să împărtășim cu ușurință dependențele noastre cu alți dezvoltatori.
Cerințe:
Un fișier package.json trebuie să aibă cel puțin:
1. Nume:
- Toate cu litere mici.
- Un cuvânt fără spațiu.
- Sunt permise liniuța și sublinierea.
2. Versiune:
Exemplu de package.json:
{"Name": "project_package", "Version": "1.0.0"}Dacă doriți să generați un nou pachet.json, există 2 moduri de a face acest lucru:
1. Încărcați un package.json implicit: Din consolă executăm următoarea linie de comandă.
npm init - daCeea ce va avea ca rezultat următoarele:
Pentru a modifica această configurație, pur și simplu deschidem fișierul creat cu un editor de text și modificăm atributele dorite.
2. Creați un package.json cu expertul: În consolă executăm următoarea comandă.
npm initExpertul vă va întreba ce doriți să adăugați la fiecare atribut, rezultând următoarele:
Instalarea dependențelor
De pe site-ul https://www.npmjs.com/ puteți găsi sute de proiecte; care sunt poziționate în funcție de diferite criterii (număr de descărcări, popularitate …). De pe pagina web este cel mai rapid mod, totuși NPM are și un parametru de căutare pentru a căuta pachete. Pentru a face acest lucru, trebuie să rulați următoarea linie de comandă:
Instalare locală
Odată ce fișierul este definit pachet.json, puteți adăuga dependențele din acesta și puteți adăuga o listă cu tot ce aveți nevoie:
"dependencies": {"express": "*", "grunt": "*", "bower": "*"}Care ar trebui să fie după cum urmează:
Instalați pachetele listate în package.jsonPentru a instala pachetele listate în package.json și dependențele acestora, trebuie să fiți localizat în directorul în care se află fișierul respectiv și să executați următoarea linie de comandă:
instalare npm
Instalați pachetePoti de asemenea instalați pachete noi și salvați-le de la terminal, executând următoarele:
npm install - save new_package_name
Dezinstalați pacheteleDezinstalați pachetul și ștergeți-l din pachet.json:
npm dezinstalați - salvați numele_pachetului
Instalați pachetul direct dintr-un depozit Git
npm instalați git: //github.com/blured/mipaquete.git
Instalați o versiune specifică a unui pachet
npm instalați [email protected]
Este important să rețineți că această metodă de instalare locală înseamnă că fișierele dvs. vor fi stocate și disponibile numai în directorul proiectului.
Instalare globală
O altă modalitate de a instala pachete este să o faceți la nivel global. Acest lucru este utilizat în mod obișnuit pentru pachetele care oferă funcționalități din linia de comandă, cum ar fi grunt, bower, yeoman, printre altele.
Luați de exemplu Pachetul JSHint, care este un analizor de cod JavaScript care ne permite să afișăm puncte în care codul dvs. nu respectă anumite reguli stabilite de „cod curat”. Pentru ao instala la nivel global, rulăm comanda de instalare adăugând -g atribut si cu privilegiu de rădăcină (pentru utilizatorii de Mac și Linux).
sudo npm install -g jshint
npm install -g jshint
Pentru a confirma instalarea sa, executați comanda pentru a evalua erorile unui fișier JavaScript. Deoarece instalarea noastră a fost globală, din orice locație putem executa Jshint, indicând calea în care se află fișierul nostru JavaScript. Exemplu:
jshint project \ MiApp \ www \ js \ index.jsRezultând o eroare în fișierul nostru JavaScript.
Pentru a cunoaște folderul în care sunt stocate toate aceste biblioteci cu scop global, putem folosi comandă prefix și din marker global -g, după cum urmează:
npm prefix -gÎntr-un terminal OS X va da următorul rezultat:
În CSolicitare comandă Windows se afișează calea, având ca singură variabilă, numele folderului utilizatorului care a făcut instalarea. În acest caz ar fi „Zhock”:
În Windows, NodeJS nu are folderul anterior definit ca global pentru includerea bibliotecilor sale prin require. Deci, dacă încercăm să includem o bibliotecă globală, vom primi eroarea „Eroare: nu se poate găsi modulul”.
Pentru ao rezolva va trebui să definim variabila de sistem NODE_PATH, oferindu-i valoarea căii globale a NPM și adăugând folderul \ node_modules \ la final.
După cum putem vedea, în Windows 7 calea globală de instalare a NPM este:
C: \ Users \ USER \ AppData \ Roaming \ npm \Deci valoarea NODE_PATH va fi:
C: \ Users \ USER \ AppData \ Roaming \ npm \ node_modules \Sau ce este același:
% APPDATA% \ npm \ node_modules \
MARI
Managementul dependenței
NPM vă permite să gestionați dependențele proiectelor dvs. și versiunile de care aveți nevoie. După cum se știe, proiectele open source se mișcă activ și schimbă frecvent versiunea. pachet.json poate fi configurat pentru a controla aceste tipuri de modificări.
numere de versiune ele conțin în mod normal 3 elemente:
- Versiune majoră când se rupe de funcționalitățile anterioare, de exemplu: 2.0.0
- Versiune minoră cu funcții noi care nu le rup pe cele existente, de exemplu: 1.1.0
- Patch lansat cu remedieri de erori și alte modificări minore, de exemplu 1.0.1
Definiți versiunile pachetului
Să presupunem că începeți să dezvoltați cu anumite versiuni de pachete. Puteți să le actualizați și să păstrați în continuare compatibilitatea specificând gama de modificări acceptate.
"dependencies": {"Package1": "1.0.0", // acceptă numai versiunea 1.0.0 "container2": "1.0.x", // orice versiune de remediere rapidă din versiunea 1.0 "Package3": "*", / / ultima versiune, "Package4" nu este recomandat: "> = 1.0.0", // se modifică după 1.0.0 "package5": "= 1.8.0 = 1.1.0 <2.0.0" package8 ":" ultima " , // numele etichetei ultimei versiuni "package9": "", // la fel ca * adică cea mai recentă versiune "packageX": "= 2.3.1 = 2.5.2 <3.0.0"}NotăDacă nu sunteți sigur ce versiune să utilizați, adăugați * wildcard și rulați comanda npm update -save, pe care o vom vedea mai târziu în acest tutorial.
Comanda:
actualizare npm - salvați
Actualizați pachetele
Pentru a vedea toate pachetele instalate local, utilizați comanda ls și adăugați atributul -l pentru o scurtă descriere. Pentru a vizualiza pachetele instalate la nivel global, adăugați atributul -g.
npm ls -lPentru a verifica ce pachet poate fi actualizat local și global, executați următoarele:
npm învechit npm învechit -g --depth = 0Pentru a aduce local un pachet la o versiune mai mare decât cea curentă, executați următoarele:
actualizare npmPentru a face acest lucru la nivel global, adăugați -g atribut
Gestionarea cache-ului
Când NPM instalează un pachet, acesta păstrează o copie pentru data viitoare când doriți să instalați pachetul fără a fi nevoie de o conexiune la Internet. Aceste copii sunt stocate în următorul director în mod implicit:
Posix (Linux, Os X …): ~ / .npm Windows:% AppData% / npm-cacheDacă doriți să vedeți în ce director este stocată memoria cache NPM, rulați următoarea linie de comandă:
npm config obține cacheAcest director este de obicei umplut cu pachete vechi pe care nu le mai folosim, de aceea se recomandă curățarea periodică cu următoarea linie de comandă:
npm cache curat
