Visão geral da CLI do .NET Core.NET Core CLI overview

Este artigo se aplica a: ✔️ .NET Core 2.1 SDK e versões posterioresThis article applies to: ✔️ .NET Core 2.1 SDK and later versions

A interface de linha de comando .NET Core (CLI) é uma cadeia de ferramentas multiplataforma para desenvolver, construir, executar e publicar aplicativos .NET Core.The .NET Core command-line interface (CLI) is a cross-platform toolchain for developing, building, running, and publishing .NET Core applications.

O .NET Core CLI está incluído no .NET Core SDK.The .NET Core CLI is included with the .NET Core SDK. Para saber como instalar o .NET Core SDK, consulte Instale o .NET Core SDK.To learn how to install the .NET Core SDK, see Install the .NET Core SDK.

Comandos de CLICLI commands

Os comandos a seguir são instalados por padrão:The following commands are installed by default:

Comandos básicosBasic commands

Comandos de modificação de projetoProject modification commands

Comandos avançadosAdvanced commands

Comandos de gerenciamento de ferramentasTool management commands

As ferramentas são aplicativos de console que são instalados a partir de pacotes NuGet e são invocados a partir do prompt de comando.Tools are console applications that are installed from NuGet packages and are invoked from the command prompt. Você mesmo pode escrever ferramentas ou instalar ferramentas escritas por terceiros.You can write tools yourself or install tools written by third parties. As ferramentas também são conhecidas como ferramentas globais, ferramentas de caminho de ferramentas e ferramentas locais.Tools are also known as global tools, tool-path tools, and local tools. Para obter mais informações, consulte a visão geral das ferramentas .NET Core.For more information, see .NET Core tools overview.

Estrutura de comandoCommand structure

A estrutura de comando CLI consiste no driver ("dotnet"), do comando e possivelmente de opções e argumentos de comando.CLI command structure consists of the driver ("dotnet"), the command, and possibly command arguments and options. É 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:You see this pattern in most CLI operations, such as creating a new console app and running it from the command line as the following commands show when executed from a directory named my_app:

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

DriverDriver

O driver é chamado dotnet e tem duas responsabilidades, executar um aplicativo dependente da estrutura ou executar um comando.The driver is named dotnet and has two responsibilities, either running a framework-dependent app or executing a command.

Para executar um aplicativo dependente da estrutura, especifique o aplicativo após o driver, por exemplo, dotnet /path/to/my_app.dll.To run a framework-dependent app, specify the app after the driver, for example, dotnet /path/to/my_app.dll. Ao executar o comando na pasta onde está a DLL do aplicativo, basta executar dotnet my_app.dll.When executing the command from the folder where the app's DLL resides, simply execute dotnet my_app.dll. Se você quiser usar uma versão específica do .NET Core Runtime, use a opção --fx-version <VERSION> (consulte a referência do comando dotnet).If you want to use a specific version of the .NET Core Runtime, use the --fx-version <VERSION> option (see the dotnet command reference).

Quando você fornece um comando para o driver, dotnet.exe inicia o processo de execução do comando da CLI.When you supply a command to the driver, dotnet.exe starts the CLI command execution process. Por exemplo: For example:

dotnet build

Primeiro, o driver determina a versão do SDK a ser usada.First, the driver determines the version of the SDK to use. Se não houver nenhum arquivo global.json, a versão mais recente do SDK disponível será usada.If there is no global.json file, the latest version of the SDK available is used. Isso pode ser uma versão prévia ou estável, dependendo do que há de mais recente no computador.This might be either a preview or stable version, depending on what is latest on the machine. Depois que a versão do SDK é determinada, ela executa o comando.Once the SDK version is determined, it executes the command.

ComandoCommand

O comando executa uma ação.The command performs an action. Por exemplo, dotnet build compila código.For example, dotnet build builds code. dotnet publish publica o código.dotnet publish publishes code. Os comandos são implementados como um aplicativo de console usando uma convenção dotnet {command}.The commands are implemented as a console application using a dotnet {command} convention.

ArgumentosArguments

Os argumentos que você passa na linha de comando são aqueles do comando invocado.The arguments you pass on the command line are the arguments to the command invoked. Por exemplo, quando dotnet publish my_app.csprojvocê my_app.csproj executa, o argumento indica publish que o projeto será publicado e é passado para o comando.For example, when you execute dotnet publish my_app.csproj, the my_app.csproj argument indicates the project to publish and is passed to the publish command.

OpçõesOptions

As opções que você passa na linha de comando são aquelas do comando invocado.The options you pass on the command line are the options to the command invoked. Por exemplo, quando dotnet publish --output /build_outputvocê --output executa, a opção publish e seu valor são passados para o comando.For example, when you execute dotnet publish --output /build_output, the --output option and its value are passed to the publish command.

Confira tambémSee also