Skip to main content

Comandos do cli do .NET | dotnet | CSharp

  • Comandos do cli do .NET | dotnet | CSharp

Comandos principais do dotnet​

Visão geral​

O comando dotnet é o driver genérico da CLI do .NET SDK. Ele permite executar comandos para trabalhar com projetos, assim como rodar aplicativos gerados pelo .NET. ([Microsoft Learn][1]) A estrutura básica de uso é:

dotnet <comando> [opções] [argumentos]

Por exemplo:

dotnet build MyProject.csproj

Comandos básicos de ciclo de vida de projeto​

  • dotnet new <template>: cria um novo projeto a partir de um template. ([Microsoft Learn][2]) Exemplo:

    dotnet new console -o MeuApp

  • dotnet restore: restaura as dependências (pacotes NuGet) de um projeto. ([softchris.github.io][3])

  • dotnet build: compila o projeto e suas dependências. ([softchris.github.io][3])

  • dotnet run: executa o projeto a partir do código-fonte (geralmente em modo de desenvolvimento). ([Microsoft Learn][4])

  • dotnet test: executa os testes automatizados de um projeto de teste. ([softchris.github.io][3])

  • dotnet publish: empacota a aplicação e suas dependências para implantação. ([Microsoft Learn][2])

  • dotnet clean: limpa as saídas de build (pastas bin, obj, etc). ([softchris.github.io][3])

Comandos de gerenciamento de solução / projeto​

  • dotnet sln: adiciona, lista ou remove projetos em um arquivo de solução (.sln). ([softchris.github.io][3])
  • dotnet add package <nome>: adiciona um pacote NuGet ao projeto. ([softchris.github.io][3])
  • dotnet add reference <projeto>: adiciona uma referência de projeto a outro projeto. ([softchris.github.io][3])

Outros comandos úteis​

  • dotnet --info ou dotnet --version: exibe informações sobre o SDK instalado ou versão. ([Microsoft Learn][1])
  • dotnet tool install, dotnet tool list, dotnet tool update: gerenciamento de ferramentas globais ou locais via CLI. ([Microsoft Learn][5])
  • dotnet msbuild: acesso direto ao motor MSBuild para tarefas mais avançadas. ([Microsoft Learn][5])

Dicas para CI (Integração Contínua)​

  • Em pipelines de CI, geralmente o fluxo é algo como: restore → build → test → publish/artifact.
  • Use dotnet restore explicitamente ou confie que dotnet build/restauração automática será executada. ([softchris.github.io][3])
  • Use dotnet test para garantir que os testes estão passando antes de avançar para deploy.
  • dotnet publish pode gerar um artefato para deploy ou distribuição.
  • Inclua dotnet clean no início ou no final para garantir que o ambiente de build esteja limpo.
  • Documente no pipeline as versões do SDK do .NET que devem ser usadas (ex: via global.json) para consistência.
  • Use opções como --verbosity ou --configuration para controlar saída ou modo de build em CI.
  • Para automatização, use scripts (PowerShell, Bash, YAML de pipeline) que chamem os comandos acima com parâmetros adequados.