dotnet clean

Este artigo se aplica a: ✔️ SDK do .NET 6 e versões posteriores

Nome

dotnet clean - Limpa a saída de um projeto.

Sinopse

dotnet clean [<PROJECT>|<SOLUTION>|<FILE>] [--artifacts-path <ARTIFACTS_DIR>]
    [-c|--configuration <CONFIGURATION>]
    [-f|--framework <FRAMEWORK>] [--interactive]
    [--nologo] [-o|--output <OUTPUT_DIRECTORY>]
    [-r|--runtime <RUNTIME_IDENTIFIER>] [--tl:[auto|on|off]]
    [-v|--verbosity <LEVEL>]

dotnet clean -h|--help

Description

O dotnet clean comando limpa a saída do build anterior. Ele é implementado como um destino do MSBuild, portanto, o projeto é avaliado quando o comando é executado. Somente as saídas criadas durante o build são limpas. As pastas intermediária (obj) e final (bin) são limpas.

Arguments

PROJECT | SOLUTION | FILE

O projeto, a solução ou o arquivo C# (aplicativo baseado em arquivo) no qual operar. Se um arquivo não for especificado, o MSBuild pesquisa o diretório atual em busca de um projeto ou solução.

• PROJECT é o caminho e o nome do arquivo de um arquivo de projeto C#, F#ou Visual Basic ou o caminho para um diretório que contém um arquivo de projeto C#, F#ou Visual Basic.

• SOLUTION é o caminho e o nome do arquivo de um arquivo de solução (.sln ou extensão .slnx) ou o caminho para um diretório que contém um arquivo de solução.

• FILE é um argumento adicionado ao .NET 10. O caminho e o nome do arquivo de um aplicativo baseado em arquivo. Os aplicativos baseados em arquivo estão contidos em um único arquivo que é criado e executado sem um arquivo de projeto (.csproj) correspondente. Para obter mais informações, consulte Criar aplicativos C# baseados em arquivo.

Opções

• --artifacts-path <ARTIFACTS_DIR>

  Todos os arquivos de saída de build do comando executado serão executados em subpastas no caminho especificado, separados pelo projeto. Para obter mais informações, consulte Layout de Saída de Artefatos. Disponível desde o SDK do .NET 8.

• -c|--configuration <CONFIGURATION>

  Define a configuração de build. O padrão para a maioria dos projetos é Debug, mas você pode substituir as configurações de build em seu projeto. Essa opção só será necessária durante a limpeza se você a especificou durante o tempo de build.

• -f|--framework <FRAMEWORK>

  A estrutura especificada no momento do build. A estrutura deve ser definida no arquivo de projeto. Se você especificou a estrutura no momento do build, deverá especificar a estrutura durante a limpeza.

• -?|-h|--help

  Imprime uma descrição de como usar o comando.

• --interactive

  Permite que o comando pare e aguarde a entrada ou ação do usuário. Por exemplo, para concluir a autenticação.

• --nologo

  Não exibe a faixa de inicialização nem a mensagem de direitos autorais.

• -o|--output <OUTPUT_DIRECTORY>

  O diretório que contém os artefatos de build a serem limpos. Especifique a opção -f|--framework <FRAMEWORK> com a opção de diretório de saída se você especificou a estrutura quando o projeto foi criado.

  • SDK do .NET 7.0.200 e posterior

    Se você especificar a opção --output ao executar esse comando em uma solução, a CLI emitirá um aviso (um erro em 7.0.200) devido à semântica não clara do caminho de saída. A --output opção não é permitida porque todas as saídas de todos os projetos compilados seriam copiadas para o diretório especificado, que não é compatível com projetos multilocatários, bem como projetos que têm diferentes versões de dependências diretas e transitivas. Para obter mais informações, consulte a opção no nível --output da solução que não é mais válida para comandos relacionados ao build.

• -r|--runtime <RUNTIME_IDENTIFIER>

  Limpa a pasta de saída do runtime especificado. Isso é usado quando uma implantação autocontida foi criada.

• --tl:[auto|on|off]

  Especifica se o Agente de Terminal deve ser usado para a saída de build. O padrão é auto, que primeiro verifica o ambiente antes de habilitar o registro em log do terminal. A verificação de ambiente verifica se o terminal é capaz de usar recursos de saída modernos e não está usando uma saída padrão redirecionada antes de habilitar o novo agente. on ignora a verificação de ambiente e habilita o registro em log do terminal. off ignora a verificação de ambiente e usa o agente de console padrão.

  O Agente de Terminal mostra a fase de restauração seguida pela fase de build. Durante cada fase, os projetos de construção atualmente aparecem na parte inferior do terminal. Cada projeto que está criando gera tanto o destino do MSBuild que está sendo construído no momento quanto o tempo gasto nesse destino. Você pode pesquisar essas informações para saber mais sobre o build. Quando um projeto é concluído, uma única seção "compilação concluída" é escrita que captura:

  • O nome do projeto compilado.
  • A estrutura de destino (se multilocatário).
  • O status desse build.
  • A saída primária desse build (que é hiperlink).
  • Qualquer diagnóstico gerado para esse projeto.

  Essa opção está disponível a partir do .NET 8.

• -v|--verbosity <LEVEL>

  Define o nível de detalhes do comando. Os valores permitidos são q[uiet], m[inimal], n[ormal], d[etailed] e diag[nostic]. O padrão é normal. Para obter mais informações, consulte LoggerVerbosity.

Exemplos

• Limpe um build padrão do projeto:

  dotnet clean
  

• Limpe um programa baseado em arquivo:

  dotnet clean Program.cs.
  

  O suporte a aplicativos baseados em arquivo foi adicionado ao SDK do .NET 10.0.100.

• Limpe um projeto criado usando a configuração de versão:

  dotnet clean --configuration Release