dotnet clean

Ten artykuł dotyczy: ✔️ zestaw .NET Core 3.1 SDK i nowsze wersje

Nazwisko

dotnet clean — Czyści dane wyjściowe projektu.

Streszczenie

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

opis

Polecenie dotnet clean czyści dane wyjściowe poprzedniej kompilacji. Jest on implementowany jako docelowy program MSBuild, więc projekt jest oceniany podczas uruchamiania polecenia. Tylko dane wyjściowe utworzone podczas kompilacji są czyszczone. Oba foldery pośrednie (obj) i końcowe dane wyjściowe (bin) są czyszczone.

Argumenty

PROJECT | SOLUTION

Projekt lub rozwiązanie programu MSBuild do oczyszczenia. Jeśli nie określono pliku projektu lub rozwiązania, program MSBuild przeszukuje bieżący katalog roboczy dla pliku z rozszerzeniem pliku kończącym się na pliku proj lub sln i używa tego pliku.

Opcje

• --artifacts-path <ARTIFACTS_DIR>

  Wszystkie pliki wyjściowe kompilacji z wykonanego polecenia zostaną umieszczone w podfolderach w określonej ścieżce oddzielonej przez projekt. Aby uzyskać więcej informacji, zobacz Artifacts Output Layout (Układ danych wyjściowych artefaktów). Dostępne od zestawu .NET 8 SDK.

• -c|--configuration <CONFIGURATION>

  Definiuje konfigurację kompilacji. Wartość domyślna dla większości projektów to Debug, ale można zastąpić ustawienia konfiguracji kompilacji w projekcie. Ta opcja jest wymagana tylko podczas czyszczenia, jeśli określono ją w czasie kompilacji.

• -f|--framework <FRAMEWORK>

  Struktura określona w czasie kompilacji. Struktura musi być zdefiniowana w pliku projektu. Jeśli w czasie kompilacji określono strukturę, należy określić strukturę podczas czyszczenia.

• -?|-h|--help

  Wyświetla opis sposobu używania polecenia .

• --interactive

  Umożliwia zatrzymanie polecenia i oczekiwanie na wprowadzenie lub działanie użytkownika. Na przykład w celu ukończenia uwierzytelniania. Dostępny od wersji .NET Core 3.0 SDK.

• --nologo

  Nie wyświetla baneru startowego ani wiadomości o prawach autorskich.

• -o|--output <OUTPUT_DIRECTORY>

  Katalog zawierający artefakty kompilacji do oczyszczenia. -f|--framework <FRAMEWORK> Określ przełącznik z przełącznikiem katalogu wyjściowego, jeśli określono strukturę podczas tworzenia projektu.

  • Zestaw .NET 7.0.200 SDK lub nowszy

    Jeśli określisz opcję podczas uruchamiania --output tego polecenia w rozwiązaniu, interfejs wiersza polecenia będzie emitować ostrzeżenie (błąd w wersji 7.0.200) z powodu niejasnej semantyki ścieżki wyjściowej. Opcja --output jest niedozwolona, ponieważ wszystkie dane wyjściowe wszystkich projektów skompilowanych zostaną skopiowane do określonego katalogu, który nie jest zgodny z projektami wielokierunkowymi, a także projektami, które mają różne wersje zależności bezpośrednich i przechodnich. Aby uzyskać więcej informacji, zobacz Opcja na poziomie --output rozwiązania nie jest już prawidłowa dla poleceń związanych z kompilacją.

• -r|--runtime <RUNTIME_IDENTIFIER>

  Czyści folder wyjściowy określonego środowiska uruchomieniowego. Jest to używane podczas tworzenia samodzielnego wdrożenia .

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

  Określa, czy rejestrator terminalu ma być używany dla danych wyjściowych kompilacji. Wartość domyślna to auto, która najpierw weryfikuje środowisko przed włączeniem rejestrowania terminalu. Sprawdzanie środowiska sprawdza, czy terminal może korzystać z nowoczesnych funkcji wyjściowych i nie używa przekierowanych standardowych danych wyjściowych przed włączeniem nowego rejestratora. on Pomija sprawdzanie środowiska i włącza rejestrowanie terminalu. off Pomija sprawdzanie środowiska i używa domyślnego rejestratora konsoli.

  Rejestrator terminalu pokazuje fazę przywracania, po której następuje faza kompilacji. W każdej fazie obecnie projekty budowlane są wyświetlane w dolnej części terminalu. Każdy projekt, który tworzy, generuje dane wyjściowe zarówno docelowy programu MSBuild, który jest obecnie kompilowany, jak i ilość czasu spędzonego na tym obiekcie docelowym. Możesz wyszukać te informacje, aby dowiedzieć się więcej o kompilacji. Po zakończeniu kompilowania projektu zostanie napisana pojedyncza sekcja "ukończona kompilacja", która przechwytuje:

  • Nazwa utworzonego projektu.
  • Struktura docelowa (jeśli jest przeznaczona dla wielu celów).
  • Stan tej kompilacji.
  • Podstawowe dane wyjściowe tej kompilacji (która jest hiperlinkowana).
  • Każda diagnostyka wygenerowana dla tego projektu.

  Ta opcja jest dostępna począwszy od platformy .NET 8.

• -v|--verbosity <LEVEL>

  Ustawia poziom szczegółowości polecenia. Dozwolone wartości to q[uiet], , n[ormal]m[inimal], d[etailed], i diag[nostic]. Wartość domyślna to normal. Aby uzyskać więcej informacji, zobacz LoggerVerbosity.

Przykłady

• Wyczyść domyślną kompilację projektu:

  dotnet clean
  

• Wyczyść projekt utworzony przy użyciu konfiguracji wydania:

  dotnet clean --configuration Release