.Visão geral do CLI

Artigo
09/22/2022

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

tool install
tool list
tool update
tool restore Disponível desde .NET Core SDK 3.0.
tool run Disponível desde .NET Core SDK 3.0.
tool uninstall

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.

Partilhar via