npm Tutorial
Iniziare con npm
Ricerca…
Osservazioni
npm è il gestore di pacchetti predefinito per Node.js. È scritto interamente in JavaScript e consente di installare e distribuire principalmente moduli JavaScript nel registro. I pacchetti sono trattati nel formato CommonJS e sono riconoscibili dalla presenza di un file package.json
.
Versioni
Versione | Data di rilascio |
---|---|
v4.0.0 | 2016/10/21 |
v3.10.0 | 2016/06/17 |
v3.9.0 | 2016/05/06 |
v2.15.0 | 2016/03/11 |
v3.8.0 | 2016/02/26 |
v3.7.0 | 2016/01/29 |
v3.6.0 | 2016/01/21 |
v3.5.0 | 2015/11/20 |
v3.4.0 | 2015/11/06 |
v3.3.0 | 2015/08/14 |
v2.14.0 | 2015/08/14 |
v3.2.0 | 2015/07/25 |
V3.1.0 | 2015/07/03 |
v2.13.0 | 2015/07/03 |
v3.0.0 | 2015/06/26 |
v2.12.0 | 2015/06/19 |
V2.11.0 | 2015/05/22 |
v2.10.0 | 2015/05/08 |
v2.9.0 | 2015/04/24 |
V2.8.0 | 2015/04/10 |
v2.7.0 | 2015/02/27 |
V2.6.0 | 2015/02/13 |
v2.5.0 | 2015/01/30 |
v2.4.0 | 2015/01/23 |
v2.3.0 | 2015/01/16 |
v2.2.0 | 2015/01/09 |
v2.1.0 | 2014/09/26 |
v2.0.0 | 2014/09/13 |
v1.4.0 | 2014/02/13 |
Installazione o configurazione
Installare
npm
è in bundle con Node.js , quindi se installi Node.js avrai automaticamente anche npm
installato. È possibile scegliere tra una versione corrente e una versione LTS
finestre
Per Microsoft Windows è possibile scaricare un programma di installazione MSI da https://nodejs.org/en/download/ .
OS X
Per Apple OS X è possibile scaricare un programma di installazione PKG dalla stessa posizione https://nodejs.org/en/download/ .
Linux
Per Linux è possibile utilizzare il gestore pacchetti per installare Node.js e npm.
Puoi anche compilare Node.js dal sorgente e otterrai comunque npm
. C'è anche uno script che puoi eseguire che installerà npm
:
curl -L https://www.npmjs.com/install.sh | sh
Aggiorna npm alla versione più recente
Il metodo consigliato per aggiornare l'installazione di npm
consiste semplicemente nell'installare npm
solo:
npm install -g npm@latest
In alternativa puoi aggiornare alla versione LTS corrente piuttosto che alla versione più recente:
npm install -g npm@lts
Puoi anche installare qualsiasi versione di Node (e npm) con nvm
. Quando si installa globalmente con npm
con un'installazione di nvm
, non è necessario usare sudo
(o Esegui come amministratore su Windows).
Installa i pacchetti
Si noti che è possibile installare pacchetti. Questo comando installa la versione più recente disponibile dei pacchetti denominati:
sia a livello locale che globale.
L'installazione locale significa che npm installa il pacchetto nella directory di lavoro corrente. I moduli del nodo entrano in ./node_modules
, gli eseguibili vanno in ./node_modules/.bin/
. Di solito ti consigliamo di installare i moduli locali per l'utilizzo all'interno del tuo programma, come dipendenza, e funzioneranno solo su dove sono installati.
npm install <package names>
Abbreviazione:
npm i <package names>
npm
può interagire con un file package.json
nella directory corrente in vari modi utili, attraverso le dependencies
degli oggetti e devDependencies
memorizzati in package.json
(installando più moduli):
Il comando di npm install
senza parametri
npm install
installa tutti i pacchetti denominati come chiavi oggetto nelle dependencies
e devDependencies
oggetti devDependencies
in package.json
, utilizzando le restrizioni di controllo delle versioni semantiche come indicato dai valori dell'oggetto.
Quando si sviluppa un nuovo software:
Utilizzare l'opzione -S
per aggiungere i <package names>
e le versioni dei moduli npm che si stanno installando che devono essere sempre inclusi nel modulo. Aggiunge l'elenco delle dependencies
rilevate nel file package.json
, dopo l'installazione.
npm i <package names> -S
Utilizzare l'opzione -D
per aggiungere i <package names>
e le versioni dei moduli npm che si stanno installando necessari ad altri sviluppatori per sviluppare ulteriormente o testare il modulo. Aggiunge all'elenco delle devDependencies
tracciate nel file package.json
, dopo l'installazione.
npm i <package names> -D
Dove lodash
e mocha
sono nomi di pacchetti.
Installazione di pacchetti globali
Installa un pacchetto globale
I pacchetti installati globalmente rilasciano i moduli in {prefix}/lib/node_modules
e mettono i file eseguibili in {prefix}/bin
, dove {prefix}
solito è qualcosa di simile a /usr/local
. L'installazione di un modulo globale significa che i suoi binari finiscono nella variabile d'ambiente PATH
. Di solito ti consigliamo di installare un modulo globale se si tratta di uno strumento da riga di comando o qualcosa che vuoi usare nella tua shell.
npm install --global package-name
Rimuovi un pacchetto globale
npm uninstall --global package-name
Nota: l'argomento --global
può essere semplificato a -g
. Quindi, ad esempio, il primo comando potrebbe essere npm install -g package-name
, con lo stesso risultato esatto.
Nota: nei sistemi * nix, l'installazione di pacchetti globali può richiedere permessi per superutente. In caso EACCES
fallirà con: EACCES
. In tal caso, esegui:
sudo npm install --global package-name
Aggiornamento dei pacchetti
In ogni applicazione, il ciclo di vita arriva in un giorno in cui è necessario aggiornare i componenti. Tutti conoscono il dolore di aggiornare ogni singola dipendenza una per una. Bene, qui devi solo emettere il comando:
npm update (-g)
Se il "-g" è lì allora npm aggiornerà i pacchetti globali.
Usare npm per gestire le dipendenze
Quindi vuoi distribuire la tua app su più siti? e il tuo progetto ha troppe dipendenze per installarli uno per uno? Npm ha una soluzione solo emettere il seguente comando:
npm init
Nella cartella principale del progetto segui le istruzioni sullo schermo (digita il valore desiderato, quindi premi invio) e poi se vuoi salvare una dipendenza, aggiungi:
--save
dopo il tuo
npm install
comandi per esempio:
npm install mypackagename --save
E poi quella dipendenza verrà salvata, quindi non è necessario spostare la cartella "node_modules". Per installare tutti i problemi di dipendenza salvati:
npm install
e verranno installate tutte le dipendenze salvate.