Instalar ferramentas de cliente do NuGet

  • Artigo

Deseja instalar um pacote? Confira Maneiras de instalar pacotes do NuGet.

Para trabalhar com o NuGet, como um consumidor ou criador de pacotes, você pode usar ferramentas de CLI (interface de linha de comando), bem como os recursos do NuGet no Visual Studio. Este artigo descreve brevemente os recursos das várias ferramentas, como instalá-las e uma comparação da disponibilidade de recursos.

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

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

Ferramenta Descrição Download
SDK do dotnet Ferramenta de CLI para bibliotecas .NET Core e .NET Standard e qualquer projeto no estilo SDK, como aquele direcionado ao .NET Framework. A ferramenta de CLI está incluída com o SDK do .NET Core e fornece os principais recursos do NuGet em todas as plataformas. No Visual Studio 2017 e posterior, a CLI do dotnet é instalada automaticamente com qualquer carga de trabalho relacionada ao .NET Core. SDK do .NET Core
nuget.exe Ferramenta de CLI para bibliotecas .NET Framework e para qualquer projeto de estilo não SDK, como um que tenha como destino bibliotecas .NET Standard. Essa ferramenta de CLI fornece todas as funcionalidades do NuGet no Windows e também a maioria dos recursos no Mac e Linux durante a execução no Mono. nuget.exe
Visual Studio No Windows, o Gerenciador de Pacotes do NuGet está incluído com o Visual Studio 2012 e posteriores. O Visual Studio fornece a Interface do usuário do Gerenciador de Pacotes e o Console do Gerenciador de Pacotes (PowerShell no Windows). Você pode usar essas ferramentas para executar a maioria das operações do NuGet. Visual Studio
Visual Studio para Mac No Mac, certos recursos do NuGet são incorporados diretamente. O Console do Gerenciador de Pacotes não está disponível no momento. Para outros recursos, use as ferramentas de CLI do nuget.exe ou o SDK do dotnet. Visual Studio para Mac
Visual Studio Code No Windows, Mac e Linux, os recursos do NuGet estão disponíveis por meio de extensões do marketplace ou usam as ferramentas SDK do dotnet ou CLI do nuget.exe. Visual Studio Code

Observação

O Visual Studio para Mac está programado para ser desativado em 31 de agosto de 2024, de acordo com a Política de ciclo de vida moderna da Microsoft. Confira O que está acontecendo com o Visual Studio para Mac? para obter mais informações.

A CLI do MSBuild também restaura e cria pacotes. O MSBuild não é uma ferramenta para uso geral para trabalhar com o NuGet. Essa ferramenta da CLI é útil principalmente em servidores de build.

Os comandos do Console do Gerenciador de Pacotes funcionam apenas dentro do Visual Studio no Windows e não em outros ambientes de PowerShell.

Diretiva de suporte

A política de suporte do Visual Studio para Windows pode ser encontrada em Ciclo de Vida e Manutenção do Produto do Visual Studio.

A versão mais recente do NuGet.exe é totalmente compatível e pode ser usada para correções de bugs, atualizações e aprimoramentos. Para obter mais informações sobre a política de suporte do NuGet.exe, consulte a Política Moderna de Ciclo de vida da Microsoft.

A política de suporte do SDK do .NET pode ser encontrada em Política de suporte do .NET e do .NET Core.

Lançamentos de patches

As versões com patches do SDK do NuGet.exe serão lançadas exclusivamente quando correções de segurança forem necessárias para uma versão de suporte de longo prazo (LTS) do Visual Studio ou do SDK do .NET.

Todos os bugs de segurança devem ser relatados ao MSRC (Microsoft Security Response Center) na Página de relatórios do MSRC. Além disso, consulte a Política de segurança no repositório NuGet.Client.

Exclusão do NuGet.exe da lista

As versões de NuGet.exe que não tem mais suporte, foram preteridas ou são vulneráveis serão removidas do tools.json.

Visual Studio

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

Você também pode instalar o Gerenciador de Pacotes separadamente ou verificar sua instalação. Execute o instalador do Visual Studio e marque a configuração da opção em Componentes Individuais > Ferramentas de código > Gerenciador de pacotes do NuGet. Para obter mais informações, confira Instalar e gerenciar pacotes no Visual Studio usando o Gerenciador de Pacotes do NuGet.

Observação

Para versões anteriores do Visual Studio, você pode fazer download de extensões do NuGet em https://dist.nuget.org/index.html.

Ferramentas da CLI

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

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

  • Para definir o .NET Framework como destino (somente projeto no estilo não SDK), use ferramenta de CLI do nuget.exe. Se o projeto for migrado de packages.config para PackageReference, use então a ferramenta de CLI do SDK do dotnet.

SDK do dotnet

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

Instalar o SDK do donet

Para saber como usar comandos básicos com a ferramente de CLI do SDK do dotnet, confira Instalar e gerenciar pacotes do NuGet usando 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. Esta CLI também pode ser executada no Mac OSX e Linux usando o Mono com algumas limitações.

Para saber como usar comandos básicos com a ferramenta de CLI do nuget.exe, confira Gerenciar pacotes do NuGet usando a CLI do nuget.exe.

Instalar o nuget.exe

Sempre instale a versão mais recente da ferramenta que seja compatível com a configuração.

  • Você pode baixar a versão mais recente recomendada em https://dist.nuget.org/win-x86-commandline/latest/nuget.exe.
  • Caso já tenha a ferramenta de CLI do nuget.exe instalada, você poderá atualizar para a versão mais recente com o comando nuget update -self.
  • Para fins de compatibilidade com sistemas mais antigos de integração contínua, uma URL anterior, https://nuget.org/nuget.exe atualmente fornece a versão 2.8.6 preterida na ferramenta da CLI.

  1. Visite nuget.org/downloads e faça o download da versão 3.3 ou posterior do NuGet.

    • Versão 5.0 e posterior requer o .NET Framework versão 4.7.2 ou posterior.
    • A versão 4.1.0 e posterior é necessária para publicar pacotes no nuget.org.
    • A versão 2.8.6 não é compatível com o Mono.

  2. Cada download baixa diretamente o arquivo nuget.exe. Programe o browser para salvar o arquivo na pasta de sua escolha. O arquivo de download não é um instalador, então nada ocorrerá se você executá-lo diretamente no browser.

  3. Para usar a ferramenta de CLI de qualquer local, adicione o local da pasta para o arquivo nuget.exe à sua variável de ambiente PATH.

Disponibilidade de recursos

A tabela a seguir compara os recursos disponíveis para as ferramentas de CLI do nuget.exe e dotnet para plataformas compatíveis.

Recurso CLI do dotnet CLI do nuget (Windows) CLI do nuget (Mono) Visual Studio (Windows) Visual Studio para Mac
Pesquisar pacotes ✔ ✔ ✔ ✔ ✔
Instalar/desinstalar pacotes ✔ ✔ (1) ✔ ✔ ✔
Atualizar pacotes ✔ ✔ ✔ ✔
Restaurar pacotes ✔ ✔ ✔ (2) ✔ ✔
Gerenciar feeds de pacote (origens) ✔ ✔ ✔ ✔ ✔
Gerenciar pacotes em um feed ✔ ✔ ✔
Definir chaves de API para feeds ✔ ✔
Criar pacotes (3) ✔ ✔ ✔ (4) ✔
Publicar pacotes ✔ ✔ ✔ ✔
Replicar pacotes ✔ ✔
Gerenciar global-package e pastas de cache ✔ ✔ ✔
Gerenciar a configuração do NuGet ✔ ✔ ✔

Notas sobre os recursos

  • (1) Não afeta os arquivos do projeto. Em vez disso, use a ferramenta de CLI do SDK do dotnet.
  • (2) Funciona somente com o arquivo packages.config e não com os arquivos de solução (.sln).
  • (3) Vários recursos avançados de pacote são disponibilizados por meio da CLI apenas quando não são representados nas ferramentas de interface do usuário do Visual Studio.
  • (4) Funciona com arquivos .nuspec, mas não com arquivos de projeto.

Recursos futuros

Se você quiser visualizar futuros recursos do NuGet, instale umaVisual Studio Preview, que funciona lado a lado com as versões estáveis do Visual Studio. Para relatar problemas ou compartilhar ideias para versões prévias, abra um problema no repositório GitHub do NuGet.

Os desenvolvedores que trabalham no Windows também podem explorar o Gerenciador de Pacotes do NuGet. Este aplicativo é uma ferramenta autônoma de código aberto que permite explorar, criar e editar pacotes do NuGet visualmente. É útil para muitos cenários, como fazer alterações experimentais em uma estrutura de pacote sem recompilar o pacote.