Team Foundation Build-Aufgaben
Aktualisiert: November 2007
Die MSBuild-Aufgaben sind in Zielen enthalten. Diese Aufgaben stellen den Code bereit, der während des Buildprozesses ausgeführt wird. MSBuild enthält eine Bibliothek mit allgemeinen Aufgaben. Weitere Informationen finden Sie unter Referenz zu MSBuild-Aufgaben.
Die MSBuild-TARGETS-Datei für Team Foundation Build, Microsoft.TeamFoundation.Build.targets, definiert mehrere Team Foundation Build-Standardaufgaben, die Sie durch Festlegen von Eigenschaften in der Datei TfsBuild.proj anpassen können. Das CoreGet-Ziel enthält beispielsweise eine Get-Aufgabe, mit der Sie ein bestimmtes Changeset für einen Buildtyp abrufen können. In der Standardeinstellung werden von der Get-Aufgabe die letzten Dateien abgerufen. Weitere Informationen zu TARGETS-Dateien finden Sie unter .Targets-Dateien von MSBuild.
Liste der Standardaufgaben in Microsoft.TeamFoundation.Build.targets
Die folgenden Aufgaben können durch eine Änderung ihrer Eigenschaften angepasst werden.
Team Foundation Build-Aufgabe |
Zugeordnetes Ziel |
|---|---|
|
Synchronisiert die Quellen auf dem Buildcomputer. Außerdem werden Protokollereignisse ausgelöst, um Informationen über jede Datei und jede Version, die in den lokalen Arbeitsbereich abgerufen wurde, zu protokollieren. |
Get |
|
Bezeichnet alle Quelldateien eines angegebenen Arbeitsbereichs. |
Label |
GenCheckinNotesUpdateWorkItems-Aufgabe Generiert die Liste aller Changesets und Arbeitsaufgaben, die während eines Builds erstellt oder geändert wurden. Bezeichnungen werden zur Markierung eines bestimmten Builds verwendet. |
Das GetChangeSetsAndUpdateWorkitems-Ziel wird aufgerufen, wenn der Build erfolgreich abgeschlossen wird. Das GetChangeSetsOnBuildBreak-Ziel wird aufgerufen, wenn der Build nicht erfolgreich abgeschlossen wird. |
|
Erstellt eine neue Arbeitsaufgabe für Fehler, die während des Buildprozesses auftreten. Darüber hinaus wird das Feld Found In in der Arbeitsaufgabe mit einer Verknüpfung zur jeweiligen Buildnummer aktualisiert. |
CreateWorkItem |
|
Erstellt einen neuen Arbeitsbereich auf dem Buildcomputer. |
InitializeWorkspace |
|
Löscht den während der Buildausführung erstellten Arbeitsbereich. Die enthaltenen Dateien bleiben jedoch auf dem Buildcomputer erhalten. Wenn der angegebene Arbeitsbereich nicht vorhanden ist, gibt DeleteWorkspaceTask eine Warnung aus. |
InitializeWorkspace |
UpdateBuildNumberDropLocation-Aufgabe Erstellt an einem angegebenen Speicherort einen Ordner für die erstellten Dateien. Darüber hinaus wird die Buildnummer aktualisiert. |
InitializeEndToEndIteration |
|
Führt eine Reihe von Tests während des Builds aus und veröffentlicht die Ergebnisse. |
RunTestWithConfiguration |
|
Fügt die Buildschritte in den Build ein. |
Keine |
|
Gibt die Anfangswerte für die Buildeigenschaften aus. |
InitializeBuildProperties |
|
Legt jede festzulegende Eigenschaft auf dem Build fest. |
Keine |
WorkspaceItemConverterTask-Aufgabe Konvertiert die Elemente des Versionskontrollservers in Elemente des lokalen Arbeitsbereichs und die lokalen Elemente in Elemente des Versionskontrollservers. |
ResolveSolutionPathsForEndToEndIteration and ResolveTestFilesForEndToEndIteration |
Ändern von Team Foundation Build-Aufgaben
Um die in der Definitionsdatei Microsoft.TeamFoundation.Build.targets definierten Aufgaben zu ändern, überprüfen Sie die Eigenschaften der Aufgabe, die Sie ändern möchten, und legen diese Eigenschaften anschließend in der Datei TfsBuild.proj Ihres Team Foundation Build-Buildtyps fest. Die CreateNewWorkItem-Aufgabe wird folgendermaßen definiert.
<!-- Create WorkItem for build failure -->
<CreateNewWorkItem
BuildId="$(BuildNumber)"
Description="$(WorkItemDescription)"
TeamProject="$(TeamProject)"
TeamFoundationServerUrl="$(TeamFoundationServerUrl)"
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:
.gif "Hinweis") Hinweis: |
|---|
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
Konzepte
Team Foundation Build-Konfigurationsdateien