Partilhar via

Visão geral de CLI .NET

Este artigo aplica-se a: ✔️ SDK do .NET Core 3.1 e versões posteriores

A interface de linha de comando (CLI) do .NET é uma cadeia de ferramentas de plataforma cruzada para desenvolver, criar, executar e publicar aplicativos .NET.

A CLI .NET está incluída no SDK do .NET. Para obter mais informações sobre como instalar o SDK do .NET, consulte Instalar o .NET. Depois de instalar o SDK, você pode executar comandos da CLI abrindo um terminal e inserindo os comandos no prompt do terminal.

Estrutura de comando

A estrutura de comandos da CLI consiste no driver ("dotnet"), no comando e, possivelmente, em argumentos e opções de comando. Você vê esse padrão na maioria das operações da CLI, como criar um novo aplicativo de console e executá-lo a partir da linha de comando. Os comandos a seguir mostram quando o aplicativo de console foi executado a partir de um diretório chamado my_app:

dotnet new console
dotnet build --output ./build_output
dotnet ./build_output/my_app.dll

Motorista

O driver é chamado dotnet e tem duas responsabilidades, executando um aplicativo dependente da estrutura ou executando um comando.

Para executar um aplicativo dependente da estrutura, especifique o caminho para o arquivo .dll do aplicativo após o driver sem especificar um comando, por exemplo, dotnet /path/to/my_app.dll. Ao executar o comando a partir da pasta onde reside a DLL do aplicativo, basta executar dotnet my_app.dll. Para obter mais informações, consulte o comando dotnet.

Quando você fornece um comando para o driver, dotnet.exe inicia o processo de execução do comando CLI. Por exemplo:

dotnet build

Primeiro, o driver determina a versão do SDK a ser usada. Se não houver nenhum arquivo global.json , a versão mais recente do SDK disponível será usada. Depois que a versão do SDK é determinada, ele executa o comando.

Comando

O comando executa uma ação. Por exemplo, dotnet build cria código. dotnet publish publica código. Consulte a seção de comandos da CLI para obter uma lista de comandos.

Argumentos

Os argumentos que você passa na linha de comando são os argumentos para o comando invocado ou para as opções especificadas com o comando. Por exemplo, quando você executa dotnet publish my_app.csproj, o my_app.csproj argumento indica o projeto a ser publicado e é passado para o publish comando.

Opções

As opções que você passa na linha de comando são as opções para o comando invocado. Por exemplo, quando executa o dotnet publish --output /build_output, a opção --output e o seu valor fornecido pelo argumento /build_output são passados para o comando publish.

Comandos da CLI

Os seguintes comandos são instalados por padrão:

Comandos básicos

Comandos de modificação do projeto

Comandos NuGet

Comandos de gerenciamento de carga de trabalho

Comandos avançados

Comandos de gerenciamento de ferramentas

Ferramentas são aplicativos de console instalados a partir de pacotes NuGet e invocados a partir do prompt de comando. Você mesmo pode escrever ferramentas ou instalar ferramentas escritas por terceiros. As ferramentas também são conhecidas como ferramentas globais, ferramentas de trajetória e ferramentas locais. Para obter mais informações, consulte Visão Geral das Ferramentas .NET.

Ver também