5 Comandos Rápidos .NET CLI Que Todo Desenvolvedor C# Deveria Conhecer

Introdução ao CLI do .NET e à Interface de Linha de Comando do .NET

No início do vídeo, Tim enfatiza que mesmo que você prefira um IDE como o Visual Studio, entender a interface de linha de comando do .NET (CLI) é crucial. Uma interface de linha de comando CLI permite interagir diretamente com seus aplicativos .NET Core, sem depender do IDE. Isso é especialmente útil quando você quer executar comandos de inicialização, realizar compilação explícita ou trabalhar em um ambiente de ferramenta multiplataforma usando Windows, Mac ou Linux.

Tim também dá uma dica bônus rápida às 1:15: executando

dotnet --info

Este comando lista as versões do SDK do .NET instaladas, pacotes de runtime na loja de pacotes de runtime, arquitetura e outros detalhes do ambiente. Ele confirma que o CLI do .NET Core está instalado e pronto para uso, o que é essencial antes de explorar mais comandos.

1. Construa seu Projeto com .NET build

O primeiro comando que Tim explica é .NET build. Esse comando build compila o código-fonte em arquivos DLL no diretório de saída, geralmente sob bin/Debug/net10/ou bin/Release/net10/. Tim demonstra limpar o diretório bin para remover arquivos compilados anteriormente, garantindo uma compilação limpa.

dotnet build

Tim explica que este comando cria a saída compilada com base no arquivo de configuração e no template de projeto, seja um aplicativo de console, uma biblioteca de classes ou um aplicativo ASP.NET Core. O comando build é essencial porque garante que seu CLI do .NET Core saiba exatamente o que compilar e quais arquivos especificados incluir.

Usar o comando build também é um pré-requisito para comandos CLI mais avançados como .NET run ou .NET publish. Tim enfatiza que, embora o Visual Studio cuide das builds automaticamente, saber a opção de compilação explícita com .NET build ajuda em pipelines CI/CD ou fluxos de trabalho de linha de comando principais.

2. Execute seu Aplicativo com .NET run

O segundo comando de Tim é .NET run, um comando de execução que constrói e executa sua aplicação .NET Core em um único passo. Ao contrário do .NET build, que apenas compila, **.NET run executa a aplicação no terminal ou prompt de comando atual.

dotnet run

Usando sua Blazor web app, Tim demonstra que .NET run lança o aplicativo com base nas configurações do arquivo launchSettings.json. A URL padrão e a porta HTTP são selecionadas automaticamente. Ele edita a página inicial usando o Notepad e observa que as atualizações não são refletidas até rerodar o .NET run (5:02).

Este comando é especialmente útil para testar aplicativos de console, aplicativos web ASP.NET Core ou até projetos de biblioteca de classes que fazem referência a outros arquivos DLL usando .NET add reference. Para desenvolvedores que executam testes de unidade no .NET Core, combinar .NET build com .NET run garante que os assemblies especificados estão prontos para o executor de testes.

3. Atualização a Quente com .NET watch

Para eliminar a necessidade de reiniciar seu aplicativo após cada alteração, Tim apresenta o .NET watch, um comando CLI de observador de arquivos que possibilita a recarga a quente (5:44).

dotnet watch

Este comando CLI monitora arquivos especificados no diretório do seu projeto e aplica automaticamente as mudanças ao aplicativo em execução. Tim edita a página inicial novamente, mudando o texto de "Hello YouTube" de volta para "Hello World", e o navegador atualiza em tempo real sem reiniciar.

O recurso de observação de arquivos é inestimável para desenvolvimento multiplataforma, permitindo que desenvolvedores do .NET Core trabalhem em editores leves como o Notepad enquanto mantêm a experiência de recarga a quente normalmente disponível apenas no Visual Studio ou VS Code.

4. Limpe seu Projeto com .NET clean

Às vezes, projetos .NET podem ter arquivos compilados restantes que causam erros ou inconsistências. O quarto comando de Tim, .NET clean, remove todos os arquivos no diretório de saída e pastas intermediárias, como bin/e obj/ (7:06).

dotnet clean

Após executar este comando, compilações subsequentes são realizadas do zero, garantindo que nenhum arquivo DLL ou recurso local do NuGet interfira. Tim demonstra que .NET clean é particularmente útil ao lidar com arquivos de solução que contêm múltiplos projetos .NET Core ou projetos de biblioteca de classes com pacotes nuget.

Este comando garante um começo novo para rodar testes de unidade com .NET test ou para preparar o projeto para implantação.

5. Publique seu Projeto com .NET publish

Finalmente, Tim apresenta o .NET publish, que prepara sua aplicação .NET Core para implantação em um sistema de hospedagem como IIS, Azure, ou outros ambientes.

dotnet publish

Este comando CLI compila o projeto e coloca os ativos publicados na pasta publish sob bin/Release/net10/. Os arquivos de saída incluem todos os assemblies especificados, pacotes de runtime e certificados de desenvolvimento necessários para hospedagem. Tim enfatiza que este comando funciona para todos os projetos .NET Core, incluindo aplicativos de console, aplicativos ASP.NET Core e bibliotecas de classes (8:18).

.NET publish também é útil quando combinado com .NET pack para criar pacotes NuGet, tornando o seu código reutilizável em várias soluções .NET Core.

Dicas e Notas Adicionais

Tim destaca que dominar esses cinco comandos CLI do .NET Core—.NET build, .NET run, .NET watch, .NET clean, e .NET publish—cobre aproximadamente 85% das tarefas diárias no desenvolvimento .NET Core (9:01). Ele também menciona outras opções de comando e documentação mais detalhada online se quiser explorar opções avançadas, executores de testes de unidade ou templates de projeto customizados.

Para novos projetos, os desenvolvedores podem usar .NET new console, .NET new class library, ou outros templates especificados para gerar rapidamente uma aplicação de console .NET Core ou projeto ASP.NET Core. Além disso, .NET restore ajuda a restaurar recursos locais do NuGet e assemblies especificados antes de construir.

Esses comandos são multiplataforma, o que significa que a mesma interface de linha de comando CLI funciona no Windows, Mac e Linux. Eles também são compatíveis com templates de projeto, arquivos de solução, aplicativos de console, projetos de biblioteca de classes e aplicações de modelo-vista-controlador, tornando-os versáteis para quase todos os projetos .NET Core.

Resumo

Aqui está um rápido resumo dos cinco comandos essenciais do CLI do .NET Core que Tim Corey recomenda:

1. .NET build – Compila explicitamente seu projeto em arquivos DLL no diretório de saída.

2. .NET run – Constrói e executa a aplicação .NET Core imediatamente.

3. .NET watch – Permite recarga a quente via um observador de arquivos para refletir automaticamente as alterações.

4. .NET clean – Remove todos os arquivos compilados e pastas intermediárias para uma construção limpa.

5. .NET publish – Prepara uma aplicação .NET Core totalmente publicada para implantação em qualquer sistema de hospedagem.

Esses comandos capacitam os desenvolvedores a gerenciar projetos .NET Core, arquivos de solução e projetos de console de forma eficiente usando o .NET CLI sem depender totalmente de uma IDE. Ao incorporá-los no seu fluxo de trabalho, você pode rapidamente construir, executar, testar e implantar seus aplicativos .NET Core com confiança.