Visão geral da CLI do .NET

Artigo
02/15/2023

Este artigo se aplica ao: ✔️ SDK do .NET Core 2.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 .NET SDK. Para saber como instalar o SDK do .NET, consulte Instalar o .NET Core.

Comandos de CLI

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

Comandos básicos

Comandos de modificação de projeto

Comandos avançados

Comandos de gerenciamento de ferramentas

tool install
tool list
tool update
tool restore Disponível a partir do SDK do .NET Core 3.0.
tool run Disponível a partir do SDK do .NET Core 3.0.
tool uninstall

Ferramentas são aplicativos de console instalados a partir de pacotes NuGet e invocados no 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.

Estrutura de comando

A estrutura de comando CLI consiste no driver ("dotnet"), do comando e possivelmente de opções e argumentos de comando. É possível ver esse padrão na maioria das operações de CLI, como ao criar um novo aplicativo de console e executá-lo a partir da linha de comando, como mostram os comandos a seguir quando executados a partir de um diretório chamado my_app:

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

Driver

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

Para executar um aplicativo dependente da estrutura, especifique o aplicativo após o driver, por exemplo, dotnet /path/to/my_app.dll. Ao executar o comando na pasta onde está a DLL do aplicativo, basta executar dotnet my_app.dll. Se você quiser usar uma versão específica do .NET Runtime, use a opção --fx-version <VERSION> (consulte a referência do comando dotnet).

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

dotnet build

Primeiro, o driver determina a versão do SDK a ser usada. Se não houver um arquivo global.json, será usada a versão mais recente do SDK disponível. Isso pode ser uma versão prévia ou estável, dependendo do que há de mais recente no computador. 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 o código. Os comandos são implementados como um aplicativo de console usando uma convenção dotnet {command}.

Argumentos

Os argumentos que você passa na linha de comando são aqueles do comando invocado. Por exemplo, quando você executa dotnet publish my_app.csproj, o argumento my_app.csproj indica o projeto a ser publicado e é passado para o comando publish.

Opções

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

Compartilhar via