Introduzione NPM
Cos'è NPM?NPM (Node Package Manager) è un gestore di pacchetti per JavaScript, è l'impostazione predefinita per node.js. Quando si installa il nodo viene installato anche NPM. E questo cosa significa? Bene, tramite NPM possiamo installare e gestire i pacchetti per le nostre applicazioni.
Quando utilizziamo Node.js dobbiamo installare rapidamente nuovi moduli (librerie) poiché Node, essendo un sistema fortemente modulare, arriva praticamente vuoto. Quindi per la maggior parte delle operazioni dovremo installare moduli aggiuntivi. Questa operazione viene eseguita molto facilmente con lo strumento NPM.
Come installare Node.js?Per installare Node.js la prima cosa che dobbiamo fare è entrare nel sito ufficiale:
https://nodejs.org/
E scarica il programma di installazione in base al nostro sistema operativo.
INGRANDIRE
Quando scarichiamo il file di installazione, facciamo semplicemente doppio clic su di esso e seguiamo le istruzioni della procedura guidata di installazione di Node.js.
Una volta installata per gli utenti Windows, la console node.js sarà accessibile dalla barra di avvio, come mostrato nell'immagine seguente:
INGRANDIRE
Gli utenti Mac dovranno aprire il terminale del proprio sistema operativo come mostrato nell'immagine seguente:
INGRANDIRE
Per verificare che sia installato correttamente, eseguiamo il seguente comando nel nostro terminale:
non dare(Windows/Linux/Console OS X terminale)
noi spingiamo accedere e inseriamo la seguente riga:
Console.log ("Node.js installato con successo");(Windows/Linux/Console OS X terminale)
Premendo accedere, ci mostrerà il messaggio "Node.js installato con successo". Per vedere l'elenco dei comandi consentiti da node.js, inseriamo il comando .aiuto come mostrato nella seguente immagine:
Per visualizzare il Versione NPM installata, eseguiamo il seguente comando:
npm -vChe si tradurrà in quanto segue:
Gestore di pacchetti
Il Gestore di pacchetti NPM, è un po' diverso dagli altri gestori di pacchetti che potremmo conoscere, perché li installa localmente nei progetti. Cioè, quando un modulo viene scaricato, viene aggiunto a un progetto locale, che è quello che sarà disponibile per l'inclusione. Anche se c'è anche la possibilità di installare i pacchetti globalmente sul nostro sistema.
Iniziare un nuovo progetto
Quando iniziamo un nuovo progetto utilizzando node.js è necessario creare un file chiamato package.json. Questo è un tipo di manifest che a sua volta contiene l'elenco di tutte le dipendenze che utilizzerà il tuo progetto.
Uso di pacchetto.json
Il modo migliore per gestire i pacchetti installati localmente è creare un file package.json, questo ci permette di:
- Documenta quali pacchetti utilizza il nostro progetto.
- Specifica quale versione specifica del pacchetto utilizzerà il nostro progetto.
- Ci consente di condividere facilmente le nostre dipendenze con altri sviluppatori.
Requisiti:
Un file package.json deve avere almeno:
1. Nome:
- Tutto in minuscolo.
- Una parola senza spazio.
- Sono consentiti trattini e trattini bassi.
2. Versione:
Esempio di pacchetto.json:
{"Nome": "pacchetto_progetto", "Versione": "1.0.0"}Se vuoi generare un nuovo pacchetto.json, ci sono 2 modi per farlo:
1. Carica un package.json predefinito: Dalla console eseguiamo la seguente riga di comando.
npm init --yesChe si tradurrà in quanto segue:
Per modificare questa configurazione, apriamo semplicemente il file creato con un editor di testo e modifichiamo gli attributi desiderati.
2. Crea un package.json con la procedura guidata: Nella console eseguiamo il seguente comando.
npm initLa procedura guidata ti chiederà cosa vuoi aggiungere a ciascun attributo, ottenendo quanto segue:
Installazione delle dipendenze
Dal sito https://www.npmjs.com/ puoi trovare centinaia di progetti; che vengono posizionati secondo criteri diversi (numero di download, popolarità…). Dalla pagina web è il modo più veloce, tuttavia NPM ha anche un parametro di ricerca per cercare i pacchetti. Per fare ciò, è necessario eseguire la seguente riga di comando:
Installazione locale
Una volta definito il file pacchetto.json, puoi aggiungere le dipendenze al suo interno e aggiungere un elenco di tutto ciò di cui hai bisogno:
"dipendenze": {"express": "*", "grunt": "*", "bower": "*"}Che dovrebbe essere il seguente:
Installa i pacchetti elencati in package.jsonPer installare i pacchetti elencati in package.json e le loro dipendenze, devi trovarti nella directory in cui si trova detto file ed eseguire la seguente riga di comando:
installazione npm
Installa i pacchettiPuoi anche installa nuovi pacchetti e salvali dal terminale, eseguendo quanto segue:
npm install --save new_package_name
Disinstalla pacchettiDisinstalla pacchetto e cancellalo da pacchetto.json:
npm uninstall --save nome_pacchetto
Installa il pacchetto direttamente da un repository Git
npm install git: //github.com/blured/mipaquete.git
Installa una versione specifica di un pacchetto
npm install [email protected]
È importante notare che questo metodo di installazione locale significa che i file verranno archiviati e disponibili solo all'interno della directory del progetto.
Installazione globale
Un altro modo per installare i pacchetti è farlo globalmente. Questo è comunemente usato per i pacchetti che forniscono funzionalità dalla riga di comando come grunt, bower, yeoman, tra gli altri.
Prendi ad esempio il Pacchetto JSHint, che è un analizzatore di codice JavaScript che ci consente di mostrare i punti in cui il tuo codice non è conforme a determinate regole stabilite di "codice pulito". Per installarlo globalmente, eseguiamo il comando di installazione aggiungendo il -g attributo e con privilegio di root (per utenti Mac e Linux).
sudo npm install -g jshint
npm install -g jshint
Per confermare la sua installazione, basta eseguire il suo comando per valutare alcuni file JavaScript per errori. Poiché la nostra installazione era globale, da qualsiasi posizione possiamo eseguire Jshint, indicando il percorso in cui si trova il nostro file JavaScript. Esempio:
progetto jshint \ MiApp \ www \ js \ index.jsCon conseguente errore nel nostro file JavaScript.
Per conoscere la cartella in cui sono archiviate tutte queste librerie con ambito globale, possiamo usare il pulsante comando prefisso e dal marcatore globale -g, come segue:
prefisso npm -gIn un terminale OS X darà il seguente risultato:
nel Cprompt dei comandi di Windows viene visualizzato il percorso che ha come unica variabile il nome della cartella dell'utente che ha effettuato l'installazione. In questo caso sarebbe "Zhock":
In Windows, NodeJS non ha la cartella precedente definita come globale per l'inclusione delle sue librerie tramite require. Quindi, se proviamo a includere una libreria globale, otterremo l'errore "Errore: impossibile trovare il modulo".
Per risolverlo dovremo definire la variabile di sistema NODE_PATH, assegnandole il valore del percorso globale di NPM e aggiungendo alla fine la cartella \ node_modules \.
Come possiamo vedere, in Windows 7 il percorso di installazione globale di NPM è:
C:\Utenti\UTENTE\AppData\Roaming\npm\Quindi il valore di NODE_PATH sarà:
C: \ Users \ USER \ AppData \ Roaming \ npm \ node_modules \O qual è lo stesso:
% APPDATA% \ npm \ node_modules \
INGRANDIRE
Gestione delle dipendenze
NPM ti consente di gestire le dipendenze dei tuoi progetti e le versioni di cui hai bisogno. Come è noto, i progetti open source si stanno muovendo attivamente e cambiano frequentemente versione. Il pacchetto.json può essere configurato per controllare questi tipi di modifiche.
Il numeri di versione normalmente contengono 3 elementi:
- Versione principale quando si rompe con le funzionalità precedenti, ad esempio: 2.0.0
- Versione minore con nuove funzionalità che non interrompono quelle esistenti, ad esempio: 1.1.0
- Patch rilasciata con correzioni di bug e altre modifiche minori, ad esempio 1.0.1
Definisci le versioni del pacchetto
Supponiamo che inizi a sviluppare con determinate versioni di pacchetti. Puoi aggiornarli e mantenere comunque la compatibilità specificando l'intervallo di modifiche accettate.
"dependencies": {"Package1": "1.0.0", // accetta solo la versione 1.0.0 "container2": "1.0.x", // qualsiasi versione dell'hotfix nella versione 1.0 "Package3": "* ", / / ultima versione," Package4 "non è consigliato:"> = 1.0.0 ", // cambia dopo 1.0.0" package5 ":" = 1.8.0 = 1.1.0 <2.0.0 "package8": "latest" , // nome del tag dell'ultima versione "package9": "", // uguale a * ovvero l'ultima versione "packageX": "= 2.3.1 = 2.5.2 <3.0.0" }NotaSe non sei sicuro di quale versione utilizzare, aggiungi il carattere jolly * ed esegui il comando npm update -save, che vedremo più avanti in questo tutorial.
Comando:
npm update --save
Aggiorna pacchetti
Per vedere tutti i pacchetti installati localmente, usa il comando ls e aggiungi l'attributo -l per una breve descrizione. Per visualizzare i pacchetti installati globalmente aggiungere l'attributo -g.
npm ls -lPer verificare quale pacchetto può essere aggiornato localmente e globalmente, eseguire quanto segue:
npm obsoleto npm obsoleto -g --profondità = 0Per portare localmente un pacchetto a una versione successiva a quella corrente, eseguire quanto segue:
aggiornamento npmPer farlo a livello globale, aggiungi il -g attributo
Gestione della cache
Quando NPM installa un pacchetto, ne conserva una copia per la prossima volta che si desidera installare il pacchetto senza la necessità di una connessione Internet. Queste copie sono archiviate nella seguente directory per impostazione predefinita:
Posix (Linux, Os X…): ~ / .npm Windows:% AppData% / npm-cacheSe vuoi vedere in quale directory è archiviata la cache NPM, esegui la seguente riga di comando:
npm config ottiene la cacheQuesta directory è solitamente piena di vecchi pacchetti che non usiamo più, ecco perché si consiglia di pulire periodicamente con la seguente riga di comando:
npm cache clean
