dotnet limpo

Este artigo aplica-se a: ✔️ .NET 6 SDK 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 da compilação anterior. Ele é implementado como um destino MSBuild, para que o projeto seja avaliado quando o comando é executado. Somente as saídas criadas durante a compilação são limpas. As pastas intermediárias (obj) e de saída final (bin) são limpas.

Arguments

PROJECT | SOLUTION | FILE

O projeto ou solução ou arquivo C# (aplicativo baseado em arquivo) para operar. Se um arquivo não for especificado, o MSBuild procurará um projeto ou solução no diretório atual.

• PROJECT é o caminho e o nome do arquivo de projeto de um 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 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 no .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 correspondente (.csproj). 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 compilação do comando executado irão em subpastas sob o caminho especificado, separados por 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 compilação. O padrão para a maioria dos projetos é Debug, mas você pode substituir as definições de configuração de compilação em seu projeto. Essa opção só é necessária durante a limpeza se você a especificou durante o tempo de compilação.

• -f|--framework <FRAMEWORK>

  A estrutura que foi especificada em tempo de compilação. A estrutura deve ser definida no arquivo do projeto. Se você especificou a estrutura no momento da compilação, deverá especificá-la 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 o banner de inicialização ou a mensagem de direitos autorais.

• -o|--output <OUTPUT_DIRECTORY>

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

  • SDK do .NET 7.0.200 e posterior

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

• -r|--runtime <RUNTIME_IDENTIFIER>

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

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

  Especifica se o Terminal Logger deve ser usado para a saída de compilação. 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 ativar o novo registrador. on ignora a verificação do ambiente e habilita o registro em log do terminal. off ignora a verificação de ambiente e usa o registrador de console padrão.

  O Terminal Logger mostra a fase de restauração seguida pela fase de compilação. Durante cada fase, os projetos atualmente em construção aparecem na parte inferior do terminal. Cada projeto que está construindo produz tanto a meta do MSBuild que está sendo criada quanto a quantidade de tempo gasto nessa meta. Você pode pesquisar essas informações para saber mais sobre a compilação. Quando um projeto termina de construir, uma única seção "construção concluída" é escrita que captura:

  • O nome do projeto construído.
  • A estrutura de destino (se multidirecionada).
  • O status dessa compilação.
  • A saída primária dessa compilação (que é hiperligada).
  • Qualquer diagnóstico gerado para esse projeto.

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

• -v|--verbosity <LEVEL>

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

Examples

• Limpe uma compilação 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 no .NET SDK 10.0.100.

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

  dotnet clean --configuration Release