✅ NPM: Správa balíčků JavaScriptu

Obsah

Použití balíček.json
Instalace závislostí
Definujte verze balíčku
Aktualizujte balíčky
Správa mezipaměti

Úvod NPM

Co je NPM?NPM (Node Package Manager) je správce balíčků pro JavaScript, je to výchozí nastavení pro node.js. Při instalaci uzlu je také nainstalován NPM. A co to znamená? Prostřednictvím NPM můžeme instalovat a spravovat balíčky pro naše aplikace.

Když používáme Node.js, musíme rychle nainstalovat nové moduly (knihovny), protože Node je silně modulární systém a je prakticky prázdný. Pro většinu operací tedy budeme muset nainstalovat další moduly. Tato operace se provádí velmi snadno pomocí nástroje NPM.

Jak nainstalovat Node.js?Chcete -li nainstalovat Node.js, první věc, kterou musíme udělat, je vstoupit na oficiální web:

https://nodejs.org/

A stáhněte si instalační program podle našeho operačního systému.

ZVĚTŠIT

Při stahování instalačního souboru na něj jednoduše dvakrát klikneme a řídíme se pokyny průvodce instalací Node.js.

Po instalaci pro uživatele systému Windows bude konzola node.js přístupná ze spouštěcí lišty, jak ukazuje následující obrázek:

ZVĚTŠIT

Uživatelé počítačů Mac budou muset otevřít terminál svého operačního systému, jak ukazuje následující obrázek:

ZVĚTŠIT

Abychom zkontrolovali, zda je správně nainstalován, spustíme na našem terminálu následující příkaz:

 nedávej

(Windows / Linux / Terminal OS X Console)

Tlačíme Vstupte a zadáme následující řádek:

 Console.log ('Node.js úspěšně nainstalován');

(Windows / Linux / Terminal OS X Console)

Stisknutím Vstupte, ukáže nám zprávu "Node.js úspěšně nainstalován". Chcete -li zobrazit seznam příkazů povolených node.js, zadejte příkaz .Pomoc jak ukazuje následující obrázek:

Chcete -li zobrazit Nainstalovaná verze NPM, provedeme následující příkaz:

 npm -v

Výsledkem bude následující:

Správce balíčků
The Správce balíčků NPM, se trochu liší od ostatních správců balíků, které možná známe, protože je instaluje lokálně do projektů. To znamená, že když je modul stažen, je přidán do místního projektu, což je ten, který jej bude mít k dispozici k zahrnutí. I když existuje také možnost instalace balíčků globálně do našeho systému.

Zahájení nového projektu

Když spustíme nový projekt pomocí node.js, je nutné vytvořit soubor s názvem package.json. Toto je druh manifestu, který zase obsahuje seznam všech závislostí, které váš projekt použije.

Použití balíček.json

Nejlepší způsob, jak spravovat místně nainstalované balíčky, je vytvořit soubor package.json, což nám umožňuje:

Dokumentujte, jaké balíčky náš projekt používá.
Určete, jakou konkrétní verzi balíčku náš projekt použije.
Umožňuje nám snadno sdílet naše závislosti s ostatními vývojáři.

Požadavky:

Soubor package.json musí mít alespoň:

1. Jméno:

Vše malými písmeny.
Jedno slovo bez mezery.
Pomlčka a podtržítko jsou povoleny.

2. Verze:

Příklad package.json:

 {"Název": "project_package", "Verze": "1.0.0"}

Pokud chcete vygenerovat nový balíček.json, existují 2 způsoby, jak to udělat:

1. Načtěte výchozí balíček.json: Z konzoly spustíme následující příkazový řádek.

 npm init -ano

Výsledkem bude následující:

Chcete -li upravit tuto konfiguraci, jednoduše otevřete soubor vytvořený pomocí textového editoru a upravíme požadované atributy.

2. Vytvořte balíček.json pomocí průvodce: V konzole spustíme následující příkaz.

 npm init

Průvodce se vás zeptá, co chcete přidat ke každému atributu, což má za následek následující:

Instalace závislostí

Na webových stránkách https://www.npmjs.com/ najdete stovky projektů; které jsou umístěny podle různých kritérií (počet stažení, popularita …). Z webové stránky je to nejrychlejší způsob, ale NPM má také vyhledávací parametr pro vyhledávání balíčků. Chcete -li to provést, musíte spustit následující příkazový řádek:

Místní instalace
Jakmile je soubor definován balíček.json, můžete do něj přidat závislosti a přidat seznam všeho, co potřebujete:

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

Což by mělo být následující:

Nainstalujte balíčky uvedené v souboru package.jsonChcete -li nainstalovat balíčky uvedené v souboru package.json a jejich závislosti, musíte být umístěni v adresáři, kde je umístěn uvedený soubor, a spustit následující příkazový řádek:

 npm instalace

Nainstalujte balíčkyMůžete také nainstalujte nové balíčky a uložte je z terminálu, provedením následujícího:

 npm install --save new_package_name

Odinstalujte balíčkyOdinstalujte balíček a odstranit z balíček.json:

 npm uninstall -uložte název_balíku

Nainstalujte balíček přímo z úložiště Git

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

Nainstalujte si konkrétní verzi balíčku

 npm install [email protected]

Je důležité si uvědomit, že tato metoda místní instalace znamená, že vaše soubory budou uloženy a dostupné pouze v adresáři projektu.

Globální instalace
Další způsob instalace balíčků je provést to globálně. To se běžně používá pro balíčky, které poskytují funkce mimo jiné z příkazového řádku, například grunt, bower, yeoman.

Vezměte si například Balíček JSHint, což je analyzátor kódu JavaScript, který nám umožňuje ukázat body, ve kterých váš kód nevyhovuje určitým zavedeným pravidlům „čistého kódu“. Chcete -li jej nainstalovat globálně, spustíme soubor instalační příkaz přidání -g atribut a s oprávnění root (pro uživatele Mac a Linux).

 sudo npm install -g jshint

 npm install -g jshint

Chcete -li potvrdit jeho instalaci, stačí spustit jeho příkaz a vyhodnotit chyby v souboru JavaScript. Jelikož naše instalace byla globální, můžeme z jakéhokoli místa spustit Jshint, což ukazuje cestu, kde se nachází náš soubor JavaScript. Příklad:

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

Výsledkem je chyba v našem souboru JavaScript.

Chcete -li znát složku, ve které jsou uloženy všechny tyto knihovny s globálním rozsahem, můžeme použít předponový příkaz a od značky globální -g, jak následuje:

 předpona npm -g

V terminálu OS X poskytne následující výsledek:

V C.Windows ommand prompt zobrazí se cesta, která má jako jedinou proměnnou název složky uživatele, který instalaci provedl. V tomto případě by to bylo "Zhock":

V systému Windows nemá NodeJS předchozí složku definovanou jako globální pro zahrnutí svých knihoven prostřednictvím požadavku. Pokud se tedy pokusíme zahrnout globální knihovnu, zobrazí se chyba „Chyba: Nelze najít modul“.

Abychom to vyřešili, budeme muset definovat systémovou proměnnou NODE_PATH, která jí dá hodnotu globální cesty NPM a na konec přidá složku \ node_modules \.

Jak vidíme, ve Windows 7 je globální instalační cesta NPM:

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

Takže hodnota NODE_PATH bude:

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

Nebo co je stejné:

 % APPDATA% \ npm \ node_modules \

ZVĚTŠIT

Správa závislostí
NPM vám umožňuje spravovat závislosti vašich projektů a verzí, které potřebujete. Jak je známo, open source projekty se aktivně přesouvají a často mění verzi. The balíček.json lze jej nakonfigurovat tak, aby řídil tyto typy změn.

The čísla verzí obvykle obsahují 3 prvky:

Hlavní verze, když se rozbije s předchozími funkcemi, například: 2.0.0
Drobná verze s novými funkcemi, které neporušují ty stávající, například: 1.1.0
Oprava vydaná s opravami chyb a dalšími drobnými změnami, například 1.0.1

Definujte verze balíčku

Řekněme, že začnete vyvíjet s určitými verzemi balíčků. Můžete je aktualizovat a zachovat kompatibilitu zadáním rozsahu přijatých změn.

 "dependencies": {"Package1": "1.0.0", // akceptuje pouze verzi 1.0.0 "container2": "1.0.x", // jakoukoli verzi opravy hotfix ve verzi 1.0 "Package3": "*", / / nejnovější verze, "Package4" se nedoporučuje: "> = 1.0.0", // změny po 1.0.0 "package5": "= 1.8.0 = 1.1.0 <2.0.0" package8 ":" nejnovější " , // název nejnovější verze značky "package9": "", // stejný jako * tj. nejnovější verze "packageX": "= 2.3.1 = 2.5.2 <3.0.0"}

PoznámkaPokud si nejste jisti, kterou verzi použít, přidejte zástupný znak * a spusťte příkaz npm update -save, který uvidíme později v tomto kurzu.

Příkaz:

 aktualizace npm -uložit

Aktualizujte balíčky

Chcete -li zobrazit všechny místně nainstalované balíčky, použijte příkaz ls a přidejte atribut -l pro krátký popis. Chcete -li zobrazit globálně nainstalované balíčky, přidejte atribut -g.

 npm ls -l

Chcete -li zkontrolovat, který balíček lze aktualizovat lokálně a globálně, spusťte následující:

 npm zastaralé npm zastaralé -g -hloubka = 0

Chcete -li lokálně přenést balíček na verzi vyšší než aktuální, spusťte následující:

 aktualizace npm

Chcete -li to provést globálně, přidejte -g atribut

Správa mezipaměti

Když NPM nainstaluje balíček, ponechá si kopii pro příště, kdy chcete balíček nainstalovat, aniž by bylo nutné připojení k internetu. Tyto kopie jsou ve výchozím nastavení uloženy v následujícím adresáři:

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

Pokud chcete zjistit, ve kterém adresáři je mezipaměť NPM uložena, spusťte následující příkazový řádek:

 npm config získat mezipaměť

Tento adresář je obvykle naplněn starými balíčky, které již nepoužíváme, a proto se doporučuje pravidelné čištění pomocí následujícího příkazového řádku: