dotnet clean

Cet article s’applique à : ✔️ SDK .NET Core 6 et versions ultérieures

Nom

dotnet clean - Nettoie la sortie d’un projet.

Synopsis

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

Descriptif

La dotnet clean commande nettoie la sortie de la build précédente. Elle est implémentée en tant que cible MSBuild. Par conséquent, le projet est évalué lors de l’exécution de la commande. Seules les sorties créées pendant la génération sont nettoyées. Les dossiers intermédiaires (obj) et de sortie finale (bin) sont nettoyés.

Arguments

PROJECT | SOLUTION | FILE

Fichier projet ou solution ou C# (application basée sur des fichiers) sur lequel fonctionner. Si aucun fichier n’est spécifié, MSBuild recherche dans le répertoire actif un projet ou une solution.

• PROJECT est le chemin d’accès et le nom de fichier d’un fichier projet C#, F# ou Visual Basic, ou le chemin d’un répertoire qui contient un fichier projet C#, F# ou Visual Basic.

• SOLUTION est le chemin d’accès et le nom de fichier d’un fichier solution (.sln ou extension .slnx), ou le chemin d’accès à un répertoire qui contient un fichier solution.

• FILE est un argument ajouté dans .NET 10. Chemin d’accès et nom de fichier d’une application basée sur un fichier. Les applications basées sur des fichiers sont contenues dans un fichier unique généré et exécuté sans fichier de projet (.csproj) correspondant. Pour plus d’informations, consultez Générer des applications C# basées sur des fichiers.

Options

• --artifacts-path <ARTIFACTS_DIR>

  Tous les fichiers de sortie de build de la commande exécutée vont dans les sous-dossiers sous le chemin spécifié, séparés par projet. Pour plus d’informations, consultez Disposition de sortie d’artefacts. Disponible depuis le Kit de développement logiciel (SDK) .NET 8.

• -c|--configuration <CONFIGURATION>

  Définit la configuration de build. La valeur par défaut pour la plupart des projets est Debug, mais vous pouvez remplacer les paramètres de configuration de build dans votre projet. Cette option n’est requise que lors du nettoyage si vous l’avez spécifiée pendant la génération.

• -f|--framework <FRAMEWORK>

  Framework spécifié au moment de la génération. L’infrastructure doit être définie dans le fichier projet. Si vous avez spécifié l’infrastructure au moment de la génération, vous devez spécifier l’infrastructure lors du nettoyage.

• -?|-h|--help

  Imprime une description de l’utilisation de la commande.

• --interactive

  Permet à la commande d’arrêter et d’attendre l’entrée ou l’action de l’utilisateur. Par exemple, pour terminer l’authentification.

• --nologo

  N’affiche pas la bannière de démarrage ou le message de copyright.

• -o|--output <OUTPUT_DIRECTORY>

  Répertoire qui contient les artefacts de build à nettoyer. Spécifiez le commutateur avec le -f|--framework <FRAMEWORK> commutateur de répertoire de sortie si vous avez spécifié l’infrastructure lors de la génération du projet.

  • Sdk .NET 7.0.200 et versions ultérieures

    Si vous spécifiez l’option lors de l’exécution --output de cette commande sur une solution, l’interface CLI émet un avertissement (erreur dans la version 7.0.200) en raison de la sémantique peu claire du chemin de sortie. L’option --output n’est pas autorisée, car toutes les sorties de tous les projets générés sont copiées dans le répertoire spécifié, ce qui n’est pas compatible avec les projets multi-ciblés, ainsi que les projets qui ont différentes versions de dépendances directes et transitives. Pour plus d’informations, consultez l’option au niveau --output de la solution qui n’est plus valide pour les commandes liées à la génération.

• -r|--runtime <RUNTIME_IDENTIFIER>

  Nettoie le dossier de sortie du runtime spécifié. Cela est utilisé lorsqu’un déploiement autonome a été créé.

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

  Spécifie si Terminal Logger doit être utilisé pour la sortie de build. La valeur par défaut est , qui vérifie d’abord autol’environnement avant d’activer la journalisation de terminal. La vérification de l’environnement vérifie que le terminal est capable d’utiliser des fonctionnalités de sortie modernes et n’utilise pas de sortie standard redirigée avant d’activer le nouvel enregistreur d’événements. on ignore la vérification de l’environnement et active la journalisation des terminaux. off ignore la vérification de l’environnement et utilise l’enregistreur d’événements de console par défaut.

  Terminal Logger vous montre la phase de restauration suivie de la phase de génération. Au cours de chaque phase, les projets en cours de création apparaissent en bas du terminal. Chaque projet généré génère à la fois la cible MSBuild en cours de génération et le temps consacré à cette cible. Vous pouvez rechercher ces informations pour en savoir plus sur la build. Lorsqu’un projet est terminé, une seule section « build terminée » est écrite qui capture :

  • Nom du projet généré.
  • Framework cible (s’il est multi-ciblé).
  • État de cette build.
  • Sortie principale de cette build (qui est en lien hypertexte).
  • Tous les diagnostics générés pour ce projet.

  Cette option est disponible à partir de .NET 8.

• -v|--verbosity <LEVEL>

  Définit le niveau de détail de la commande. Les valeurs autorisées sont q[uiet], m[inimal], n[ormal], d[etailed] et diag[nostic]. La valeur par défaut est normal. Pour plus d’informations, consultez LoggerVerbosity.

Examples

• Nettoyez une build par défaut du projet :

  dotnet clean
  

• Nettoyer un programme basé sur un fichier :

  dotnet clean Program.cs.
  

  La prise en charge des applications basée sur des fichiers a été ajoutée dans le Kit de développement logiciel (SDK) .NET 10.0.100.

• Nettoyez un projet généré à l’aide de la configuration release :

  dotnet clean --configuration Release