dotnet clean

  • Artikel

Den här artikeln gäller för: ✔️ .NET Core 3.1 SDK och senare versioner

Name

dotnet clean – Rensar utdata från ett projekt.

Sammanfattning

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

beskrivning

Kommandot dotnet clean rensar utdata från den tidigare versionen. Det implementeras som ett MSBuild-mål, så projektet utvärderas när kommandot körs. Endast de utdata som skapades under bygget rensas. Både mellanliggande (obj) och slutliga utdatamappar (lagerplats) rensas.

Argument

PROJECT | SOLUTION

MSBuild-projektet eller lösningen för att rensa. Om ett projekt eller en lösningsfil inte har angetts söker MSBuild i den aktuella arbetskatalogen efter en fil som har ett filnamnstillägg som slutar i proj eller sln och använder den filen.

Alternativ

  • --artifacts-path <ARTIFACTS_DIR>

    Alla build-utdatafiler från det körda kommandot kommer att gå i undermappar under den angivna sökvägen, avgränsade med projekt. Mer information finns i Artefaktutdatalayout. Tillgänglig sedan .NET 8 SDK.

  • -c|--configuration <CONFIGURATION>

    Definierar byggkonfigurationen. Standardvärdet för de flesta projekt är Debug, men du kan åsidosätta konfigurationsinställningarna för bygget i projektet. Det här alternativet krävs bara när du rensar om du angav det under byggtiden.

  • -f|--framework <FRAMEWORK>

    Ramverket som angavs vid bygget. Ramverket måste definieras i projektfilen. Om du angav ramverket vid byggtiden måste du ange ramverket vid rensning.

  • -?|-h|--help

    Skriver ut en beskrivning av hur du använder kommandot.

  • --interactive

    Tillåter att kommandot stoppar och väntar på användarens indata eller åtgärd. Till exempel för att slutföra autentiseringen. Tillgänglig sedan .NET Core 3.0 SDK.

  • --nologo

    Visar inte startbanderollen eller upphovsrättsmeddelandet.

  • -o|--output <OUTPUT_DIRECTORY>

    Katalogen som innehåller de byggartefakter som ska rensas. Ange växeln -f|--framework <FRAMEWORK> med utdatakatalogväxeln om du angav ramverket när projektet skapades.

    • .NET 7.0.200 SDK och senare

      Om du anger --output alternativet när du kör det här kommandot på en lösning genererar CLI en varning (ett fel i 7.0.200) på grund av den oklara semantiken i utdatasökvägen. Alternativet --output är inte tillåtet eftersom alla utdata från alla inbyggda projekt kopieras till den angivna katalogen, som inte är kompatibel med flera målprojekt, samt projekt som har olika versioner av direkta och transitiva beroenden. Mer information finns i Alternativet på lösningsnivå --output är inte längre giltigt för build-relaterade kommandon.

  • -r|--runtime <RUNTIME_IDENTIFIER>

    Rensar utdatamappen för den angivna körningen. Detta används när en fristående distribution skapades.

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

    Anger om terminalloggaren ska användas för byggutdata. Standardvärdet är auto, som först verifierar miljön innan du aktiverar terminalloggning. Miljökontrollen verifierar att terminalen kan använda moderna utdatafunktioner och inte använder en omdirigerad standardutdata innan den nya loggaren aktiveras. on hoppar över miljökontrollen och aktiverar terminalloggning. off hoppar över miljökontrollen och använder standardkonsolloggaren.

    Terminalloggaren visar återställningsfasen följt av byggfasen. Under varje fas visas de pågående byggprojekten längst ned i terminalen. Varje projekt som skapar utdata både det MSBuild-mål som för närvarande skapas och hur lång tid som spenderas på det målet. Du kan söka efter den här informationen om du vill veta mer om bygget. När ett projekt är färdigt skrivs ett enda "build completed"-avsnitt som samlar in:

    • Namnet på det skapade projektet.
    • Målramverket (om det är flera mål).
    • Status för bygget.
    • Den primära utdatan för den versionen (som är hyperlänkad).
    • Diagnostik som genereras för projektet.

    Det här alternativet är tillgängligt från och med .NET 8.

  • -v|--verbosity <LEVEL>

    Anger kommandots verbositetsnivå. Tillåtna värden är q[uiet], m[inimal], n[ormal], d[etailed]och diag[nostic]. Standardvärdet är normal. Mer information finns i LoggerVerbosity.

Exempel

  • Rensa en standardversion av projektet:

    dotnet clean

  • Rensa ett projekt som skapats med hjälp av versionskonfigurationen:

    dotnet clean --configuration Release