Anpassbare Team Foundation-Buildeigenschaften
MSBuild-Eigenschaften sind Schlüssel-Wert-Paare, die Sie zum Konfigurieren von Builds verwenden können. Weitere Informationen finden Sie unter MSBuild-Eigenschaften.
In der Datei Microsoft.TeamFoundation.Build.targets sind verschiedene MSBuild-Ziele, -Aufgaben und -Eigenschaften für Team Foundation Build definiert. Sie können diese Eigenschaften in der Datei TFSBuild.proj ändern, um folgende Aufgaben auszuführen:
Übergeben Sie Werte an Team Foundation Build-Aufgaben und -Ziele.
Überschreiben Sie bestimmte Buildvorgänge.
Weitere Informationen zur Datei TFSBuild.proj finden Sie unter Team Foundation Build-Konfigurationsdateien.
Inhalt dieses Dokuments
Anpassen von Visual C++-Builds
Eigenschaften zum Anpassen von Aufgaben
Überschreibbare Eigenschaften
In der folgenden Tabelle werden die für Team Foundation Build definierten Eigenschaften aufgelistet. Sie können sie in der Datei TfsBuild.proj überschreiben, um den Buildprozess anzupassen. Weitere Informationen finden Sie unter Anpassen der SolutionToBuild-Elementgruppe.
Eigenschaft |
Beschreibung |
|---|---|
BinariesRoot |
Legen Sie diese Eigenschaft fest, um auf das Stammverzeichnis des Binärdatenordners auf dem Buildcomputer zu verweisen. |
CleanCompilationOutputOnly |
Legen Sie diese Eigenschaft auf true fest, um während der CoreClean-Zielausführung nur die temporären Assemblys aus dem Quellverzeichnis zu löschen. Wenn diese Eigenschaft auf false festgelegt ist, wird während der CoreClean-Zielausführung das gesamte Quellverzeichnis gelöscht. |
CustomizableOutDir |
Legen Sie diese Eigenschaft auf true fest, wenn Sie verhindern möchten, dass Team Foundation Build für jede Projektmappe OutDir festlegt. Beachten Sie, dass Sie die TeamBuildOutDir-Eigenschaft verwenden können, um den Wert abzurufen, den Team Foundation Build PublishDir zugeordnet hätte, wenn CustomizableOutDir auf false festgelegt wäre. |
CustomizablePublishDir |
Legen Sie diese Eigenschaft auf true fest, wenn Sie verhindern möchten, dass Team Foundation Build für jede Projektmappe das PublishDir-Verzeichnis festlegt. Beachten Sie, dass Sie die TeamBuildPublishDir-Eigenschaft verwenden können, um den Wert abzurufen, den Team Foundation Build PublishDir zugeordnet hätte, wenn CustomizablePublishDir auf false festgelegt worden wäre. |
CustomPropertiesForBuild |
Legen Sie diese Eigenschaft fest, um benutzerdefinierte Werte in jede Projektmappe zu übergeben, wenn Team Foundation Build das Standardziel aufruft (in der Regel Build). |
CustomPropertiesForClean |
Legen Sie diese Eigenschaft fest, um benutzerdefinierte Werte in jede Projektmappe zu übergeben, wenn Team Foundation Build das Clean-Ziel aufruft. |
GetAllowUnmapped |
Legen Sie diese Eigenschaft auf false fest, um beim Ausführen des Builds einen Fehler auszulösen, wenn in einem Shelveset nicht zugeordnete Dateien vorhanden sind (für Builds mit abgegrenztem Eincheckvorgang und private Builds). |
GetAutoMerge |
Legen Sie diese Eigenschaft auf false fest, um beim Ausführen des Builds einen Fehler auszulösen, wenn während des get-Vorgangs der Versionskontrolle in einem Build mit abgegrenztem Eincheckvorgang oder privaten Build Konflikte vorliegen. |
GetNoCIOption |
Legen Sie diese Eigenschaft auf false fest, um beim Ausführen eines Builds mit abgegrenztem Eincheckvorgang das Einfügen der Zeichenfolge ***NO_CI*** in die Eincheckkommentare auszuschließen. Beachten Sie, dass bei Festlegung dieser Eigenschaft auf false betroffene, aufeinander folgende Integrationsbuilds in die Warteschlange gestellt werden. |
IncrementalBuild |
Legen Sie diese Eigenschaft auf true fest, um einen inkrementellen Build durchzuführen. Dies ist eine benutzerfreundliche Eigenschaft, die SkipClean auf true, SkipInitializeWorkspace auf true und ForceGet auf false festlegt. |
IncrementalGet |
Legen Sie diese Eigenschaft auf true fest, um einen inkrementellen Abruf durchzuführen. Dies ist eine benutzerfreundliche Eigenschaft, die CleanCompilationOutputOnly auf true, SkipInitializeWorkspace auf true und ForceGet auf false festlegt. |
LabelComment |
Legen Sie diese Eigenschaft fest, um den von der Label-Aufgabe verwendeten Kommentar zu definieren. |
LabelName |
Legen Sie diesen Bezeichnungsnamen fest, um den von der Label-Aufgabe verwendeten Namen zu definieren. Standardmäßig ist der Bezeichnungsname für das InitializeEndToEndIteration-Ziel auf $(BuildNumber) gesetzt. |
OutDir |
Legen Sie diese Eigenschaft fest, um den Speicherort der Ausgabedateien im Buildarbeitsverzeichnis zu definieren. |
PerformTestImpactAnalysis |
Legen Sie diese Eigenschaft auf false fest, um Testauswirkungsanalyse zu deaktivieren. |
PublishTestResults |
Legen Sie diese Eigenschaft auf false fest, um die Veröffentlichung der Testergebnisse zu überspringen. |
SkipClean |
Legen Sie diese Eigenschaft fest, um das CoreClean-Ziel zu überspringen. |
SkipDropBuild |
Legen Sie diese Eigenschaft fest, um das CoreDropBuild-Ziel zu überspringen. |
SkipGet |
Legen Sie diese Eigenschaft fest, um das CoreGet-Ziel zu überspringen. |
SkipGetChangesetsAndUpdateWorkItems |
Legen Sie diese Eigenschaft auf true fest, um die Zuordnung von Changesets und die Aktualisierung von Arbeitsaufgaben für erfolgreiche Builds zu überspringen. |
SkipInitializeWorkspace |
Legen Sie diese Eigenschaft fest, um das CoreInitializeWorkspace-Ziel zu überspringen. |
SkipInvalidConfigurations |
Legen Sie diese Eigenschaft auf false fest, um anstelle einer Warnung einen Fehler zu generieren, wenn der Benutzer eine ungültige Konfiguration findet. |
SkipLabel |
Legen Sie diese Eigenschaft fest, um das CoreLabel-Ziel zu überspringen. |
SkipPostBuild |
Legen Sie diese Eigenschaft fest, um das Erfassen zugeordneter Changesets und Arbeitsaufgaben zu überspringen. |
SkipWorkItemCreation |
Legen Sie diese Eigenschaft fest, um das CoreCreateWorkItem-Ziel zu überspringen. |
SolutionRoot |
Legen Sie diese Eigenschaft fest, um auf das Stammverzeichnis des Quellordners auf dem Buildcomputer zu verweisen. |
StopOnFirstFailure |
Legen Sie diese Eigenschaft auf true fest, um beim ersten Fehler während der Buildausführung das Bereinigen, Kompilieren und/oder Testen anzuhalten. |
UpdateAssociatedWorkItemsOnBuildBreak |
Legen Sie diese Eigenschaft auf true fest, um zugeordnete Arbeitsaufgaben sogar für einen beschädigten Build zu aktualisieren. |
Anpassen von Visual C++-Builds
Team Foundation Build unterstützt auch das Anpassen der Erstellung von Visual C++ 9.0-Projekten. Sie können die folgenden Eigenschaften verwenden, um entsprechende Eigenschaften für die VCBuild-Aufgabe festzulegen, die von MSBuild für das Erstellen von Visual C++-Projekten verwendet wird. Weitere Informationen finden Sie unter VCBuild Task.
Team Build-Eigenschaft |
VCBuild-Aufgabeneigenschaft |
Beschreibung |
|---|---|---|
VCBuildAdditionalLibPaths |
AdditionalLibPaths |
Gibt zusätzliche Pfade an, die nach Bibliotheken durchsucht werden, bevor die Pfade der LIB-Umgebungsvariablen durchsucht werden (entspricht der LIBPATH-Option für LINK.exe). |
VCBuildAdditionalOptions |
AdditionalOptions |
Gibt zusätzliche Befehlszeilenoptionen an, für die keine dedizierten Aufgabenparameter vorhanden sind. |
VCBuildToolPath |
ToolPath |
Gibt den Speicherort an, von dem die VCBuild-Aufgabe die zugrunde liegende ausführbare Datei (VCBuild.exe) lädt. |
VCBuildUseEnvironment |
UseEnvironment |
Legen Sie diese Eigenschaft auf true fest, um Umgebungsvariablen für PATH, INCLUDE, LIBS und LIBPATH zu verwenden. Legen Sie sie andernfalls auf false fest. Diese Eigenschaft entspricht der /useenv-Option für VCBuild.exe. Weitere Informationen finden Sie unter / useenv. |
AdditionalVCOverrides |
Nein |
Geben Sie mit dieser Eigenschaft zusätzliche Optionen für die VCBuild-Aufgabenblätterdatei(en) an, die von Team Foundation Build generiert und in der Override-Eigenschaft der VCBuild-Aufgabe angegeben werden. |
Eigenschaften zum Anpassen von Aufgaben
Jede Standardaufgabe von Team Foundation Build in der Datei Microsoft.TeamFoundation.Build.targets enthält auch einen Satz von Eigenschaften, die Sie zum Anpassen der Aufgabe verwenden können. Weitere Informationen zu Team Foundation Build-Aufgaben finden Sie unter Team Foundation Build-Aufgaben. Zum Beispiel wird die CreateNewWorkItem-Aufgabe folgendermaßen definiert.
<!-- Create WorkItem for build failure -->
<CreateNewWorkItem
TeamFoundationServerUrl="$(TeamFoundationServerUrl)"
BuildUri="$(BuildUri)"
BuildNumber="$(BuildNumber)"
Description="$(WorkItemDescription)"
TeamProject="$(TeamProject)"
Title="$(WorkItemTitle)"
WorkItemFieldValues="$(WorkItemFieldValues)"
WorkItemType="$(WorkItemType)"
ContinueOnError="true" />
Zum Anpassen der Arbeitsaufgabe, die bei einem Buildfehler erstellt wird, legen Sie in der Datei TFSBuild.proj WorkItemFieldValues fest, wie im Folgenden dargestellt:
Tipp
Im folgenden Beispiel wird davon ausgegangen, dass die Areapath-Eigenschaft und die IterationPath-Eigenschaft bereits festgelegt wurden.
<WorkItemFieldValues>Area Path=$(AreaPath);Iteration Path=$(IterationPath);Severity=1;Priority=0;Symptom=build break;Steps To Reproduce=Start the build using Team Build;Source=Development;How Found=Build Break;Assigned To=Active</WorkItemFieldValues>
Siehe auch
Aufgaben
Gewusst wie: Verwenden von Umgebungsvariablen in einem Build