dotnet clean
Este artigo se aplica a: ✔️ SDK do .NET Core 3.1 e versões posteriores
dotnet clean
– limpa a saída de um projeto.
dotnet clean [<PROJECT>|<SOLUTION>] [--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
O comando dotnet clean
limpará a saída da compilação anterior. Ele é implementado como um destino de MSBuild, para que o projeto seja avaliado durante a execução do comando. Apenas as saídas criadas durante a compilação são limpas. As pastas de saídas intermediária (obj) e final (bin) serão limpas.
PROJECT | SOLUTION
O projeto do MSBuild ou a solução para limpar. Se um arquivo de solução ou projeto não for especificado, o MSBuild pesquisará no diretório de trabalho atual por um arquivo que tenha uma extensão terminada em proj ou sln e usará esse arquivo.
--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 da compilação. O padrão da maioria dos projetos é
Debug
, mas você pode substituir as definições de configuração de build no projeto. Essa opção só será exigida na limpeza se você especificá-la durante o momento do build.
-f|--framework <FRAMEWORK>
A estrutura que foi especificada no momento da compilação. A estrutura precisa ser definida no arquivo de projeto. Se você especificou a estrutura no momento da compilação, especifique a estrutura ao limpar.
-?|-h|--help
Imprime uma descrição de como usar o comando.
--interactive
Permite que o comando pare e aguarde entrada ou ação do usuário. Por exemplo, para concluir a autenticação. Disponível desde o SDK do .NET Core 3.0.
--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ê tiver especificado a estrutura durante a compilação do projeto.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 pouco clara do caminho de saída. A opção--output
não é permitida, porque todas as saídas de todos os projetos criados serão copiadas para o diretório especificado, o que não é compatível com projetos multiplataforma, bem como projetos que têm diferentes versões de dependências diretas e transitivas. Para obter mais informações, confira A opção--output
no nível da solução não é mais válida para comandos relacionados à compilação.
-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 confirma 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 atuais aparecem na parte inferior do terminal. Cada projeto que está sendo criado gera tanto o destino do MSBuild em construção no momento quanto o tempo gasto nesse destino. Você pode pesquisar essas informações para saber mais sobre o build. Quando a build de um projeto é concluída, é gravada uma única seção "build concluída" que captura:
- O nome do projeto criado.
- A estrutura de destino (se houver vários destinos).
- O status dessa build.
- A saída primária dessa build (que contém um hiperlink).
- Qualquer diagnóstico gerado para esse projeto.
Esta opção está disponível desde o .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]
ediag[nostic]
. O padrão énormal
. Para obter mais informações, consulte LoggerVerbosity.
Limpe uma compilação padrão do projeto:
dotnet clean
Limpe um projeto compilado usando a configuração da Versão:
dotnet clean --configuration Release
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: