dotnet clean

Článek
04/30/2024

Tento článek se vztahuje na: ✔️ .NET Core 3.1 SDK a novější verze

Název

dotnet clean - Vyčistí výstup projektu.

Synopse

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

Popis

Příkaz dotnet clean vyčistí výstup předchozího sestavení. Implementuje se jako cíl NÁSTROJE MSBuild, takže se projekt vyhodnotí při spuštění příkazu. Vyčistí se jenom výstupy vytvořené během sestavení. Vyčistí se zprostředkující složky (obj) i konečné výstupní složky (bin).

Argumenty

PROJECT | SOLUTION

Projekt nebo řešení NÁSTROJE MSBuild, které se mají vyčistit. Pokud není zadán soubor projektu nebo řešení, nástroj MSBuild vyhledá aktuální pracovní adresář pro soubor, který má příponu souboru končící proj nebo sln, a použije tento soubor.

Možnosti

--artifacts-path <ARTIFACTS_DIR>

Všechny výstupní soubory sestavení ze spuštěného příkazu budou v podsložkách pod zadanou cestou oddělenou projektem. Další informace naleznete v tématu Rozložení výstupu artefaktů. K dispozici od sady .NET 8 SDK.

-c|--configuration <CONFIGURATION>

Definuje konfiguraci sestavení. Výchozí hodnota pro většinu projektů je Debug, ale můžete přepsat nastavení konfigurace sestavení v projektu. Tato možnost se vyžaduje pouze při čištění, pokud jste ji zadali během doby sestavení.

-f|--framework <FRAMEWORK>

Architektura zadaná v době sestavení. Architektura musí být definována v souboru projektu. Pokud jste architekturu zadali v době sestavení, musíte při čištění zadat architekturu.

-?|-h|--help

Vytiskne popis použití příkazu.

--interactive

Umožňuje příkazu zastavit a čekat na uživatelský vstup nebo akci. Například k dokončení ověřování. K dispozici od sady .NET Core 3.0 SDK.

--nologo

Nezobrazuje úvodní banner ani zprávu o autorských právech.
-o|--output <OUTPUT_DIRECTORY>

Adresář, který obsahuje artefakty sestavení k vyčištění. -f|--framework <FRAMEWORK> Pokud jste zadali architekturu při sestavení projektu, zadejte přepínač s výstupním adresářem.
- Sada .NET 7.0.200 SDK a novější
  
  Pokud při spuštění tohoto příkazu v řešení zadáte --output možnost, rozhraní příkazového řádku vygeneruje upozornění (chyba ve verzi 7.0.200) kvůli nejasné sémantice výstupní cesty. Možnost --output je zakázána, protože všechny výstupy všech sestavených projektů by se zkopírovaly do zadaného adresáře, který není kompatibilní s více cílenými projekty a projekty, které mají různé verze přímých a tranzitivních závislostí. Další informace najdete v tématu Možnost na úrovni --output řešení již neplatí pro příkazy související s sestavením.
-r|--runtime <RUNTIME_IDENTIFIER>

Vyčistí výstupní složku zadaného modulu runtime. Používá se při vytvoření samostatného nasazení .

--tl:[auto|on|off]

Určuje, jestli se má protokolovací nástroj terminálu použít pro výstup sestavení. Výchozí hodnota je auto, která nejprve ověří prostředí před povolením protokolování terminálu. Prostředí ověřuje, že terminál dokáže používat moderní výstupní funkce a nepoužívá přesměrovaný standardní výstup, než povolí nový protokolovací modul. on přeskočí kontrolu prostředí a povolí protokolování terminálu. off přeskočí kontrolu prostředí a použije výchozí protokolovací nástroj konzoly.

Protokolovací nástroj terminálu ukazuje fázi obnovení následovanou fází sestavení. Během každé fáze se aktuálně stavební projekty zobrazují v dolní části terminálu. Každý projekt, který vytváří výstupy cíle NÁSTROJE MSBuild, který se právě sestavuje, i dobu strávenou na daném cíli. Další informace o sestavení najdete v těchto informacích. Po dokončení sestavení projektu se zapíše jeden oddíl "sestavení dokončeno", který zachycuje:
- Název sestaveného projektu.
- Cílová architektura (pokud je cílená na více cílů).
- Stav tohoto sestavení.
- Primární výstup tohoto sestavení (který je hypertextový odkaz).
- Všechna diagnostika vygenerovaná pro tento projekt.
Tato možnost je dostupná od verze .NET 8.

-v|--verbosity <LEVEL>

Nastaví úroveň podrobností příkazu. Povolené hodnoty jsou q[uiet], , n[ormal]m[inimal], d[etailed]a diag[nostic]. Výchozí hodnota je normal. Další informace najdete na webu LoggerVerbosity.

Příklady

Vyčištění výchozího sestavení projektu:
```
dotnet clean
```
Vyčištění projektu vytvořeného pomocí konfigurace vydané verze:
```
dotnet clean --configuration Release
```

Sdílet prostřednictvím