Supporto pnpm

Il supporto per pnpm è attualmente sperimentale. Per abilitarlo, assicurati che la variabile d'ambiente VOLTA_FEATURE_PNPM sia impostata su 1. Su Windows, puoi aggiungerla alle variabili d'ambiente utente o di sistema nelle impostazioni di sistema. Su Linux/Mac, puoi impostare quel valore negli script di configurazione (ad esempio .bash_profile, .zshrc o file simili).

Poiché questo supporto è sperimentale, potrebbero esserci alcuni problemi irrisolti. Di seguito sono elencate alcune limitazioni note, ma se riscontri qualsiasi cosa che non funziona come previsto quando usi pnpm con Volta, per favore apri un problema sul nostro GitHub.

Limitazioni note

Installazioni globali

Attualmente, le installazioni globali (ad esempio pnpm install -g) non sono supportate e causeranno errori.

Migrazione

Attualmente non c'è una migrazione automatica, quindi se hai precedentemente installato pnpm globalmente con Volta, dovrai reinstallarlo manualmente chiamando volta install pnpm. Prima di abilitare il supporto e fare la reinstallazione, puoi disinstallare il pacchetto pnpm precedentemente installato tramite volta uninstall pnpm. Una volta che passi al supporto nativo pnpm, non potrai rimuovere il vecchio pacchetto pnpm isolato chiamando lo stesso comando a causa della mancanza attuale di implementazione di disinstallazione.

Abilitare il supporto pnpm

Su Unix (Linux/macOS)

Aggiungi la seguente riga al tuo file di configurazione della shell (.bashrc, .zshrc, ecc.):

export VOLTA_FEATURE_PNPM=1

Poi ricarica la tua shell o esegui:

source ~/.bashrc  # o il tuo file di configurazione specifico

Su Windows

1. Apri il menu Start e cerca "variabili d'ambiente"
2. Clicca su "Modifica le variabili d'ambiente di sistema"
3. Nella finestra Proprietà di sistema, clicca su "Variabili d'ambiente"
4. Sotto "Variabili utente", clicca su "Nuovo"
5. Inserisci "VOLTA_FEATURE_PNPM" come nome della variabile e "1" come valore
6. Clicca "OK" per chiudere tutte le finestre di dialogo

Usare Volta con pnpm

Dopo aver abilitato il supporto pnpm, puoi:

1. Installare pnpm come il tuo gestore di pacchetti predefinito:

volta install pnpm

2. Fissare una versione specifica di pnpm in un progetto:

volta pin pnpm@7.14.0

3. Visualizzare le versioni di pnpm installate:

volta list pnpm

Risoluzione dei problemi

Se riscontri problemi con pnpm in Volta:

1. Verifica che il flag della funzionalità sia impostato correttamente:

   • Su Unix: echo $VOLTA_FEATURE_PNPM
   • Su Windows: echo %VOLTA_FEATURE_PNPM%

2. Controlla che pnpm sia installato correttamente:

   • Esegui volta list per vedere se pnpm appare nell'elenco

3. Per qualsiasi altro problema, segnalali sul repository GitHub di Volta.