NPM: Upravljanje JavaScript paketima

Uvod NPM

Što je NPM?NPM (Node Package Manager) upravitelj je paketa za JavaScript, zadani je za node.js. Kada instalirate čvor, instaliran je i NPM. I što to znači? Pa, putem NPM -a možemo instalirati i upravljati paketima za naše aplikacije.

Kad koristimo Node.js, moramo brzo instalirati nove module (knjižnice) jer Node, budući da je jako modularni sustav, dolazi praktički prazan. Stoga ćemo za većinu operacija morati instalirati dodatne module. Ova se operacija vrlo lako izvodi s NPM alatom.

Kako instalirati Node.js?Da bismo instalirali Node.js, prvo što moramo učiniti je ući na službenu web stranicu:

https://nodejs.org/

I preuzmite instalacijski program prema našem operativnom sustavu.

POVEĆAJTE

Prilikom preuzimanja instalacijske datoteke jednostavno dvaput kliknemo na nju i slijedimo upute čarobnjaka za instalaciju Node.js.

Jednom instalirana za korisnike sustava Windows, konzoli node.js bit će dostupna s trake za pokretanje, kao što je prikazano na sljedećoj slici:

POVEĆAJTE

Korisnici Mac računala morat će otvoriti terminal svog operacijskog sustava kako je prikazano na sljedećoj slici:

POVEĆAJTE

Da bismo provjerili je li ispravno instaliran, izvršavamo sljedeću naredbu u našem terminalu:

 nemoj dati

(Windows / Linux / Terminal OS X konzola)

Guramo Unesi i unosimo sljedeći redak:

 Console.log ('Node.js uspješno instaliran');

(Windows / Linux / Terminal OS X konzola)

Pritiskom na Unesi, pokazat će nam poruku "Node.js uspješno instaliran". Da bismo vidjeli popis naredbi koje dopušta node.js, unosimo naredbu .Pomozite kao što je prikazano na sljedećoj slici:

Za pregled Instalirana NPM verzija, izvršavamo sljedeću naredbu:

 npm -v

Što će rezultirati sljedećim:

Upravitelj paketa
The NPM upravitelj paketa, malo se razlikuje od drugih upravitelja paketa koje možda poznajemo, jer ih instalira lokalno u projekte. Odnosno, kada se modul preuzme, dodaje se lokalnom projektu, koji će mu biti dostupan za uključivanje. Iako postoji i mogućnost globalne instalacije paketa na naš sustav.

Pokretanje novog projekta

Kada započinjemo novi projekt pomoću node.js potrebno je stvoriti datoteku pod nazivom package.json. Ovo je svojevrsni manifest koji zauzvrat sadrži popis svih ovisnosti koje će vaš projekt koristiti.

Korištenje paket.json

Najbolji način za upravljanje lokalno instaliranim paketima je stvaranje datoteke package.json, što nam omogućuje:

• Dokumentirajte koje pakete naš projekt koristi.
• Navedite koju će verziju paketa naš projekt koristiti.
• Omogućuje nam jednostavno dijeljenje ovisnosti s drugim programerima.

Zahtjevi:

Datoteka package.json mora imati najmanje:

1. Ime:

• Sve malim slovima.
• Jedna riječ bez razmaka.
• Crtica i podcrtavanje su dopušteni.

2. Verzija:

Primjer package.json:

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

Ako želite generirati novu paket.json, postoje 2 načina za to:

1. Učitajte zadani paket.json: Iz konzole izvršavamo sljedeću naredbenu liniju.

 npm init -da

Što će rezultirati sljedećim:

Da bismo izmijenili ovu konfiguraciju, jednostavno otvorimo datoteku stvorenu uređivačem teksta i izmijenimo željene atribute.

2. Izradite package.json s čarobnjakom: U konzoli izvršavamo sljedeću naredbu.

 npm init

Čarobnjak će vas pitati što želite dodati svakom atributu, što rezultira sljedećim:

Instaliranje ovisnosti

Na web stranici https://www.npmjs.com/ možete pronaći stotine projekata; koji su pozicionirani prema različitim kriterijima (broj preuzimanja, popularnost …). S web stranice to je najbrži način, međutim NPM također ima parametar pretraživanja za pretraživanje paketa. Da biste to učinili, morate pokrenuti sljedeću naredbenu liniju:

Lokalna instalacija
Nakon što je datoteka definirana paket.json, u njega možete dodati ovisnosti i dodati popis svega što vam je potrebno:

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

Što bi trebalo biti sljedeće:

Instalirajte pakete navedene u package.jsonDa biste instalirali pakete navedene u package.json i njihove ovisnosti, morate se nalaziti u direktoriju u kojem se nalazi navedena datoteka i izvršiti sljedeću naredbenu liniju:

 npm instalirati

Instalirajte paketeTakođer možete instalirajte nove pakete i spremite ih s terminala, izvršavanjem sljedećeg:

 npm install --save new_package_name

Deinstalirajte paketeDeinstalirajte paket i izbrisati ga iz paket.json:

 npm uninstall -spremi naziv_paketa

Instalirajte paket izravno iz Git spremišta

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

Instalirajte određenu verziju paketa

 npm install [email protected]

Važno je napomenuti da ova lokalna instalacijska metoda znači da će vaše datoteke biti pohranjene i dostupne samo u direktoriju vašeg projekta.

Globalna instalacija
Drugi način instaliranja paketa je globalno. To se obično koristi za pakete koji između ostalog pružaju funkcionalnost iz naredbenog retka, poput grunt, bower, yeoman.

Uzmimo za primjer JSHint paket, koji je JavaScript analizator koda koji nam omogućuje prikazivanje točaka u kojima vaš kôd nije u skladu s određenim utvrđenim pravilima "čistog koda". Da bismo ga instalirali globalno, pokrećemo naredba install dodajući -g atribut i sa root privilegija (za korisnike Mac -a i Linuxa).

 sudo npm install -g jshint

 npm install -g jshint

Da biste potvrdili njegovu instalaciju, samo pokrenite njezinu naredbu za procjenu pogreške neke JavaScript datoteke. Kako je naša instalacija bila globalna, s bilo kojeg mjesta možemo izvesti Jshint, označavajući put na kojem se nalazi naša JavaScript datoteka. Primjer:

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

Rezultat je pogreška u našoj JavaScript datoteci.

Da bismo znali mapu u koju su pohranjene sve te knjižnice s globalnim opsegom, možemo upotrijebiti naredba prefiksa i od markera globalno -g, kako slijedi:

 npm prefiks -g

U OS X terminalu će dati sljedeći rezultat:

U CWindows ommand prompt prikazuje se put koji ima kao jedinu varijablu naziv mape korisnika koji je izvršio instalaciju. U ovom slučaju bi bilo "Zhock":

U sustavu Windows NodeJS nema prethodnu mapu definiranu kao globalnu za uključivanje svojih knjižnica kroz require. Dakle, ako pokušamo uključiti globalnu knjižnicu, dobit ćemo pogrešku "Pogreška: Ne mogu pronaći modul".

Da bismo ga riješili, morat ćemo definirati sistemsku varijablu NODE_PATH, dajući joj vrijednost globalne staze NPM -a i dodajući mapu \ node_moduli \ na kraju.

Kao što vidimo, u sustavu Windows 7 globalni instalacijski put NPM -a je:

 C: \ Korisnici \ USER \ AppData \ Roaming \ npm \

Dakle, vrijednost NODE_PATH bit će:

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

Ili što je isto:

 % APPDATA% \ npm \ nmoduli čvora \

POVEĆAJTE

Upravljanje ovisnostima
NPM vam omogućuje upravljanje ovisnostima vaših projekata i verzijama koje su vam potrebne. Kao što je poznato, projekti otvorenog koda aktivno se kreću i često mijenjaju verziju. The paket.json može se konfigurirati za kontrolu ovih vrsta promjena.

The brojevi verzija obično sadrže 3 elementa:

• Glavna verzija kada prekine s prethodnim funkcionalnostima, na primjer: 2.0.0
• Manja verzija s novim značajkama koje ne ruše postojeće, na primjer: 1.1.0
• Zakrpa objavljena s ispravcima grešaka i drugim manjim izmjenama, na primjer 1.0.1

Definirajte verzije paketa

Recimo da se počnete razvijati s određenim verzijama paketa. Možete ih ažurirati i zadržati kompatibilnost tako da navedete raspon prihvaćenih promjena.

 "dependencies": {"Package1": "1.0.0", // prihvaća samo verziju 1.0.0 "container2": "1.0.x", // bilo koja verzija hitnih ispravki u verziji 1.0 "Package3": "*", / / najnovija verzija, "Package4" se ne preporučuje: "> = 1.0.0", // mijenja se nakon 1.0.0 "package5": "= 1.8.0 = 1.1.0 <2.0.0" package8 ":" najnovije " , // naziv oznake posljednje verzije "package9": "", // isto što i * tj. najnovija verzija "packageX": "= 2.3.1 = 2.5.2 <3.0.0"}

BilješkaAko niste sigurni koju verziju upotrijebiti, dodajte * zamjenski znak i pokrenite naredbu npm update -save, što ćemo vidjeti kasnije u ovom vodiču.

Naredba:

 npm update --save

Ažurirajte pakete

Da biste vidjeli sve lokalno instalirane pakete, upotrijebite naredbu ls i dodajte atribut -l za kratak opis. Za pregled globalno instaliranih paketa dodajte atribut -g.

 npm ls -l

Da biste provjerili koji se paket može ažurirati lokalno i globalno, pokrenite sljedeće:

 npm zastarjelo npm zastarjelo -g --depth = 0

Da biste lokalno doveli paket na verziju višu od trenutne, pokrenite sljedeće:

 npm ažuriranje

Da biste to učinili globalno, dodajte -g atribut

Upravljanje predmemorijom

Kad NPM instalira paket, čuva kopiju za sljedeći put kada želite instalirati paket bez potrebe za internetskom vezom. Ove se kopije prema zadanim postavkama pohranjuju u sljedeći direktorij:

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

Ako želite vidjeti u koji se direktorij nalazi NPM predmemorija, samo pokrenite sljedeću naredbenu liniju:

 npm config get cache

Ovaj direktorij obično je ispunjen starim paketima koje više ne koristimo, zato se preporučuje povremeno čišćenje sljedećom naredbenom linijom:

 npm predmemorija čista