NPM: Administrer JavaScript -pakker

Indledning NPM

Hvad er NPM?NPM (Node Package Manager) er en pakkehåndtering til JavaScript, det er standard for node.js. Når du installerer node, er NPM også installeret. Og hvad betyder dette? Godt, gennem NPM kan vi installere og administrere pakkerne til vores applikationer.

Når vi bruger Node.js, skal vi hurtigt installere nye moduler (biblioteker), da Node, der er et stærkt modulært system, næsten er tom. Så for de fleste operationer bliver vi nødt til at installere yderligere moduler. Denne operation udføres meget let med NPM -værktøjet.

Sådan installeres Node.js?For at installere Node.js er det første, vi skal gøre, at gå ind på det officielle websted:

https://nodejs.org/

Og download installationsprogrammet i henhold til vores operativsystem.

FORSTØRRE

Når vi downloader installationsfilen, dobbeltklikker vi ganske enkelt på den og følger instruktionerne i installationsguiden til Node.js.

Når den er installeret til Windows -brugere, vil node.js -konsollen være tilgængelig fra startlinjen, som vist på følgende billede:

FORSTØRRE

Mac -brugere skal åbne terminalen for deres operativsystem som vist på følgende billede:

FORSTØRRE

For at kontrollere, at den er installeret korrekt, udfører vi følgende kommando i vores terminal:

 Giv ikke

(Windows / Linux / Terminal OS X -konsol)

Vi skubber Gå ind og vi indtaster følgende linje:

 Console.log ('Node.js installeret med succes');

(Windows / Linux / Terminal OS X -konsol)

Ved at trykke på Gå ind, det vil vise os beskeden "Node.js installeret korrekt". For at se listen over kommandoer, der er tilladt af node.js, indtaster vi kommandoen .Hjælp som vist på følgende billede:

For at se NPM -version installeret, udfører vi følgende kommando:

 npm -v

Hvilket vil resultere i følgende:

Pakke manager
Det NPM pakkeleder, er en smule anderledes end andre pakkeledere, som vi måske kender, fordi det installerer dem lokalt i projekterne. Det vil sige, at når et modul downloades, tilføjes det til et lokalt projekt, som er det, der vil have det tilgængeligt for at inkludere. Selvom der også er mulighed for at installere pakkerne globalt på vores system.

Starter et nyt projekt

Når vi starter et nyt projekt ved hjælp af node.js, er det nødvendigt at oprette en fil kaldet package.json. Dette er en slags manifest, der igen indeholder listen over alle de afhængigheder, som dit projekt vil bruge.

Anvendelse af package.json

Den bedste måde at administrere lokalt installerede pakker på er at oprette en package.json -fil, dette giver os mulighed for at:

• Dokumenter, hvilke pakker vores projekt bruger.
• Angiv hvilken specifik pakkeversion vores projekt vil bruge.
• Det giver os mulighed for let at dele vores afhængigheder med andre udviklere.

Krav:

En package.json -fil skal mindst have:

1. Navn:

• Alt sammen med små bogstaver.
• Et ord uden plads.
• Streg og understregning er tilladt.

2. Version:

Eksempel på en package.json:

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

Hvis du vil generere en ny package.json, der er 2 måder at gøre det på:

1. Indlæs en standardpakke. Json: Fra konsollen udfører vi følgende kommandolinje.

 npm init -ja

Hvilket vil resultere i følgende:

For at ændre denne konfiguration åbner vi simpelthen den fil, der er oprettet med et tekstredigeringsprogram, og ændrer de attributter, vi ønsker.

2. Opret en package.json med guiden: I konsollen udfører vi følgende kommando.

 npm init

Guiden spørger dig, hvad du vil tilføje til hver attribut, hvilket resulterer i følgende:

Installation af afhængigheder

Fra webstedet https://www.npmjs.com/ kan du finde hundredvis af projekter; som er placeret efter forskellige kriterier (antal downloads, popularitet …). Fra websiden er det den hurtigste måde, men NPM har også en søgeparameter til at søge efter pakker. For at gøre dette skal du køre følgende kommandolinje:

Lokal installation
Når filen er defineret package.json, kan du tilføje afhængighederne i den og tilføje en liste over alt, hvad du har brug for:

 "dependencies": {"express": "*", "grunt": "*", "bower": "*"}

Hvilket skal være som følger:

Installer de pakker, der er angivet i package.jsonFor at installere pakkerne i package.json og deres afhængigheder skal du være placeret i biblioteket, hvor filen er placeret, og udføre følgende kommandolinje:

 npm installation

Installer pakkerDu kan også installere nye pakker og gemme dem fra terminalen, ved at udføre følgende:

 npm installere -gemme nyt_pakkenavn

Afinstaller pakkerAfinstaller pakken og slet det fra package.json:

 npm afinstallere -gem pakkenavn

Installer pakken direkte fra et Git -lager

 npm installer git: //github.com/blured/mipaquete.git

Installer en bestemt version af en pakke

 npm installer [email protected]

Det er vigtigt at bemærke, at denne lokale installationsmetode betyder, at dine filer gemmes og kun er tilgængelige i dit projektmappe.

Global installation
En anden måde at installere pakker på er at gøre det globalt. Dette bruges normalt til pakker, der giver funktionalitet fra kommandolinjen, såsom grunt, bower, yeoman, blandt andre.

Tag for eksempel JSHint -pakke, som er en JavaScript -kodeanalysator, der giver os mulighed for at vise punkter, hvor din kode ikke overholder bestemte regler for "ren kode". For at installere det globalt kører vi installere kommando tilføjelse af -g attribut og med rod privilegium (for Mac- og Linux -brugere).

 sudo npm install -g jshint

 npm install -g jshint

For at bekræfte installationen skal du bare køre kommandoen for at evaluere nogle JavaScript -filer for fejl. Da vores installation var global, kan vi fra ethvert sted eksekvere Jshint, hvilket angiver stien, hvor vores JavaScript -fil er placeret. Eksempel:

 jshint -projekt \ MiApp \ www \ js \ index.js

Det resulterer i en fejl i vores JavaScript -fil.

For at kende den mappe, hvor alle disse biblioteker med globalt omfang er gemt, kan vi bruge kommando for præfiks og fra markøren globalt -g, som følger:

 npm præfiks -g

I en OS X -terminal giver det følgende resultat:

I CWindows ommand prompt stien vises med den eneste variabel navnet på mappen på den bruger, der foretog installationen. I dette tilfælde ville det være "Zhock":

I Windows har NodeJS ikke den tidligere mappe defineret som global for inkludering af dens biblioteker via krav. Så hvis vi forsøger at inkludere et globalt bibliotek, får vi fejlen "Fejl: Kan ikke finde modul".

For at løse det bliver vi nødt til at definere systemvariablen NODE_PATH, hvilket giver værdien af ​​den globale sti til NPM og tilføjer mappen \ node_modules \ i slutningen.

Som vi kan se, i Windows 7 er den globale installationssti for NPM:

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

Så værdien af ​​NODE_PATH vil være:

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

Eller hvad er det samme:

 % APPDATA% \ npm \ node_modules \

FORSTØRRE

Afhængighedsstyring
NPM giver dig mulighed for at styre afhængighederne af dine projekter og de versioner, du har brug for. Som det er kendt, bevæger open source -projekter sig aktivt og ændrer ofte version. Det package.json den kan konfigureres til at kontrollere disse typer ændringer.

Det versionsnumre de indeholder normalt 3 elementer:

• Stor version, når den bryder med tidligere funktionaliteter, for eksempel: 2.0.0
• Mindre version med nye funktioner, der ikke bryder eksisterende, f.eks .: 1.1.0
• Patch frigivet med fejlrettelser og andre mindre ændringer, f.eks. 1.0.1

Definer pakkeversioner

Lad os sige, at du begynder at udvikle med visse versioner af pakker. Du kan opdatere dem og stadig bevare kompatibiliteten ved at angive rækkevidden af ​​accepterede ændringer.

 "dependencies": {"Package1": "1.0.0", // accepterer kun version 1.0.0 "container2": "1.0.x", // enhver hotfix -version i version 1.0 "Package3": "*", / / nyeste version, "Package4" anbefales ikke: "> = 1.0.0", // ændringer efter 1.0.0 "package5": "= 1.8.0 = 1.1.0 <2.0.0" package8 ":" seneste " , // seneste version tag -navn "package9": "", // samme som * dvs. seneste version "packageX": "= 2.3.1 = 2.5.2 <3.0.0"}

BemærkHvis du ikke er sikker på, hvilken version du skal bruge, skal du tilføje * wildcard og køre kommandoen npm update -save, som vi vil se senere i denne vejledning.

Kommando:

 npm opdatering -gem

Opdater pakker

For at se alle lokalt installerede pakker skal du bruge kommandoen ls og tilføje attributten -l til en kort beskrivelse. For at se globalt installerede pakker skal du tilføje attributten -g.

 npm ls -l

For at kontrollere, hvilken pakke der kan opdateres lokalt og globalt, skal du køre følgende:

 npm forældet npm forældet -g --dybde = 0

Hvis du vil bringe en pakke lokalt til en version, der er højere end den nuværende, skal du køre følgende:

 npm opdatering

For at gøre det globalt skal du tilføje -g attribut

Håndtering af cache

Når NPM installerer en pakke, gemmer den en kopi til næste gang du vil installere pakken uden behov for en internetforbindelse. Disse kopier gemmes som standard i følgende bibliotek:

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

Hvis du vil se i hvilken mappe NPM -cachen gemmes, skal du bare køre følgende kommandolinje:

 npm config få cache

Denne mappe er normalt fyldt med gamle pakker, som vi ikke længere bruger, og derfor anbefales det at rengøre med jævne mellemrum med følgende kommandolinje:

 npm cache ren