Skip to content

Suporte ao pnpm

O suporte ao pnpm é atualmente experimental. Para habilitá-lo, certifique-se de que a variável de ambiente VOLTA_FEATURE_PNPM esteja definida como 1. No Windows, você pode adicioná-la às variáveis de ambiente do usuário ou do sistema nas configurações do sistema. No Linux/Mac, você pode definir esse valor em seus scripts de configuração (por exemplo, .bash_profile, .zshrc ou arquivos similares).

Como este suporte é experimental, pode haver alguns problemas não resolvidos. Algumas limitações conhecidas estão listadas abaixo, mas se você encontrar qualquer coisa que não funcione conforme esperado ao usar pnpm com Volta, por favor, abra uma issue em nosso GitHub.

Limitações Conhecidas

Instalação Global

Atualmente, a instalação global (por exemplo, pnpm install -g) não é suportada e resultará em erro.

Migração

Atualmente não há migração automática, então se você instalou pnpm globalmente com Volta anteriormente, você precisará reinstalá-lo manualmente chamando volta install pnpm. Antes de habilitar o suporte e fazer a reinstalação, você pode desinstalar o pacote pnpm anteriormente instalado através de volta uninstall pnpm. Uma vez que você mude para o suporte nativo ao pnpm, devido à falta atual de implementação de desinstalação, você não poderá remover o pacote pnpm isolado antigo chamando o mesmo comando.

Habilitando Suporte ao pnpm

No Unix (Linux/macOS)

Adicione a seguinte linha ao seu arquivo de configuração do shell (.bashrc, .zshrc, etc.):

bash
export VOLTA_FEATURE_PNPM=1

Então recarregue seu shell ou execute:

bash
source ~/.bashrc  # ou seu arquivo de configuração específico

No Windows

  1. Abra o menu Iniciar e pesquise por "variáveis de ambiente"
  2. Clique em "Editar as variáveis de ambiente do sistema"
  3. Na janela Propriedades do Sistema, clique em "Variáveis de Ambiente"
  4. Em "Variáveis do usuário", clique em "Novo"
  5. Digite "VOLTA_FEATURE_PNPM" como nome da variável e "1" como valor
  6. Clique em "OK" para fechar todas as caixas de diálogo

Usando Volta com pnpm

Após habilitar o suporte ao pnpm, você pode:

  1. Instalar pnpm como seu gerenciador de pacotes padrão:
bash
volta install pnpm
  1. Fixar uma versão específica do pnpm em um projeto:
bash
volta pin pnpm@7.14.0
  1. Ver as versões do pnpm instaladas:
bash
volta list pnpm

Solução de Problemas

Se você encontrar problemas com pnpm no Volta:

  1. Verifique se a flag de recurso está configurada corretamente:

    • No Unix: echo $VOLTA_FEATURE_PNPM
    • No Windows: echo %VOLTA_FEATURE_PNPM%
  2. Verifique se o pnpm está instalado corretamente:

    • Execute volta list para ver se pnpm aparece na lista
  3. Para qualquer outro problema, reporte-os no repositório GitHub do Volta.