dotnet clean

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

Název

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

Přehled

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

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).

Arguments

PROJECT | SOLUTION | FILE

Projekt nebo řešení nebo soubor jazyka C# (souborová aplikace), na kterém se má pracovat. Pokud není zadaný soubor, nástroj MSBuild vyhledá aktuální adresář projektu nebo řešení.

• PROJECT je cesta a název souboru projektu jazyka C#, F# nebo jazyka Visual Basic nebo cesty k adresáři, který obsahuje soubor projektu jazyka C#, F# nebo Visual Basic.

• SOLUTION je cesta a název souboru řešení (.sln nebo přípony .slnx) nebo cesta k adresáři, který obsahuje soubor řešení.

• FILE je argument přidaný v .NET 10. Cesta a název souboru aplikace. Aplikace založené na souborech jsou obsaženy v jednom souboru, který je sestaven a spuštěn bez odpovídajícího souboru projektu (.csproj). Další informace najdete v tématu Vytváření souborových aplikací jazyka C#.

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í.

• --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á pro výstup sestavení použít terminálový protokolovací nástroj . 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.

  Terminal Logger 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], , m[inimal]n[ormal], d[etailed]a diag[nostic]. Výchozí hodnota je normal. Další informace najdete v tématu LoggerVerbosity.

Examples

• Vyčištění výchozího sestavení projektu:

  dotnet clean
  

• Vyčištění programu založeného na souborech:

  dotnet clean Program.cs.
  

  Podpora souborových aplikací byla přidána do sady .NET SDK 10.0.100.

• Vyčištění projektu vytvořeného pomocí konfigurace vydané verze:

  dotnet clean --configuration Release