Come installare e utilizzare il gestore di pacchetti Yarn per Node.js

Introduzione

Yarn è un gestore di pacchetti per Node.js che si concentra sulla velocità, la sicurezza e la coerenza. È stato originariamente creato per affrontare alcuni problemi del popolare gestore di pacchetti NPM. Anche se i due gestori di pacchetti si sono poi convergenti in termini di prestazioni e funzionalità, Yarn rimane popolare, specialmente nel mondo dello sviluppo di React.

Alcune delle caratteristiche uniche di Yarn sono:

• A per-project caching mechanism, that can greatly speed up subsequent installs and builds
• Installazioni coerenti e deterministiche che garantiscono che la struttura delle librerie installate sia sempre la stessa
• Test di checksum di tutti i pacchetti per verificare la loro integrità
• “Spazi di lavoro”, che facilitano l’uso di Yarn in un monorepo (progetti multipli sviluppati in un unico repository di codice sorgente)

In questo tutorial, installerai Yarn globalmente, aggiungerai Yarn a un progetto specifico e imparerai alcuni comandi di base di Yarn.

Installazione e utilizzo del gestore di pacchetti Yarn per Node.js

1. Installa Yarn globalmente
2. Installa Yarn nel tuo progetto
3. Utilizzo di Yarn

Prerequisiti

Prima di installare e utilizzare il gestore di pacchetti Yarn, è necessario avere Node.js installato. Per verificare se hai già Node.js installato, digita il seguente comando nel terminale della tua riga di comando locale:

node -v

Se visualizzi un numero di versione, come v12.16.3 stampato, hai Node.js installato. Se ricevi un errore command not found (o formulazioni simili), installa Node.js prima di continuare.

Per installare Node.js, segui il nostro tutorial per Ubuntu, Debian, CentOS, o macOS.

Una volta installato Node.js, procedi con il Passaggio 1 per installare il gestore di pacchetti Yarn.

Passaggio 1 — Installazione di Yarn Globalmente

Yarn ha un modo unico di installarsi ed eseguirsi nei tuoi progetti JavaScript. Prima, installi il comando yarn globalmente, poi usi il comando globale yarn per installare una specifica versione locale di Yarn nella directory del tuo progetto. Questo è necessario per garantire che tutti coloro che lavorano su un progetto (e tutti gli strumenti di test automatici e di distribuzione del progetto) eseguano la stessa versione di yarn, per evitare comportamenti e risultati inconsistente.I manutentori di Yarn raccomandano di installare Yarn globalmente utilizzando il gestore di pacchetti NPM, che è incluso di default in tutte le installazioni di Node.js. Usa il flag -g con npm install per fare questo:

I progettisti di Yarn raccomandano di installare Yarn a livello globale utilizzando il gestore di pacchetti NPM, che è incluso di default in tutte le installazioni di Node.js. Usa la bandiera -g con npm install per fare questo:

sudo npm install -g yarn

Dopo l’installazione del pacchetto, fai in modo che il comando yarn stampi il proprio numero di versione. Questo ti permetterà di verificare che sia stato installato correttamente:

yarn --version

Output
1.22.11

Ora che hai installato il comando yarn a livello globale, puoi usarlo per installare Yarn in un progetto JavaScript specifico.

Passo 2 – Installazione di Yarn nel tuo progetto

Puoi saltare questo passaggio se stai utilizzando Yarn per lavorare su un progetto esistente basato su Yarn. Il progetto dovrebbe già essere configurato con una versione locale di Yarn e tutti i file di configurazione necessari per utilizzarlo.

Se stai configurando un nuovo progetto da solo, vorrai configurare una versione specifica del progetto di Yarn ora.

Per prima cosa, naviga nella directory del tuo progetto:

cd ~/my-project

Se non hai una directory del progetto, puoi crearne una nuova con mkdir e poi spostarti dentro:

mkdir my-project
cd my-project

Ora usa il comando yarn set per impostare la versione su berry:

yarn set version berry

Questo scaricherà la versione attualmente in sviluppo attivo di Yarn – berry – la salverà in una directory .yarn/releases/ nel tuo progetto e configurerà anche un file di configurazione .yarnrc.yml:

Output
Resolving berry to a url...
Downloading https://github.com/yarnpkg/berry/raw/master/packages/berry-cli/bin/berry.js...
Saving it into /home/sammy/my-project/.yarn/releases/yarn-berry.cjs...
Updating /home/sammy/my-project/.yarnrc.yml...
Done!

Ora prova di nuovo il comando yarn --version:

yarn --version

Output
3.0.0

Vedrai che la versione è 3.0.0 o superiore. Questa è l’ultima release di Yarn.

Il tuo progetto è ora configurato con una versione specifica di Yarn per il progetto. Successivamente, esamineremo alcuni comandi yarn comunemente utilizzati per iniziare.

Utilizzo di Yarn

Yarn ha molti sottocomandi, ma ne hai bisogno solo di pochi per iniziare. Diamo un’occhiata ai primi sottocomandi che vorrai utilizzare.

Ottenere Aiuto

Quando si inizia con uno strumento nuovo, è utile imparare come accedere alla sua guida online. In Yarn, la bandiera --help può essere aggiunta a qualsiasi comando per ottenere maggiori informazioni:

yarn --help

Questo stamperà l’aiuto generale per il comando yarn. Per ottenere informazioni più specifiche su un sottocomando, aggiungi --help dopo il sottocomando:

yarn install --help

Questo stamperà dettagli su come utilizzare il comando yarn install.

Iniziare un Nuovo Progetto con Yarn

Se stai iniziando un progetto da zero, usa il sottocomando init per creare i file specifici di Yarn di cui avrai bisogno:

yarn init

Questo aggiungerà un file di configurazione package.json e un file yarn.lock al tuo directory. Il package.json contiene la configurazione e la tua lista di dipendenze di moduli. Il file yarn.lock blocca quelle dipendenze a versioni specifiche, assicurandosi che l’albero delle dipendenze sia sempre coerente.

Installazione di tutte le Dipendenze di un Progetto

Per scaricare e installare tutte le dipendenze in un progetto basato su Yarn esistente, usa il sottocomando install:

yarn install

Questo scaricherà e installerà i moduli di cui hai bisogno per iniziare.

Aggiunta di una Dipendenza Nuova a un Progetto

Usa il sottocomando add per aggiungere nuove dipendenze a un progetto:

yarn add package-name

Questo scaricherà il modulo, lo installerà e aggiornerai i tuoi file package.json e yarn.lock.

Aggiornamento del tuo File .gitignore per Yarn

Yarn archivia i file in una cartella .yarn all’interno della directory del tuo progetto. Alcuni di questi file dovrebbero essere controllati nel controllo della versione e altri dovrebbero essere ignorati. La configurazione di base di .gitignore per Yarn segue:

.yarn/*
!.yarn/patches
!.yarn/releases
!.yarn/plugins
!.yarn/sdks
!.yarn/versions
.pnp.*

Questo ignora l’intera directory .yarn e poi aggiunge alcune eccezioni per le cartelle importanti, incluso il directory releases che contiene la versione specifica del tuo progetto di Yarn.

Per ulteriori dettagli su come configurare Git e Yarn, si prega di fare riferimento a la documentazione ufficiale di Yarn su .gitignore.

Conclusione

In questo tutorial, hai installato Yarn e hai imparato a conoscere alcuni sottocomandi yarn. Per ulteriori informazioni sull’uso di Yarn, dai un’occhiata alla documentazione ufficiale della CLI di Yarn.

Per aiuto più generale su Node.js e JavaScript, visita le nostre pagine tag Node.js e JavaScript, dove troverai tutorial pertinenti, tech talks e Q&A della community.