Partager via

Tâches MSBuild spécifiques à C++

  • Article

Les tâches fournissent le code exécuté pendant le processus de génération. Quand C++ est installé, les tâches suivantes sont disponibles, en plus de celles qui sont installées avec MSBuild. Pour plus d’informations, consultez Vue d’ensemble de MSBuild (C++).

Outre les paramètres pour chaque tâche, chaque tâche a également les paramètres suivants.

Paramètre Description
Condition Paramètre String facultatif.

Expression Boolean utilisée par le moteur MSBuild pour déterminer si cette tâche va être exécutée. Pour plus d’informations sur les conditions prises en charge par MSBuild, consultez Conditions.
ContinueOnError Paramètre facultatif. Peut contenir l’une des valeurs suivantes :

- WarnAndContinue ou true. En cas d’échec d’une tâche, l’exécution des tâches suivantes de l’élément Target et de la génération se poursuit, et toutes les erreurs de la tâche sont considérées comme des avertissements.
- ErrorAndContinue. En cas d’échec d’une tâche, l’exécution des tâches suivantes de l’élément Target et de la génération se poursuit, et toutes les erreurs de la tâche sont considérées comme des erreurs.
- ErrorAndStop ou false (par défaut). En cas d’échec d’une tâche, les tâches restantes de l’élément Target et de la génération ne sont pas exécutées, et tout l’élément Target ainsi que la génération sont considérés comme étant en échec.

Les versions de .NET Framework antérieures à 4.5 prenaient en charge uniquement les valeurs true et false.

Pour plus d’informations, voir Guide pratique : Ignorer les erreurs dans les tâches.
Intitulé Description
BscMake, tâche Encapsule l’outil Microsoft Browse Information Maintenance Utility (bscmake.exe).
CL (tâche) Encapsule l’outil Compilateur C++ (cl.exe).
CPPClean, tâche Supprime les fichiers temporaires créés par MSBuild quand un projet C++ est généré.
Tâche ClangCompile Encapsule l’outil Compilateur C++ (clang.exe).
Tâche CustomBuild Encapsule l’outil Compilateur C++ (cmd.exe).
Tâche FXC Utilisez des compilateurs de nuanceur HLSL dans le processus de génération.
GetOutOfDateItems Lit les tlogs anciens, écrit les nouveaux tlogs et retourne le jeu d’éléments qui ne sont pas à jour. (tâche d’assistance)
GetOutputFileName Obtient le nom du fichier de sortie pour cl et d’autres outils, qui permet de ne spécifier que le répertoire de sortie, le nom de fichier complet, ou rien du tout. (tâche d’assistance)
LIB (tâche) Inclut l’outil Gestionnaire de bibliothèques 32 bits de Microsoft (lib.exe) dans un wrapper.
Lier la tâche Encapsule l’outil Éditeur de liens C++ (link.exe).
MIDL (tâche) Inclut l’outil Compilateur MIDL (Microsoft Interface Definition Language) (midl.exe) dans un wrapper.
MT (tâche) Inclut l’outil Manifeste de Microsoft (mt.exe) dans un wrapper.
Tâche MultiToolTask Pas de description.
Tâche ParallelCustomBuild Exécutez des instances parallèles de la tâche CustomBuild.
RC (tâche) Inclut l’outil Compilateur de ressources Microsoft Windows (rc.exe) dans un wrapper.
Tâche SetEnv Définit ou supprime la valeur d’une variable d’environnement spécifiée.
Classe de base TrackedVCToolTask Hérite de VCToolTask.
VCMessage (tâche) Enregistre les messages d’avertissement et les messages d’erreur lors de la génération. (Non extensible. Utilisation interne uniquement.)
Classe de base VCToolTask Hérite de ToolTask.
XDCMake (tâche) Inclut dans un wrapper l’outil Documentation XML (xdcmake.exe), qui fusionne des fichiers de commentaires documentation XML (.xdc) dans un fichier .xml.
XSD (tâche) Inclut dans un wrapper l’outil Définition de schéma XML (xsd.exe), qui génère des fichiers de schéma ou de classe à partir d’une source. Voir la remarque ci-dessous.
Informations de référence sur MSBuild Décrit les éléments du système MSBuild.
Tâches Décrit des tâches, qui sont des unités de code pouvant être combinées pour produire une build.
Écriture de tâches Décrit comment créer une tâche.

Notes

À partir de Visual Studio 2017, xsd.exe n’est plus pris en charge par les projets C++. Vous pouvez toujours utiliser les API Microsoft.VisualC.CppCodeProvider en ajoutant manuellement CppCodeProvider.dll au GAC.