Importante: Para a escrita deste artigo, foi utilizado a versão 8 do .NET. Caso sua versão não seja a mesma e surgir alguma dúvida, deixe sua questão nos comentários que eu ou a comunidade irá apoiar. Bons estudos!

Neste artigo vamos explorar um pouco dos comandos do dotnet cli.

1. Mas antes de mais nada, o que é um CLI?

Uma Interface de linha de comando é um mecanismo de software que você usa para interagir com o sistema operacional usando o teclado. Outro mecanismo é uma interface gráfica (GUI), que hoje é popular em todas as aplicações e sistemas de softwares.

2. E quanto ao dotnet cli?

A CLI do .NET é uma ferramenta multiplataforma para desenvolvimento, criação, execução e aplicação de aplicativos .NET. A CLI do .NETestá incluída no .NET SDK.

O comando dotnet possui duas funções:

  1. Fornece comandos para trabalhar com projetos .NET
  2. Executa aplicativos .NET

3. Explorando os comandos básicos do CLI.

  • dotnet --info: Imprime informações detalhadas sobre uma instalação do .NET e o ambiente do computador, como o sistema operacional atual, e o SHA da confirmação da versão do .NET. Este comando também serve como um comando básico para certificar se o mesmo está instalado em sua estação e até mesmo verificar quais SDK's e runtimes estão instalados. A visualização específica de SDK e runtime veremos abaixo.

Você terá um resultado semelhante ao abaixo, com as devidas informações de sua estação e os detalhes da instalação:

# Para obter informações de instalação e ambiente
$ dotnet --info

dotnet-info.png

  • dotnet --version: Imprime a versão do SDK do .NET usada por comandos dotnet, que podem ser afetados por um arquivo global.json . Disponível somente quando o SDK estiver instalado.
# Para obter informações de versão
$ dotnet --version

Você terá um resultado semelhante ao abaixo, com as informações da versão instalada em sua estação.

dotnet-version.png

  • dotnet --list-sdks: Vamos verificar a versão (ou versões) de SDK intalados em sua estação.
# Para listarmos SDK's instalados:
$ dotnet --list-sdks

Você terá um resultado semelhante ao mostrado a seguir.

dotnet-list-sdk.png

  • dotnet --list-runtimes: Após a verificação de SDK instalados, vamos conferir as versões de runtime também instaladas. Lembrando que na instalação de um determinado SDK, um runtime correspondente é instalado.
# Para listarmos runtime(s) instalados:
$ dotnet --list-runtimes

Você terá um resultado semelhante ao mostrado a seguir.

dotnet-list-runtimes.png

  • dotnet new <TEMPLATE>: Cria um novo projeto, arquivo de configuração ou solução com base no modelo especificado.

<TEMPLATE>: O modelo para o qual criar uma instância quando o comando é invocado. Cada modelo pode ter opções específicas que podem ser passadas.

Você pode executar dotnet new list para ver uma lista de todos os modelos instalados. Comando executado abaixo com print de modelos:

$ dotnet new list

dotnet-new-list.png

Dica Importante: Para cada comando que conhecemos, temos a opção de obter ajuda, ou o help do comando. Este help é muito importante para nos orientarmos e termos a certeza da parametrização que estamos aplicando. A intenção do artigo não é passar receitas de bolo, e sim, mostrar os comandos e como se aprofundar em seus conhecimentos. Não se preocupe em decorar a sintaxe ou as linhas de comandos necessárias, se preocupe em entender o que precisa ser feito e o principal, como executar o necessário. Você perceberá evolução em seus conhecimentos quando tiver a certeza do motivo e a necessidade de escrever uma determinada instrução.

Para você conhecer os parâmetros possíveis e o helppara a utilização do dotnet new, execute o comando com o padrão abaixo:

$ dotnet new <TEMPLATE> -h

Para exemplificar o comando, iremos utilizar o template de uma aplicação console. O comando será o seguinte:

$ dotnet new console -h

Teremos um resultado semelhante ao demonstrado na imagem a seguir:

dotnet-new-console-h.png

Para exemplificarmos com exemplo, iremos criar um projeto console, abrir e executar o mesmo.

  • Criando o projeto console
  1. Na pasta em que é desejado a criação do projeto, entre com o comando para a criação do projeto:
# Para criar um projeto console
$ dotnet new console --name DegasExemplo

  1. Após a criação do projeto, uma pasta com o nome do projeto será criada, no nosso caso, a pasta DegasExemplo.

  2. Acesse a pasta do projeto via terminal e execute a listagem do diretório para relacionar os arquivos criados.

Para validar visualmente as etapas acima executadas, o resultado obtido será semelhante ao da imagem demonstrada abaixo, com todos os passos de execução:

dotnet-new-console.png

Para abrirmos o projeto seguir com a programação e alteração de seu código fonte, abra o projeto em sua IDE de preferência. Neste caso, estarei utilizando o vscode. Para executar o vscode no projeto basta executar o comando code .dentro da pasta do projeto e o mesmo será aberto.

Segue imagem demonstrando o vscode com o projeto aberto:

vscode-degas-exemplo.png

  • dotnet build: O comando dotnet build compila o projeto e suas dependências em um conjunto de binários. Os binários incluem o código do projeto em arquivos de linguagem intermediária (IL) com uma extensão .dll.

Para realizar a compilação do projeto, execute o comando a seguir (No terminal já utilizado ou no novo terminal do vscode se desejável).

$ dotnet build

O resultado será semelhante ao demonstrado em imagem abaixo:

dotnet-build.png

4. Resumo - Comandos do CLI listados neste artigo

Neste artigo, tivemos a oportunidade de conhecer um pouco melhor sobre os pontos abaixo:

  • Conhecer um pouvo melhor sobre o dotnet cli
  • Conhecer comandos básicos do CLI
  • Criar um console application
  • Compilarmos a aplicação criada
Comando Finalidade
dotnet --info Imprime informações detalhadas sobre uma instalação do .NET e o ambiente do computador
dotnet --list-sdks Exibe lista de SDK’s instalados
dotnet --list-runtimes Exibe lista de runtimes instalados
dotnet new <TEMPLATE> Cria novo projeto, arquivo de configuração ou solução com base no modelo especificado
dotnet new list Exibe lista de templates instalados em sua estação
dotnet new <TEMPLATE> -h Exibe o help para a utilização do comando dotnet new utilizando o template desejado
dotnet new console --name Console1 Cria o console application com o nome Console1
dotnet build Compila projeto e dependências

Espero que tenha gostado do conteúdo!

Lembre-se: Estes artigos não possuem a intenção apenas de passar uma receita de bolo. Com o demonstrado aqui, você possui a escolha de se aprofundar, estudar e evoluir seus conhecimentos, buscando se tornar um profissional melhor do que é hoje!

Nos vemos na sequencia da trilha de CLI!

Se você gostou do conteúdo, deixe um comentário ou uma reação para apoiar o projeto! Compartilhe com alguém e ajude a divulgar!

[]´s

Degas