VCBuild, tâche
Mise à jour : novembre 2007
Encapsule vcbuild.exe, qui génère des projets et des solutions Visual C++ contenant des projets Visual C++. Pour plus d'informations, consultez Référence VCBUILD.
Paramètres
Le tableau suivant décrit les paramètres de la tâche VCBuild.
Paramètre |
Description |
|---|---|
AdditionalLibPaths |
Paramètre ITaskItem[] facultatif. Spécifie des chemins d'accès supplémentaires à ajouter à la variable d'environnement LIBPATH avant d'exécuter vcbuild.exe. |
AdditionalOptions |
Paramètre String facultatif. Spécifie des commutateurs de ligne de commande supplémentaires qui n'ont pas de paramètre de tâche dédié. |
Clean |
Paramètre Boolean facultatif. true pour spécifier que la tâche génère uniquement des résultats de génération nettoyés. Si le paramètre Rebuild a la valeur true, il se substitue à ce paramètre. |
Configuration |
Paramètre String facultatif. Spécifie le nom de la configuration et de la plateforme à utiliser pour la génération. Par exemple : Debug|Win32. Ce paramètre peut également être utilisé pour spécifier uniquement le nom de configuration. |
Override |
Paramètre ITaskItem facultatif. Spécifie l'emplacement d'un fichier de feuille de propriétés VCBuild qui substitue des paramètres de fichier projet. |
Platform |
Paramètre String facultatif. Spécifie le nom de la plateforme à générer. |
Projects |
Paramètre ITaskItem[] obligatoire. Spécifie les projets à générer. |
Rebuild |
Paramètre Boolean facultatif. true pour spécifier que la tâche nettoie les sorties de génération avant d'exécuter une génération. Ce paramètre se substitue au paramètre Clean. |
SolutionFile |
Paramètre ITaskItem facultatif. Spécifie le chemin d'accès complet au fichier solution lors de la génération de solutions. Ce paramètre est utilisé pour résoudre des macros de projets Visual C++ relatifs aux solutions. |
Timeout |
Paramètre Int32 facultatif. Spécifie la durée, en millisecondes, après laquelle la tâche exécutable est terminée. La valeur par défaut est Int.MaxValue, indiquant qu'il n'existe aucun délai d'attente. |
ToolPath |
Paramètre String facultatif. Spécifie l'emplacement à partir duquel la tâche charge le fichier exécutable sous-jacent (vcbuild.exe). Si ce paramètre n'est pas spécifié, la tâche utilise le chemin d'accès d'installation du Kit de développement logiciel qui correspond à la version de l'infrastructure exécutant MSBuild. |
UseEnvironment |
Paramètre Boolean facultatif. true pour utiliser des variables d'environnement pour les chemins d'accès INCLUDE et LIB ; sinon, false. |
AdditionalLinkLibraryPaths |
Paramètre String facultatif. Spécifie des dossiers de référence supplémentaires à ajouter à la variable d'environnement LIB. Link.exe utilise le chemin d'accès LIB lorsqu'il recherche un fichier spécifié sur la ligne de commande Link, tel qu'un objet ou une bibliothèque. Lib.exe n'utilise pas de variable d'environnement. |
Exemple
L'exemple suivant utilise la tâche VCBuild pour générer les projets spécifiés par la collection d'éléments vcprojects.
<VCBuild
Projects="@(vcprojects)"
Configuration="$(configuration)"
Rebuild="true"/>