Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Pode usar a interface de linha de comandos (CLI) nuget.exe para gerir pacotes NuGet em projetos e soluções do Visual Studio. Este artigo descreve os comandos mais comuns da CLI do NuGet para gerenciar pacotes NuGet. Todos estes comandos funcionam no Windows, e a maioria funciona no macOS e no Linux com Mono.
A CLI do NuGet corre em .NET Framework e em projetos que não são do tipo SDK, por exemplo, projetos que não são do tipo SDK que visam bibliotecas .NET Standard. Os comandos da CLI do NuGet podem usar um arquivo depackages.config de projeto que lista referências de pacote. Para projetos que não seguem o estilo SDK que usam PackageReference em vez de packages.config para referências de pacote, use o dotnet CLI em vez disso.
Observação
Para a maioria dos projetos que não seguem o estilo SDK e que packages.config, é melhor migrar packages.config para PackageReference, e depois usar a CLI dotnet em vez da CLI NuGet para gerir os pacotes. No entanto, não podes migrar projetos para C++ ou ASP.NET.
Para a maioria dos comandos, a ferramenta CLI do NuGet usa a pasta atual, a menos que especifique uma localização diferente no comando. Para executar comandos CLI NuGet, abra um programa de linha de comandos e mude para a pasta que contém o ficheiro do seu projeto.
Para uma lista completa de comandos e os seus argumentos, consulte a referência do NuGet CLI.
Pré-requisitos
Descarregue a CLI NuGet do nuget.org. Guarde o ficheiro nuget.exe numa pasta adequada e certifique-se de que a pasta está na Variável Ambiente.PATH
Para verificar a versão da sua CLI NuGet, abra um programa de linha de comandos e execute nuget help. Ou, para evitar ter de fazer scroll para cima, use nuget help | more. A primeira linha na saída de ajuda mostra a versão.
Instalar um pacote
O comando CLI install NuGet descarrega e instala pacotes NuGet especificados.
Importante
O install comando não modifica o arquivo de projeto ou packages.config arquivo. Os install comandos e restore apenas adicionam pacotes ao disco, mas não adicionam dependências aos projetos. Para adicionar dependências de projetos, adicione pacotes usando a interface Visual Studio Package Manager UI ou Package Manager Consola. Se depois executar install , ou restoretalvez noutro ambiente, apenas as dependências declaradas são instaladas ou restauradas.
Use a opção -OutputDirectory para instalar pacotes numa pasta específica. Se não especificares uma pasta de saída, install usa a pasta atual.
nuget install <package-ID | configuration-file-path> -OutputDirectory <output-folder>
Por exemplo, para instalar o Newtonsoft.json pacote na subpasta de paquetes , use o seguinte comando:
nuget install Newtonsoft.Json -OutputDirectory packages
Em vez de especificar um pacote a instalar, pode especificar um ficheiro depackages.config existente na pasta atual ou noutra pasta. O install comando instala todos os pacotes listados no arquivo packages.config .
nuget install packages.config
Por exemplo, o comando seguinte instala todos os pacotes listados empackages.config na subpasta de configuração da pasta atual. O comando instala os pacotes na pasta de pacotes .
nuget install config\packages.config -OutputDirectory packages
Instalar uma versão específica de um pacote
O install comando instala a versão mais recente de um pacote, a menos que você especifique uma versão diferente. Para instalar uma versão específica de um pacote, use a -Version opção:
nuget install <package-ID> -Version <version>
Por exemplo, para instalar a versão 12.0.1 do Newtonsoft.json pacote, use:
nuget install Newtonsoft.Json -Version 12.0.1
Listar pacotes
Use o search comando para mostrar informação básica sobre pacotes numa fonte especificada.
nuget search -Source <source>
Por exemplo, para listar pacotes na subpasta de pacotes do MyProject, use o seguinte comando:
nuget search -Source C:\Users\%USERNAME%\source\repos\MyProject\packages
Também pode especificar termos de pesquisa para limitar os resultados por nomes de pacotes, etiquetas ou descrições:
nuget search <search-terms> -Source <source>
Atualizar todos os pacotes
Use o comando update para atualizar todos os pacotes num ficheiro packages.config de projeto para as versões mais recentes disponíveis. Para <configuration-file-path>, use o caminho para o seu ficheiro de packages.config.
nuget update <configuration-file-path>
É melhor executar restore antes de executar update. Depois, o update comando tem informações sobre as versões dos pacotes que estão em uso. Essa informação ajuda a resolver dependências corretamente.
Remover um pacote
Para remover um pacote, podes apagar esse pacote da pasta do projeto. Para reinstalar pacotes, use os restore comandos ou install .
A exclusão de pacotes do disco não atualiza os arquivos de projeto, packages.configou NuGet.Config . A melhor forma de remover pacotes é usando a interface Visual Studio Package Manager UI ou Package Manager Consola.
Restaurar pacotes
O comando NuGet CLI restore descarrega e instala quaisquer pacotes em falta. O comando funciona em projetos que usam quer PackageReference quer packages.config para referências de pacotes.
Por exemplo install, o restore comando só adiciona pacotes ao disco. Não modifica o ficheiro do projeto nem packages.config ficheiro. Para adicionar dependências de projetos, use a interface Visual Studio Package Manager ou a consola.
Para restaurar pacotes, execute o seguinte comando:
nuget restore <project-path>
O restore comando usa um arquivo de solução ou um arquivo package.config no caminho do projeto especificado.
Por exemplo, para restaurar todos os pacotes do MySolution.slnx no diretório atual, execute o seguinte comando:
nuget restore MySolution.slnx
Observação
Para projetos que não são ao estilo SDK e que usam PackageReference, a abordagem recomendada é usar msbuild -t:restore para restaurar pacotes em vez do nuget restore comando. O msbuild -t:restore comando utiliza a mesma lógica de avaliação e resolução do projeto que a compilação, o que ajuda a garantir uma resolução consistente e fiável de dependências.
Para obter mais informações, consulte Restaurar pacotes.