comando dotnet
Este artigo aplica-se a: ✔️ SDK .NET Core 3.1 e versões posteriores
dotnet
- O controlador genérico da CLI de .NET.
Para obter informações sobre os comandos disponíveis e o ambiente:
dotnet [--version] [--info] [--list-runtimes] [--list-sdks]
dotnet -h|--help
Para executar um comando (requer a instalação do SDK):
dotnet <COMMAND> [-d|--diagnostics] [-h|--help] [--verbosity <LEVEL>]
[command-options] [arguments]
Para executar uma aplicação:
dotnet [--additionalprobingpath <PATH>] [--additional-deps <PATH>]
[--fx-version <VERSION>] [--roll-forward <SETTING>]
<PATH_TO_APPLICATION> [arguments]
dotnet exec [--additionalprobingpath] [--additional-deps <PATH>]
[--depsfile <PATH>]
[--fx-version <VERSION>] [--roll-forward <SETTING>]
[--runtimeconfig <PATH>]
<PATH_TO_APPLICATION> [arguments]
O dotnet
comando tem duas funções:
Fornece comandos para trabalhar com projetos .NET.
Por exemplo,
dotnet build
cria um projeto. Cada comando define as suas próprias opções e argumentos. Todos os comandos suportam a opção--help
para imprimir documentação breve sobre como utilizar o comando.Executa aplicações .NET.
Especifique o caminho para um ficheiro de aplicação
.dll
para executar a aplicação. Executar a aplicação significa localizar e executar o ponto de entrada, que no caso das aplicações de consola é oMain
método . Por exemplo,dotnet myapp.dll
executa a aplicaçãomyapp
. Veja Implementação de aplicações .NET para saber mais sobre as opções de implementação.
Estão disponíveis diferentes opções para:
- Apresentar informações sobre o ambiente.
- Executar um comando.
- Executar uma aplicação.
As seguintes opções estão disponíveis quando dotnet
são utilizadas por si só, sem especificar um comando ou uma aplicação para executar. Por exemplo, dotnet --info
ou dotnet --version
. Imprime informações sobre o ambiente.
--info
Imprime informações detalhadas sobre uma instalação .NET e o ambiente do computador, como o sistema operativo atual, e consolida SHA da versão .NET.
--version
Imprime a versão do SDK .NET utilizada pelos dotnet
comandos, que podem ser afetados por um ficheiro global.json . Disponível apenas quando o SDK estiver instalado.
--list-runtimes
Imprime uma lista dos runtimes do .NET instalados. Uma versão x86 do SDK lista apenas runtimes x86 e uma versão x64 do SDK lista apenas runtimes x64.
--list-sdks
Imprime uma lista dos SDKs .NET instalados.
-?|-h|--help
Imprime uma lista de comandos disponíveis.
As seguintes opções são para dotnet
com um comando. Por exemplo, dotnet build --help
ou dotnet build --verbosity diagnostic
.
-d|--diagnostics
Ativa a saída de diagnóstico.
-v|--verbosity <LEVEL>
Define o nível de verbosidade do comando. Os valores permitidos são
q[uiet]
,m[inimal]
,n[ormal]
,d[etailed]
ediag[nostic]
. Não suportado em todos os comandos. Veja a página de comandos específica para determinar se esta opção está disponível.-?|-h|--help
Imprime a documentação de um determinado comando. Por exemplo,
dotnet build --help
apresenta ajuda para obuild
comando .command options
Cada comando define opções específicas a esse comando. Veja a página de comandos específica para obter uma lista de opções disponíveis.
As seguintes opções estão disponíveis quando dotnet
executa uma aplicação. Por exemplo, dotnet --roll-forward Major myapp.dll
.
--additionalprobingpath <PATH>
Caminho que contém a política de pesquisa e assemblagens a sondar. Repita a opção para especificar vários caminhos.
--additional-deps <PATH>
Caminho para um ficheiro .deps.json adicional. Um ficheiro deps.json contém uma lista de dependências, dependências de compilação e informações de versão utilizadas para resolver conflitos de assemblagem. Para obter mais informações, veja Runtime Configuration Files on GitHub (Ficheiros de Configuração do Runtime no GitHub).
--roll-forward <SETTING>
Controla a forma como o roll forward é aplicado à aplicação. Pode
SETTING
ser um dos seguintes valores. Se não for especificado,Minor
é a predefinição.-
LatestPatch
- Avançar para a versão de patch mais elevada. Esta ação desativa o roll forward de versões secundárias. -
Minor
- Avançar para a versão secundária mais baixa mais baixa, se a versão secundária pedida estiver em falta. Se a versão secundária pedida estiver presente, será utilizada a política LatestPatch. -
Major
- Avançar para a versão principal mais baixa e para a versão secundária mais baixa, se a versão principal pedida estiver em falta. Se a versão principal pedida estiver presente, será utilizada a política Secundária. -
LatestMinor
- Avançar para a versão secundária mais alta, mesmo que esteja presente a versão secundária pedida. Destina-se a cenários de alojamento de componentes. -
LatestMajor
- Avance para a versão principal e secundária mais elevada, mesmo que esteja presente o major pedido. Destina-se a cenários de alojamento de componentes. -
Disable
- Não avançar. Vincular apenas à versão especificada. Esta política não é recomendada para utilização geral porque desativa a capacidade de avançar para os patches mais recentes. Este valor só é recomendado para testes.
Com exceção de
Disable
, todas as definições utilizarão a versão de patch mais elevada disponível.O comportamento de roll forward também pode ser configurado numa propriedade de ficheiro de projeto, numa propriedade de ficheiro de configuração de runtime e numa variável de ambiente. Para obter mais informações, veja Versão principal do runtime roll forward.
-
--fx-version <VERSION>
Versão do runtime do .NET a utilizar para executar a aplicação.
Esta opção substitui a versão da primeira referência de arquitetura no ficheiro da
.runtimeconfig.json
aplicação. Isto significa que só funciona conforme esperado se existir apenas uma referência de arquitetura. Se a aplicação tiver mais do que uma referência de arquitetura, a utilização desta opção poderá causar erros.
As seguintes opções só estão disponíveis quando dotnet
executa uma aplicação com o exec
comando . Por exemplo, dotnet exec --runtimeconfig myapp.runtimeconfig.json myapp.dll
.
--depsfile <PATH>
Caminho para um ficheiro deps.json . Um ficheiro deps.json é um ficheiro de configuração que contém informações sobre as dependências necessárias para executar a aplicação. Este ficheiro é gerado pelo SDK .NET.
--runtimeconfig <PATH>
Caminho para um ficheiro runtimeconfig.json . Um ficheiro runtimeconfig.json contém definições de tempo de execução e é normalmente denominado <applicationname.runtimeconfig.json>. Para obter mais informações, veja Definições de configuração do runtime do .NET.
Comando | Função |
---|---|
compilação dotnet | Cria uma aplicação .NET. |
dotnet build-server | Interage com servidores iniciados por uma compilação. |
dotnet clean | Saídas de compilação limpas. |
dotnet exec | Executa uma aplicação .NET. |
ajuda dotnet | Mostra documentação mais detalhada online para o comando. |
migrar dotnet | Migra um projeto de Pré-visualização 2 válido para um projeto .NET Core SDK 1.0. |
dotnet msbuild | Fornece acesso à linha de comandos MSBuild. |
dotnet novo | Inicializa um projeto C# ou F# para um determinado modelo. |
pacote dotnet | Cria um pacote NuGet do seu código. |
publicação dotnet | Publica uma aplicação dependente do .NET Framework ou autónoma. |
restauro dotnet | Restaura as dependências de uma determinada aplicação. |
execução dotnet | Executa a aplicação a partir da origem. |
verificação do sdk dotnet | Mostra o estado atualizado das versões SDK e Runtime instaladas. |
dotnet sln | Opções para adicionar, remover e listar projetos num ficheiro de solução. |
loja dotnet | Armazena assemblagens no arquivo de pacotes de runtime. |
teste dotnet | Executa testes com um corredor de teste. |
Comando | Função |
---|---|
dotnet adicionar referência | Adiciona uma referência de projeto. |
referência de lista dotnet | Lista referências de projetos. |
dotnet remove reference | Remove uma referência de projeto. |
Comando | Função |
---|---|
dotnet adicionar pacote | Adiciona um pacote NuGet. |
pacote de remoção do dotnet | Remove um pacote NuGet. |
Comando | Função |
---|---|
dotnet nuget delete | Elimina ou desativa a lista de um pacote do servidor. |
dotnet nuget push | Envia um pacote para o servidor e publica-o. |
dotnet nuget locals | Limpa ou lista os recursos nuGet locais, como a cache de pedidos http, a cache temporária ou a pasta de pacotes globais em todo o computador. |
dotnet nuget adicionar origem | Adiciona uma origem NuGet. |
dotnet nuget disable source | Desativa uma origem NuGet. |
dotnet nuget ativar origem | Ativa uma origem NuGet. |
origem da lista dotnet nuget | Lista todas as origens NuGet configuradas. |
dotnet nuget remove source | Remove uma origem NuGet. |
dotnet nuget update source | Atualizações uma origem NuGet. |
Comando | Função |
---|---|
instalação da carga de trabalho do dotnet | Instala uma carga de trabalho opcional. |
lista de cargas de trabalho dotnet | Lista todas as cargas de trabalho instaladas. |
reparação da carga de trabalho do dotnet | Repara todas as cargas de trabalho instaladas. |
pesquisa de cargas de trabalho dotnet | Listar cargas de trabalho selecionadas ou todas as cargas de trabalho disponíveis. |
desinstalar carga de trabalho dotnet | Desinstala uma carga de trabalho. |
atualização da carga de trabalho dotnet | Reinstala todas as cargas de trabalho instaladas. |
As ferramentas são aplicações de consola instaladas a partir de pacotes NuGet e que são invocadas a partir da linha de comandos. Pode escrever ferramentas por si próprio ou instalar ferramentas escritas por terceiros. As ferramentas também são conhecidas como ferramentas globais, ferramentas de caminho de ferramentas e ferramentas locais. Para obter mais informações, veja Descrição geral das ferramentas .NET.
Comando | Função |
---|---|
instalação da ferramenta dotnet | Instala uma ferramenta no seu computador. |
lista de ferramentas dotnet | Lista todas as ferramentas globais, de caminho de ferramentas ou locais atualmente instaladas no seu computador. |
pesquisa de ferramentas dotnet | Procura NuGet.org ferramentas que tenham o termo de pesquisa especificado no respetivo nome ou metadados. |
desinstalação da ferramenta dotnet | Desinstala uma ferramenta do seu computador. |
atualização da ferramenta dotnet | Atualizações uma ferramenta instalada no seu computador. |
As seguintes ferramentas adicionais estão disponíveis como parte do SDK .NET:
Ferramenta | Função |
---|---|
dev-certs | Cria e gere certificados de desenvolvimento. |
ef | Ferramentas de linha de comandos do Entity Framework Core. |
user-secrets | Gere segredos de utilizadores de desenvolvimento. |
watch | Um observador de ficheiros que reinicia ou recarrega frequentemente uma aplicação quando deteta alterações no código fonte. |
Para obter mais informações sobre cada ferramenta, escreva dotnet <tool-name> --help
.
Criar uma nova aplicação de consola .NET:
dotnet new console
Crie um projeto e as respetivas dependências num determinado diretório:
dotnet build
Executar uma aplicação:
dotnet exec myapp.dll
dotnet myapp.dll
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: