Compartilhar via

Visão geral da CLI do .NET

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

A CLI (interface de linha de comando) do .NET é uma ferramenta multiplataforma para desenvolvimento, criação, execução e publicação de aplicativos .NET.

A CLI do .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 nas opções e argumentos de comando. Você vê esse padrão na maioria das operações da CLI, como criar um novo aplicativo de console e executá-lo na 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 de framework ou executando um comando.

Para executar um aplicativo dependente de 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 da pasta em que 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 ao driver, dotnet.exe inicia o processo de execução de comando da 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, ela executa o comando.

Comando

O comando executa uma ação. Por exemplo, dotnet build compila 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 você executa dotnet publish --output /build_output, a opção --output e seu valor fornecidos pelo argumento /build_output são passados para o comando publish.

Comandos da CLI

Os comandos a seguir são instalados por padrão:

Comandos básicos

Comandos de modificação do projeto

Comandos do NuGet

Comandos de gerenciamento de carga de trabalho

Comandos avançados

Comandos de gerenciamento de ferramentas

As ferramentas são aplicativos de console instalados a partir de pacotes NuGet e são invocados do prompt de comando. Você pode escrever ferramentas por conta própria ou instalar ferramentas escritas por terceiros. As ferramentas também são conhecidas como ferramentas globais, locais e de percurso. Para obter mais informações, consulte visão geral das ferramentas do .NET.

Consulte também