.Visão geral do CLI

  • Artigo

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

A interface de linha de comando .NET (CLI) é um campo de ferramentas transversal para o desenvolvimento, construção, execução e publicação de aplicações .NET.

O .NET CLI está incluído com o .NET SDK. Para aprender a instalar o .NET SDK, consulte instalar .NET Core.

Comandos da CLI

Os seguintes comandos são instalados por predefinição:

Comandos básicos

comandos de modificação Project

Comandos avançados

Comandos de gestão de ferramentas

As ferramentas são aplicações de consola que são instaladas a partir de pacotes NuGet e são invocadas a partir da origem do comando. Pode escrever ferramentas por si mesmo 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 mais informações, consulte a visão geral das ferramentas .NET.

Estrutura de comando

A estrutura de comando CLI é constituída pelo controlador ("dotnet"),,o comando e, possivelmente, argumentos e opções de comando. Você vê este padrão na maioria das operações do CLI, como criar uma nova aplicação de consola e executá-la a partir da linha de comando como os seguintes comandos mostram 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

Controlador

O condutor é nomeado dotnet e tem duas responsabilidades, quer executando uma aplicação dependente do quadro ou executando um comando.

Para executar uma aplicação dependente do quadro, especifique a aplicação após o condutor, por exemplo, dotnet /path/to/my_app.dll. Ao executar o comando a partir da pasta onde reside o DLL da aplicação, basta executar dotnet my_app.dll. Se pretender utilizar uma versão específica do tempo de execução .NET, utilize a opção --fx-version <VERSION> (consulte a referência de comando dotnet ).

Quando fornecer um comando ao controlador, dotnet.exe inicie o processo de execução do comando CLI. Por exemplo:

dotnet build

Primeiro, o controlador determina a utilização da versão do SDK. Se não houver um ficheiro global.json , a versão mais recente do SDK disponível é utilizada. Isto pode ser uma versão pré-visualizada ou estável, dependendo do mais recente da máquina. Uma vez determinada a versão SDK, executa o comando.

Comando

O comando realiza uma ação. Por exemplo, dotnet build constrói código. dotnet publish publica código. Os comandos são implementados como uma aplicação de consola usando uma dotnet {command} convenção.

Argumentos

Os argumentos que transmite na linha de comando são os argumentos invocados para o comando. Por exemplo, quando executa dotnet publish my_app.csproj, o my_app.csproj argumento indica que o projeto é publicado e é passado para o publish comando.

Opções

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

Ver também