pnpm add <pkg>
Instala um pacote e todos os outros pacotes dos quais ele depende. Por padrão, qualquer novo pacote é instalado como uma dependência de produção.
TL;DR
| Comando | Significado |
|---|---|
pnpm add sax | Salva em dependencies |
pnpm add -D sax | Sava em devDependencies |
pnpm add -O sax | Salva em optionalDependencies |
pnpm add -g sax | Instalar pacote globalmente |
pnpm add sax@next | Instalar a partir da tag next |
pnpm add sax@3.0.0 | Especifica a versão 3.0.0 |
Locais de pacotes suportados
Instala do registro do npm
pnpm add package-name vai instalar a última versão do package-name usando o registro do npm por padrão.
Se for executado de um workspace, o comando verificará se algum outro projeto do workspace utiliza o pacote especificado. Se sim, uma versão já usada será instalada.
Você também pode instalar pacotes por:
- tag:
pnpm add express@nightly - versão:
pnpm add express@1.0.0 - intervalo de versão:
pnpm add express@2 react@">=0.1.0 <0.2.0"
Instalar a partir do workspace
Observe que ao adicionar dependências e usar um workspace, pacotes vão ser instalados a partir das fontes configuradas no workspace, dependendo se link-workspace-packages esta ou não definido e do uso do protocolo de espaço do workspace.
Instalar de um sistema de arquivos local
Existem duas maneiras de instalar pelo sistema de arquivos local:
- usando um arquivo tarball (
.tar,.tar.gz, or.tgz) - de um diretório
Exemplos:
pnpm add ./package.tar.gz
pnpm add ./some-directory
Quando você instala a partir de um diretório, um link simbólico será criado no node_modules do projeto atual. Então é o mesmo que executar pnpm link.
Instalar a partir de um arquivo tarball remoto
O argumento deve começar com um URL buscável começando com "http://" ou "https://".
Exemplo:
pnpm add https://github.com/indexzero/forever/tarball/v0.5.6
Instalar de um repositório Git
pnpm add <git remote url>
Instalar o pacote hospedado em um provedor git, clonando-o com Git. Você pode usar um protocolo para certos provedores Git. Por exemplo, pnpm add github:user/repo
Você pode instalar a partir do Git por:
- ultimo commit na master:
pnpm add kevva/is-positive - commit:
pnpm add kevva/is-positive#97edff6f525f192a3f83cea1944765f769ae2678 - branch:
pnpm add kevva/is-positive#master - intervalo de versão:
pnpm add kevva/is-positive#semver:^2.0.0
You may also install just a subdirectory from a Git-hosted monorepo. Por exemplo:
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
Opções
--save-prod, -P
Instale os pacotes especificados em dependencies como uma dependência comum.
--save-dev, -D
Instale os pacotes especificados em devDependencies como uma dependência de desenvolvimento.
--save-optional, -O
Instala os pacotes especificados em optionalDependencies como dependências opcionais.
--save-exact, -E
Dependências instaladas serão configuradas para usar uma versão exata em vez de usar o intervalo de versões padrão do pnpm.
--save-peer
Usar --save-peer adicionará um ou mais pacotes a peerDependencies e instalará-os como dependências de desenvolvimento.
--ignore-workspace-root-check
Adicionar uma nova dependência ao diretório raiz do workspace falhe, ao menos o --ignore-workspace-root-check ou -w flag seja usado.
Por exemplo, pnpm add debug -W.
--global, -g
Instala um pacote globalmente.
--workspace
Adiciona a nova dependência apenas se ela for encontrada no workspace.