Partilhar via

Instalar ferramentas de cliente NuGet

Está a pensar instalar um pacote? Veja Formas de instalar um pacote NuGet.

Para trabalhar com o NuGet como consumidor ou criador de pacotes, pode usar ferramentas de interface de linha de comandos (CLI) e funcionalidades do NuGet no Visual Studio. Este artigo descreve brevemente as capacidades das várias ferramentas. Também explica como instalá-las e compara a disponibilidade de funcionalidades entre as ferramentas.

Inícios Rápidos do NuGet

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

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

Visão geral das ferramentas

Tool Descrição Download
SDK dotnet A ferramenta CLI para bibliotecas .NET e .NET Standard, e para qualquer projeto SDK como um que tenha como alvo o .NET Framework. Esta ferramenta de CLI está incluída no SDK .NET e fornece funcionalidades essenciais do NuGet em todas as plataformas. No Visual Studio 2017 e posteriores, a CLI dotnet é automaticamente instalada com quaisquer cargas de trabalho relacionadas com .NET. .NET SDK
nuget.exe A ferramenta CLI para bibliotecas .NET Framework e para qualquer projeto de estilo não-SDK, como um que tenha como alvo bibliotecas .NET Standard. Esta ferramenta CLI fornece todas as capacidades NuGet no Windows e a maioria das funções no macOS e Linux quando é executada sob Mono. nuget.exe
Visual Studio Um ambiente de desenvolvimento integrado (IDE) completo que inclui o NuGet Gestor de Pacotes. Visual Studio fornece a interface Gestor de Pacotes UI e a consola Gestor de Pacotes (PowerShell no Windows). Pode usar estas ferramentas para executar a maioria das operações NuGet. Visual Studio
Visual Studio Code Um editor de código leve e open-source para Windows, macOS e Linux que oferece capacidades NuGet através de extensões de marketplace. Também podes usar o SDK dotnet ou as ferramentas de CLI nuget.exe dentro de Visual Studio Code. Visual Studio Code

Também pode usar o Microsoft Build Engine (MSBuild) CLI para restaurar e criar pacotes. Mas o MSBuild não é uma ferramenta de uso geral para trabalhar com NuGet. Esta ferramenta de CLI é principalmente útil em servidores de compilação.

Os comandos do Gestor de Pacotes Console funcionam apenas no Visual Studio no Windows e não funcionam noutros ambientes PowerShell.

Política de suporte

Para a política de suporte do Visual Studio para Windows, veja Ciclo de Vida e Suporte do Produto do Visual Studio.

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

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

Lançamentos de patches

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

Todos os bugs de segurança devem ser reportados ao Centro de Resposta de Segurança da Microsoft (MSRC) na página de relatório MSRC. Para informações detalhadas sobre o relato de problemas de segurança, consulte a política de segurança no repositório NuGet.Client.

NuGet.exe deslistar

Versões fora de suporte, obsoletas ou vulneráveis nuget.exe são removidas do tools.json endpoint.

Visual Studio

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

Também pode instalar o Gestor de Pacotes separadamente ou verificar a sua instalação. Execute o instalador do Visual Studio e verifique a opção em Componentes individuais>Ferramentas de código>Gestor de pacotes NuGet. Para mais informações, consulte Instalar e gerir pacotes em Visual Studio usando o NuGet Gestor de Pacotes.

Ferramentas CLI

Pode usar quer a CLI dotnet quer a CLI nuget.exe para suportar funcionalidades NuGet no Visual Studio IDE. A CLI dotnet é instalada com algumas cargas de trabalho do Visual Studio, como .NET. O nuget.exe CLI deve ser instalado separadamente, conforme descrito anteriormente. Para uma comparação de funcionalidades das ferramentas, consulte a secção Disponibilidade de Funcionalidades .

  • Para direcionar o .NET ou o .NET Standard, use a ferramenta de linha de comandos (CLI) do SDK do .NET. Esta CLI é necessária para o formato de projeto ao estilo SDK, que utiliza o SDK atributo.

  • Para direcionar para o .NET Framework, em apenas projetos que não são do tipo SDK, use a ferramenta CLI nuget.exe. Se o projeto for migrado do formato packages.config para PackageReference, utilize a ferramenta de linha de comandos (CLI) do SDK dotnet.

SDK dotnet

O SDK dotnet é a ferramenta de CLI .NET. Funciona em todas as plataformas (Windows, macOS e Linux) e fornece funcionalidades essenciais do NuGet, como instalar, restaurar e publicar pacotes. A CLI do dotnet proporciona integração direta com ficheiros de projeto .NET, como ficheiros .csproj, o que na maioria dos cenários é útil. Esta CLI também é construída diretamente para cada plataforma e não requer instalação de Mono.

Instalar o SDK dotnet

Para saber como usar comandos básicos com a ferramenta CLI dotnet SDK, consulte Instalar e gerir pacotes NuGet com a CLI dotnet.

nuget.exe CLI

A CLI do NuGet, nuget.exe, é a utilidade de linha de comandos para Windows que fornece todas as capacidades do NuGet. Esta CLI também pode correr em macOS e Linux usando Mono , com algumas limitações.

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

Instalar nuget.exe

Instale sempre a versão mais recente da ferramenta que suporte a sua configuração.

Se a nuget.exe ferramenta CLI já estiver instalada, pode atualizá-la para a versão mais recente usando o comando nuget update -self.

  1. Download nuget.exe:

  2. Quando solicitado, guarde o ficheiro numa pasta à sua escolha. O ficheironuget.exe é descarregado diretamente. O ficheiro descarregado não é um instalador, por isso não há necessidade de correr o ficheiro diretamente do navegador.

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

Disponibilidade de funcionalidades

A tabela seguinte compara as funcionalidades disponíveis para a CLI dotnet, nuget.exe CLI e as ferramentas do Visual Studio para as plataformas suportadas.

Feature dotnet CLI CLI NuGet (Windows) nuget CLI (Mono) Visual Studio
Pesquisar pacotes ✔ ✔ ✔ ✔
Instalar ou desinstalar pacotes ✔ ✔ (1) ✔ ✔
Atualizar pacotes ✔ ✔ ✔
Restaurar pacotes ✔ ✔ ✔ (2) ✔
Gerir fontes de pacotes ✔ ✔ ✔ ✔
Gestão de pacotes num feed ✔ ✔ ✔
Definir chaves API para feeds ✔ ✔
Criar pacotes (3) ✔ ✔ ✔ (4) ✔
Publicar pacotes ✔ ✔ ✔ ✔
Pacotes de replicação ✔ ✔
Gerenciar pacotes globais e pastas de cache ✔ ✔ ✔
Gerir a configuração do NuGet ✔ ✔ ✔

Notas de destaque:

  • (1) O uso desta funcionalidade não afeta os ficheiros do projeto. Antes, utiliza a ferramenta CLI do SDK dotnet.
  • (2) Esta funcionalidade funciona apenas com ficheirospackages.config e não com ficheiros de solução (.sln ou .slnx).
  • (3) Várias funcionalidades avançadas do pacote estão disponíveis apenas através da CLI, porque não estão representadas nas ferramentas de interface do Visual Studio.
  • (4) Esta funcionalidade funciona com ficheiros .nuspec mas não com ficheiros de projeto.

Próximas funcionalidades

Se quiser pré-visualizar as próximas funcionalidades do NuGet, instale a versão Insiders Channel do Visual Studio, que funciona lado a lado com versões estáveis do Visual Studio. Para reportar problemas ou partilhar ideias para pré-visualizações, abra uma edição no repositório GitHub NuGet.

Conteúdo relacionado

Os programadores que trabalham em Windows também podem explorar o NuGet Package Explorer. Esta aplicação é uma ferramenta autónoma de código aberto que pode usar para explorar, criar e editar visualmente pacotes NuGet. É útil em muitos cenários, como fazer alterações experimentais à estrutura de um pacote sem reconstruir o pacote.

  • Last updated on