VCBuild-Aufgabe
Aktualisiert: November 2007
Schließt vcbuild.exe ein, wodurch Visual C++-Projekte und Projektmappen, die Visual C++-Projekte enthalten, erstellt werden. Weitere Informationen hierzu finden Sie unter VCBUILD-Verweis.
Parameter
In der folgenden Tabelle werden die Parameter der VCBuild-Aufgabe beschrieben.
Parameter |
Beschreibung |
|---|---|
AdditionalLibPaths |
Optionaler ITaskItem[]-Parameter. Gibt zusätzliche Pfade an, die vor dem Ausführen von vcbuild.exe an die LIBPATH-Umgebungsvariable angefügt werden sollen. |
AdditionalOptions |
Optionaler String-Parameter. Gibt zusätzliche Befehlszeilenschalter an, für die keine dedizierten Aufgabenparameter vorhanden sind. |
Clean |
Optionaler Boolean-Parameter. Der Wert true gibt an, dass die Aufgabe nur bereinigte Buildausgaben ausgibt. Wenn der Rebuild-Parameter den Wert true aufweist, überschreibt er diesen Parameter. |
Configuration |
Optionaler String-Parameter. Gibt den Namen der Konfiguration und der Plattform für die Erstellung an. Beispiel: Debug|Win32. Dieser Parameter kann auch verwendet werden, um nur den Konfigurationsnamen anzugeben. |
Override |
Optionaler ITaskItem-Parameter. Gibt den Speicherort einer Datei mit einem VCBuild-Eigenschaftenblatt an, die Projektdateieinstellungen überschreibt. |
Platform |
Optionaler String-Parameter. Gibt den Namen der Plattform an, für die das Build erstellt wird. |
Projects |
Erforderlicher ITaskItem[]-Parameter. Gibt die zu erstellenden Projekte an. |
Rebuild |
Optionaler Boolean-Parameter. Der Wert true gibt an, dass die Aufgabe vor dem Erstellen eines Builds die Buildausgaben bereinigt. Dieser Parameter überschreibt den Clean-Parameter. |
SolutionFile |
Optionaler ITaskItem-Parameter. Gibt beim Erstellen von Projektmappen den vollständigen Pfad zur Projektmappendatei an. Dieser Parameter wird verwendet, um projektmappenbezogene Visual C++-Projektmakros aufzulösen. |
Timeout |
Optionaler Int32-Parameter. Gibt die Zeit in Millisekunden an, nach der die ausführbare Datei der Aufgabe beendet wird. Der Standardwert lautet Int.MaxValue. Dieser gibt an, dass kein Timeoutintervall festgelegt ist. |
ToolPath |
Optionaler String-Parameter. Gibt den Speicherort an, von dem die -Aufgabe die zugrunde liegende ausführbare Datei (vcbuild.exe) lädt. Wird dieser Parameter nicht angegeben, verwendet die Aufgabe den SDK-Installationspfad für die Framework-Version, in der MSBuild ausgeführt wird. |
UseEnvironment |
Optionaler Boolean-Parameter. true, damit Umgebungsvariablen für INCLUDE- und LIB-Pfade verwendet werden; andernfalls false. |
AdditionalLinkLibraryPaths |
Optionaler String-Parameter. Gibt weitere Verweisspeicherorte an, die an die LIB-Umgebungsvariable angefügt werden. Link.exe verwendet den LIB-Pfad für die Suche nach einer Datei, die in der Link-Befehlszeile angegeben wurde, wie ein Objekt oder eine Bibliothek. Lib.exe verwendet keine Umgebungsvariable. |
Beispiel
Im folgenden Beispiel wird die VCBuild-Aufgabe verwendet, um die von der vcprojects-Elementauflistung angegebenen Projekte zu erstellen.
<VCBuild
Projects="@(vcprojects)"
Configuration="$(configuration)"
Rebuild="true"/>