dotnet schoon

  • Artikel

Dit artikel is van toepassing op: ✔️ .NET Core 3.1 SDK en latere versies

Naam

dotnet clean - Schoont de uitvoer van een project op.

Samenvatting

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

Beschrijving

Met dotnet clean de opdracht wordt de uitvoer van de vorige build opgeschoond. Het wordt geïmplementeerd als een MSBuild-doel, dus het project wordt geëvalueerd wanneer de opdracht wordt uitgevoerd. Alleen de uitvoer die tijdens de build is gemaakt, worden opgeschoond. Zowel tussenliggende (obj) als uiteindelijke uitvoermappen (bin) worden opgeschoond.

Argumenten

PROJECT | SOLUTION

Het MSBuild-project of de oplossing die moet worden opgeschoond. Als er geen project- of oplossingsbestand is opgegeven, zoekt MSBuild in de huidige werkmap naar een bestand met een bestandsextensie die eindigt op proj of sln, en gebruikt dat bestand.

Opties

  • --artifacts-path <ARTIFACTS_DIR>

    Alle builduitvoerbestanden van de uitgevoerde opdracht worden weergegeven in submappen onder het opgegeven pad, gescheiden door project. Zie De indeling Artefacten-uitvoer voor meer informatie. Beschikbaar sinds .NET 8 SDK.

  • -c|--configuration <CONFIGURATION>

    Definieert de buildconfiguratie. De standaardinstelling voor de meeste projecten is Debug, maar u kunt de buildconfiguratie-instellingen in uw project overschrijven. Deze optie is alleen vereist bij het schoonmaken als u deze tijdens de buildtijd hebt opgegeven.

  • -f|--framework <FRAMEWORK>

    Het framework dat tijdens de build is opgegeven. Het framework moet worden gedefinieerd in het projectbestand. Als u het framework tijdens de build hebt opgegeven, moet u het framework opgeven tijdens het opschonen.

  • -?|-h|--help

    Hiermee wordt een beschrijving afgedrukt van het gebruik van de opdracht.

  • --interactive

    Hiermee kan de opdracht stoppen en wachten op invoer of actie van de gebruiker. Bijvoorbeeld om de verificatie te voltooien. Beschikbaar sinds .NET Core 3.0 SDK.

  • --nologo

    De opstartbanner of het copyrightbericht wordt niet weergegeven.

  • -o|--output <OUTPUT_DIRECTORY>

    De map met de buildartefacten die moeten worden opgeschoond. Geef de -f|--framework <FRAMEWORK> switch op met de uitvoermapswitch als u het framework hebt opgegeven toen het project werd gebouwd.

    • .NET 7.0.200 SDK en hoger

      Als u de optie opgeeft bij het --output uitvoeren van deze opdracht op een oplossing, verzendt de CLI een waarschuwing (een fout in 7.0.200) vanwege de onduidelijke semantiek van het uitvoerpad. De --output optie is niet toegestaan omdat alle uitvoer van alle gemaakte projecten wordt gekopieerd naar de opgegeven map, die niet compatibel is met projecten met meerdere doelgroepen, evenals projecten met verschillende versies van directe en transitieve afhankelijkheden. Zie De optie Op oplossingsniveau --output is niet meer geldig voor build-gerelateerde opdrachten voor meer informatie.

  • -r|--runtime <RUNTIME_IDENTIFIER>

    Schoont de uitvoermap van de opgegeven runtime op. Dit wordt gebruikt wanneer een zelfstandige implementatie is gemaakt.

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

    Hiermee geeft u op of de terminallogger moet worden gebruikt voor de build-uitvoer. De standaardwaarde is auto, waarmee eerst de omgeving wordt geverifieerd voordat u terminallogboekregistratie inschakelt. De omgevingscontrole controleert of de terminal in staat is moderne uitvoerfuncties te gebruiken en geen omgeleide standaarduitvoer gebruikt voordat de nieuwe logger wordt ingeschakeld. on slaat de omgevingscontrole over en schakelt terminallogboekregistratie in. off slaat de omgevingscontrole over en maakt gebruik van de standaardconsolelogger.

    De terminallogger toont u de herstelfase, gevolgd door de buildfase. Tijdens elke fase worden de huidige bouwprojecten onderaan de terminal weergegeven. Elk project dat wordt gebouwd, levert zowel het MSBuild-doel dat momenteel wordt gebouwd als de hoeveelheid tijd die aan dat doel is besteed. U kunt deze informatie doorzoeken voor meer informatie over de build. Wanneer een project klaar is met bouwen, wordt één sectie 'build completed' geschreven die het volgende vastlegt:

    • De naam van het gebouwde project.
    • Het doelframework (indien multi-targeted).
    • De status van die build.
    • De primaire uitvoer van die build (die is hyperlinked).
    • Diagnostische gegevens die voor dat project worden gegenereerd.

    Deze optie is beschikbaar vanaf .NET 8.

  • -v|--verbosity <LEVEL>

    Hiermee stelt u het uitgebreidheidsniveau van de opdracht in. Toegestane waarden zijnq[uiet], , , n[ormal]en diag[nostic]d[etailed]m[inimal]. De standaardwaarde is normal. Zie LoggerVerbosity voor meer informatie.

Voorbeelden

  • Een standaardbuild van het project opschonen:

    dotnet clean

  • Een project opschonen dat is gebouwd met behulp van de releaseconfiguratie:

    dotnet clean --configuration Release