Compartilhar via

Instalar ferramentas de cliente do NuGet

Quer instalar um pacote? Veja maneiras de instalar um pacote NuGet.

Para trabalhar com o NuGet como um consumidor ou criador de pacotes, você pode usar ferramentas da CLI (interface de linha de comando) e recursos do NuGet no Visual Studio. Este artigo descreve brevemente os recursos das várias ferramentas. Ele também explica como instalá-los e compara a disponibilidade de recursos entre as ferramentas.

Inícios rápidos do NuGet

Para começar a usar o NuGet para consumir pacotes, consulte os seguintes artigos:

Para começar a criar pacotes NuGet, consulte estes artigos:

Visão geral das ferramentas

Tool Descrição Download
SDK do dotnet A ferramenta da CLI para bibliotecas .NET e .NET Standard e para qualquer projeto no estilo SDK como um que tenha como destino o .NET Framework. Essa ferramenta da CLI está incluída no SDK do .NET e fornece recursos principais do NuGet em todas as plataformas. No Visual Studio 2017 e posterior, a CLI do dotnet é instalada automaticamente com quaisquer cargas de trabalho relacionadas a .NET. .NET SDK
nuget.exe A ferramenta da CLI para bibliotecas do .NET Framework e para qualquer projeto que não seja do tipo SDK, como aqueles destinados a bibliotecas do .NET Standard. Essa ferramenta da CLI fornece todas as capacidades do NuGet no Windows e a maioria dos recursos no macOS e Linux ao executar em Mono. nuget.exe
Visual Studio Um IDE (ambiente de desenvolvimento integrado) completo que inclui o NuGet Gerenciador de Pacotes. Visual Studio fornece a interface do usuário Gerenciador de Pacotes e o console Gerenciador de Pacotes (PowerShell no Windows). Você pode usar essas ferramentas para executar a maioria das operações do NuGet. Visual Studio
Visual Studio Code Um editor de código leve e de software livre para Windows, macOS e Linux que oferece funcionalidades do NuGet por meio de extensões do marketplace. Você também pode usar o SDK do dotnet ou nuget.exe ferramentas da CLI de dentro do Visual Studio Code. Visual Studio Code

Você também pode usar a CLI Microsoft Build Engine (MSBuild) para restaurar e criar pacotes. Mas o MSBuild não é uma ferramenta de uso geral para trabalhar com o NuGet. Essa ferramenta da CLI é útil principalmente em servidores de build.

os comandos do Console Gerenciador de Pacotes funcionam somente em Visual Studio em Windows e não funcionam em outros ambientes do PowerShell.

Política de suporte

Para obter a política de suporte do Visual Studio para Windows, consulte Ciclo de vida e manutenção do produto do Visual Studio.

A versão mais recente de nuget.exe é totalmente suportada e pode ser confiável para correções de bugs, atualizações e aprimoramentos. Para obter mais informações sobre a nuget.exe política de suporte, consulte Política de Ciclo de Vida Moderna.

Para obter a política de suporte do SDK .NET, consulte .NET e .NET Core Support Policy.

Atualizações de patch

As versões corrigidas do nuget.exe são lançadas exclusivamente quando são necessárias correções de segurança críticas para uma versão lts (suporte de longo prazo) do Visual Studio ou do SDK do .NET.

Todos os bugs de segurança devem ser relatados ao MICROSOFT SECURITY RESPONSE CENTER (MSRC) na página de relatório MSRC. Para obter informações detalhadas sobre como relatar problemas de segurança, consulte a política de segurança no repositório NuGet.Client.

NuGet.exe retirada da listagem

Versões sem suporte, preteridas ou vulneráveis nuget.exe são removidas do tools.json ponto de extremidade.

Visual Studio

No Visual Studio 2017 e posterior, o instalador de Visual Studio inclui o Gerenciador de Pacotes NuGet com qualquer carga de trabalho que emprega .NET.

Você também pode instalar o Gerenciador de Pacotes separadamente ou verificar sua instalação. Execute o instalador Visual Studio e verifique a configuração de opção em Individual components>Code tools>NuGet package manager. Para obter mais informações, consulte Instalar e gerenciar pacotes em Visual Studio usando o Gerenciador de Pacotes.

Ferramentas da CLI

Você pode usar a CLI do dotnet ou a CLI do nuget.exe para dar suporte aos recursos do NuGet no Visual Studio IDE. A CLI do dotnet é instalada com algumas cargas de trabalho Visual Studio, como .NET. A nuget.exe CLI deve ser instalada separadamente, conforme descrito anteriormente. Para obter uma comparação de recursos das ferramentas, consulte a seção Disponibilidade de recursos .

  • Para direcionar .NET ou .NET Standard, use a ferramenta da CLI do dotnet SDK. Essa CLI é necessária para o formato de projeto no estilo SDK, que usa o SDK atributo.

  • Para direcionar o .NET Framework (apenas projetos que não sejam do estilo SDK), use a ferramenta nuget.exe CLI. Se o projeto for migrado do packages.config formato para PackageReference. Em vez disso, use a ferramenta da CLI do SDK do dotnet.

SDK do dotnet

O SDK do dotnet é a ferramenta da CLI .NET. Ele funciona em todas as plataformas (Windows, macOS e Linux) e fornece recursos principais do NuGet, como instalação, restauração e publicação de pacotes. A CLI do dotnet fornece integração direta com arquivos de projeto .NET, como arquivos .csproj, o que é útil na maioria dos cenários. Essa CLI também é criada diretamente para cada plataforma e não requer a instalação do Mono.

Instalar o SDK do dotnet

Para descobrir como usar comandos básicos com a ferramenta da CLI do SDK do dotnet, consulte Instalar e gerenciar pacotes NuGet com a CLI do dotnet.

CLI do nuget.exe

A CLI do NuGet, nuget.exe, é o utilitário de linha de comando para Windows que fornece todos os recursos do NuGet. Essa CLI também pode ser executada no macOS e no Linux usando o Mono com algumas limitações.

Para descobrir como usar comandos básicos com a nuget.exe ferramenta CLI, consulte Gerenciar pacotes NuGet com a CLI nuget.exe.

Instalar nuget.exe

Sempre instale a versão mais recente da ferramenta que dá suporte à sua configuração.

Se a nuget.exe ferramenta da CLI já estiver instalada, você poderá atualizar a ferramenta para a versão mais recente usando o comando nuget update -self.

  1. Baixar nuget.exe:

  2. Quando solicitado, salve o arquivo em uma pasta de sua escolha. O arquivo nuget.exe é baixado diretamente. O arquivo baixado não é um instalador, portanto, não é necessário executar o arquivo diretamente do navegador.

  3. Para usar a ferramenta da CLI de qualquer pasta, adicione a pasta que contém o arquivo nuget.exe à variável de PATH ambiente.

Disponibilidade de funcionalidades

A tabela a seguir compara os recursos disponíveis para a CLI do dotnet, nuget.exe CLI e ferramentas do Visual Studio para plataformas com suporte.

Característica CLI do dotnet CLI do NuGet (Windows) CLI do NuGet (Mono) Visual Studio
Pesquisar pacotes ✔ ✔ ✔ ✔
Instalar ou desinstalar pacotes ✔ ✔ (1) ✔ ✔
Pacotes de atualização ✔ ✔ ✔
Restaurar pacotes ✔ ✔ ✔ (2) ✔
Gerenciar repositórios de pacotes (fontes) ✔ ✔ ✔ ✔
Gerenciar pacotes em um feed ✔ ✔ ✔
Definir chaves de API para feeds ✔ ✔
Criar pacotes (3) ✔ ✔ ✔ (4) ✔
Publicar pacotes ✔ ✔ ✔ ✔
Replicar pacotes ✔ ✔
Gerenciar pacotes globais e pastas de cache ✔ ✔ ✔
Gerenciar a configuração do NuGet ✔ ✔ ✔

Notas sobre o recurso:

  • (1) O uso desse recurso não afeta os arquivos de projeto. Em vez disso, use a ferramenta CLI do SDK do Dotnet.
  • (2) Esse recurso funciona apenas com arquivos packages.config e não com arquivos de solução (.sln ou .slnx).
  • (3) Vários recursos de pacote avançados estão disponíveis apenas por meio da CLI, pois eles não são representados nas ferramentas de interface do usuário do Visual Studio.
  • (4) Esse recurso funciona com arquivos .nuspec , mas não com arquivos de projeto.

Funcionalidades futuras

Se você quiser visualizar os próximos recursos do NuGet, instale a versão Insiders Channel do Visual Studio, que funciona lado a lado com versões estáveis de Visual Studio. Para relatar problemas ou compartilhar ideias para visualizações, abra um problema no NuGet GitHub repositório.

Conteúdo relacionado

Os desenvolvedores que trabalham em Windows também podem explorar o NuGet Package Explorer. Este aplicativo é uma ferramenta autônoma de software livre que você pode usar para explorar visualmente, criar e editar pacotes NuGet. É útil para muitos cenários, como fazer alterações experimentais em uma estrutura de pacotes sem recriar o pacote.

  • Last updated on