pnpm add <pkg>
Installa un pacchetto e gli eventuali pacchetti da cui dipende. Per impostazione predefinita, qualsiasi nuovo pacchetto è installato come dipendenza di produzione.
TL;DR
Comando | Significato |
---|---|
pnpm add sax | Salva in dependencies |
pnpm add -D sax | Salva in devDependencies |
pnpm add -O sax | Salva in optionalDependencies |
pnpm add -g sax | Installa il pacchetto a livello globale |
pnpm add sax@next | Installa dal tag next |
pnpm add sax@3.0.0 | Specifica la versione 3.0.0 |
Percorsi dei pacchetti supportati
Installazione dal registro npm
pnpm add nome-pacchetto
installerà l'ultima versione di nome-pacchetto
dal registro npm per impostazione predefinita.
Se eseguito in uno spazio di lavoro, il comando cercherà prima di controllare se altri progetti nello spazio di lavoro utilizzano il pacchetto specificato. In caso affermativo, verrà installato l'intervallo di versione già utilizzato.
È inoltre possibile installare pacchetti per:
- tag:
pnpm add express@nightly
- versione:
pnpm add express@1.0.0
- intervallo di versioni:
pnpm add express@2 react@">=0.1.0 <0.2.0"
Installazione dallo spazio di lavoro
Nota che quando si aggiungono dipendenze e si lavora all'interno di uno spazio di lavoro, i pacchetti verranno installati dalle sorgenti configurate, a seconda che sia impostato link-workspace-packages
e dell'uso di spazio di lavoro: protocollo di intervallo
.
Installazione dal file system locale
Ci sono due modi per installare dal file system locale:
- da un file tarball (
.tar
,.tar.gz
, o.tgz
) - da una cartella
Esempi:
pnpm add ./package.tar.gz
pnpm add ./some-directory
Quando esegui l'installazione da una cartella, viene creato un link simbolico nella cartella node_modules
del progetto corrente, quindi è come eseguire pnpm link
.
Installazione da un tarball remoto
L'argomento deve essere un URL recuperabile che inizia con "http://" o "https://".
Esempio:
pnpm add https://github.com/indexzero/forever/tarball/v0.5.6
Installazione da un repository Git
pnpm add <git remote url>
Installa il pacchetto da un provider Git, clonandolo con Git. È possibile specificare un protocollo per alcuni provider Git. Ad esempio, pnpm add github:utente/repo
È possibile installare da Git tramite:
- ultimo commit sul ramo master
pnpm add kevva/is-positive
- commit:
pnpm add kevva/is-positive#97edff6f525f192a3f83cea1944765f769ae2678
- ramo:
pnpm add kevva/is-positive#master
- intervallo di versioni:
pnpm add kevva/is-positive#semver:^2.0.0
You may also install just a subdirectory from a Git-hosted monorepo. Ad esempio:
pnpm add myorg/repo#path:packages/foo
It is possible to combine multiple parameters by separating them with &
. For instance, you can extend the above command by specifying which branch to fetch from:
pnpm add myorg/repo#path:packages/foo&next
Opzioni
--save-prod, -P
Installa i pacchetti specificati come dipendenze normali (dependencies
).
--save-dev, -D
Installa i pacchetti specificati come dipendenze di sviluppo (devDependencies
).
--save-optional, -O
Installa i pacchetti specificati come dipendenze facoltative (optionalDependencies
).
--save-exact, -E
Le dipendenze salvate verranno configurate con una versione esatta invece di usare l'operatore dell'intervallo semver predefinito di pnpm.
--save-peer
L'uso di --save-peer
, aggiungerà uno o più pacchetti a peerDependencies
e li installerà come dev dependencies.
--ignore-workspace-root-check
L'aggiunta di una dipendenza alla radice del workspace fallisce, a meno che non venga utilizzato il flag --ignore-workspace-root-check
o -w
.
Ad esempio, pnpm add debug -w
.
--global, -g
Installa un pacchetto a livello globale.
--workspace
Aggiunge la nuova dipendenza solo se si trova all'interno di un workspace.