dotnet clean

Questo articolo si applica a: ✔️ .NET 6 SDK e versioni successive

Nome

dotnet clean - Pulisce l'output di un progetto.

Sinossi

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

Il dotnet clean comando pulisce l'output della build precedente. Viene implementato come destinazione MSBuild, quindi il progetto viene valutato quando viene eseguito il comando. Vengono puliti solo gli output creati durante la compilazione. Le cartelle intermedie (obj) e output finale (bin) vengono pulite.

Arguments

PROJECT | SOLUTION | FILE

File di progetto o soluzione o C# (app basata su file) su cui operare. Se non viene specificato un file, MSBuild cerca un progetto o una soluzione nella directory corrente.

• PROJECT è il percorso e il nome file di un file di progetto C#, F# o Visual Basic oppure il percorso di una directory contenente un file di progetto C#, F# o Visual Basic.

• SOLUTION è il percorso e il nome file di un file di soluzione (.sln o estensione slnx) o il percorso di una directory contenente un file di soluzione.

• FILE è un argomento aggiunto in .NET 10. Percorso e nome file di un'app basata su file. Le app basate su file sono contenute all'interno di un singolo file compilato ed eseguito senza un file di progetto (con estensione csproj) corrispondente. Per altre informazioni, vedere Creare app C# basate su file.

Options

• --artifacts-path <ARTIFACTS_DIR>

  Tutti i file di output di compilazione del comando eseguito verranno inseriti nelle sottocartelle nel percorso specificato, separati dal progetto. Per altre informazioni, vedere Layout output artefatti. Disponibile a partire da .NET 8 SDK.

• -c|--configuration <CONFIGURATION>

  Definisce la configurazione di compilazione. Il valore predefinito per la maggior parte dei progetti è Debug, ma è possibile eseguire l'override delle impostazioni di configurazione della compilazione nel progetto. Questa opzione è necessaria solo durante la pulizia se è stata specificata durante la fase di compilazione.

• -f|--framework <FRAMEWORK>

  Framework specificato in fase di compilazione. Il framework deve essere definito nel file di progetto. Se il framework è stato specificato in fase di compilazione, è necessario specificare il framework durante la pulizia.

• -?|-h|--help

  Stampa una descrizione di come usare il comando .

• --interactive

  Consente al comando di arrestare e attendere l'input o l'azione dell'utente. Ad esempio, per completare l'autenticazione.

• --nologo

  Non visualizza il banner di avvio o il messaggio di copyright.

• -o|--output <OUTPUT_DIRECTORY>

  Directory contenente gli artefatti di compilazione da pulire. Specificare l'opzione con l'opzione -f|--framework <FRAMEWORK> della directory di output se è stato specificato il framework al momento della compilazione del progetto.

  • .NET 7.0.200 SDK e versioni successive

    Se si specifica l'opzione --output quando si esegue questo comando in una soluzione, l'interfaccia della riga di comando genererà un avviso (un errore nella versione 7.0.200) a causa della semantica non chiara del percorso di output. L'opzione --output non è consentita perché tutti gli output di tutti i progetti compilati verrebbero copiati nella directory specificata, che non è compatibile con progetti con più destinazioni, nonché progetti con versioni diverse di dipendenze dirette e transitive. Per altre informazioni, vedere Opzione a livello --output di soluzione non più valida per i comandi correlati alla compilazione.

• -r|--runtime <RUNTIME_IDENTIFIER>

  Pulisce la cartella di output del runtime specificato. Viene usato quando è stata creata una distribuzione autonoma .

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

  Specifica se il Logger terminale deve essere usato per l'output di compilazione. Il valore predefinito è auto, che prima verifica l'ambiente prima di abilitare la registrazione del terminale. Il controllo dell'ambiente verifica che il terminale sia in grado di usare le funzionalità di output moderne e non usa un output standard reindirizzato prima di abilitare il nuovo logger. on ignora il controllo dell'ambiente e abilita la registrazione del terminale. off ignora il controllo dell'ambiente e usa il logger di console predefinito.

  Terminale Logger mostra la fase di ripristino seguita dalla fase di compilazione. Durante ogni fase, i progetti attualmente in fase di compilazione vengono visualizzati nella parte inferiore del terminale. Ogni progetto che compila restituisce sia la destinazione MSBuild attualmente in fase di compilazione che la quantità di tempo impiegato per tale destinazione. È possibile cercare queste informazioni per altre informazioni sulla compilazione. Al termine della compilazione di un progetto, viene scritta una singola sezione "compilazione completata" che acquisisce:

  • Nome del progetto compilato.
  • Framework di destinazione (se multi-destinazione).
  • Stato della compilazione.
  • Output primario di tale compilazione (con collegamento ipertestuale).
  • Qualsiasi diagnostica generata per il progetto.

  Questa opzione è disponibile a partire da .NET 8.

• -v|--verbosity <LEVEL>

  Imposta il livello di dettaglio del comando. I valori consentiti sono q[uiet], m[inimal], n[ormal], d[etailed] e diag[nostic]. Il valore predefinito è normal. Per altre informazioni, vedere LoggerVerbosity.

Esempi

• Pulire una compilazione predefinita del progetto:

  dotnet clean
  

• Pulire un programma basato su file:

  dotnet clean Program.cs.
  

  Il supporto delle app basate su file è stato aggiunto in .NET SDK 10.0.100.

• Pulire un progetto compilato usando la configurazione release:

  dotnet clean --configuration Release