Partilhar via

Referência de CLI NuGet

A Interface de Linha de Comando (CLI nuget.exe) do NuGet fornece toda a extensão da funcionalidade NuGet para instalar, criar, publicar e gerir pacotes sem fazer alterações aos ficheiros do projeto.

Para usar qualquer comando, abra uma janela de comandos ou shell bash, depois execute nuget seguido do comando e das opções apropriadas, como nuget help pack (para ver ajuda no comando pack).

Esta documentação reflete a versão mais recente da CLI do NuGet. Para detalhes exatos de qualquer versão que estejas a usar, executa nuget help para o comando desejado.

Para aprender a usar comandos básicos com a nuget.exe CLI, consulte Instalar e usar pacotes usando 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.

Sugestão

Para disponibilizar a CLI NuGet na Gestor de Pacotes Console em Visual Studio, veja Usando a CLI nuget.exe na consola.

Availability

Consulte a disponibilidade de funcionalidades para detalhes exatos.

  • Todos os comandos estão disponíveis no Windows.
  • Todos os comandos funcionam com nuget.exe a correr em Mono, exceto onde indicado para pack, restore, e update.
  • Os packcomandos , restore, delete, locals, e push também estão disponíveis no Mac e Linux através da CLI dotnet.

Comandos e aplicabilidade

Comandos disponíveis e aplicabilidade à criação de pacotes, consumo de pacotes e/ou publicação de um pacote para um host:

Comandos Comuns Papéis Aplicáveis Versão NuGet Descrição
Pacote Creation 2.7+ Cria um pacote NuGet a partir de um .nuspec ficheiro de projeto OR. Ao correr em mono, não é suportado criar um pacote a partir de um ficheiro de projeto.
empurrar Publicação Todos Publica um pacote para uma fonte de pacote.
config Todos Todos Obtém ou define valores de configuração do NuGet.
ajuda ou ? Todos Todos Apresenta informação de ajuda ou ajuda para um comando.
Locais Consumo 3.3+ Lista as localizações das pastas global-packages, http-cache e temp e limpa o conteúdo dessas pastas.
restaurar Consumo 2.7+ Restaura todos os pacotes referenciados pelo formato de gestão de pacotes em uso. Ao correr em Mono, não é suportado restaurar pacotes usando o formato PackageReference.
setapikey Publicação, Consumo Todos Guarda uma chave API para a fonte de um dado pacote quando essa fonte requer uma chave para acesso.
Especificação Creation Todos Gera um ficheiro .nuspec, usando tokens se gerar o ficheiro a partir de um projeto Visual Studio.
Comandos Secundários Papéis Aplicáveis Versão NuGet Descrição
adicionar Publicação 3.3+ Adiciona um pacote a uma fonte de pacote não HTTP usando layout hierárquico. Para fontes HTTP, usa push.
delete Publicação Todos Remove ou deslista um pacote de uma fonte de pacote.
init Creation 3.3+ Adiciona pacotes de uma pasta a um código-fonte de pacote usando layout hierárquico.
instalar Consumo Todos Instala um pacote no projeto atual, mas não modifica projetos nem ficheiros de referência.
list Consumo, talvez Edição Todos Apresenta pacotes de uma determinada fonte.
espelho Publicação Descontinuado na 3.2+ Espelha um pacote e as suas dependências de uma fonte para um repositório alvo.
Pesquisar Consumo 5.8+ Pesquisa numa dada fonte usando a cadeia de consulta fornecida.
Fontes Consumo, Publicação Todos Gerir as fontes de pacotes em ficheiros de configuração.
atualizar Consumo Todos Atualiza os pacotes de um projeto para as versões mais recentes disponíveis. Não é suportado quando está a correr em mono.

Diferentes comandos utilizam várias variáveis de ambiente.

Comandos CLI do NuGet por funções aplicáveis:

Função Comandos
Consumo config, help, , install, list, localsrestore, search, setapikeysources,update
Creation config, help, init, pack, spec
Publicação add, config, deletehelp, , list, push, setapikey,sources

Os programadores preocupados apenas em consumir pacotes, por exemplo, só precisam de compreender esse subconjunto de comandos NuGet.

Observação

Os nomes das opções de comando são indiferentes a maiúsculas e maiúsculas. Opções que estão obsoletas não estão incluídas nesta referência, como NoPrompt (substituído por NonInteractive) e Verbose (substituído por Verbosity).

Localization

O progresso, aviso e mensagens de erro deNuGet.exesão traduzidos para os mesmos locais que Visual Studio. NuGet.exe são distribuídos como um único exe, e devido a considerações de tamanho, apenas as mensagens mais frequentemente apresentadas são traduzidas para todas as línguas.

  • Last updated on