Freigeben über


Team Foundation Build-Konfigurationsdateien

Aktualisiert: November 2007

Team Foundation Build verwendet das MSBuild-Modul. Der Team Foundation Build-Prozess wird durch eine Reihe von XML-Dateien gesteuert, die dem MSBuild-Projektdateischema entsprechen. Die folgenden Elemente in diesen XML-Dateien sind für den Buildprozess wichtig:

  • Target-Element   Das Target-Element definiert, wie das Projekt erstellt wird. Target-Elemente enthalten eine Reihe von Aufgaben, die von MSBuild sequenziell ausgeführt werden. Weitere Informationen zu Zielen finden Sie unter MSBuild-Ziele.

  • Task-Element   Mit dem Task-Element wird der beim Buildprozess ausgeführte Code angegeben. Weitere Informationen zu Aufgaben finden Sie unter MSBuild-Aufgaben.

    MSBuild enthält eine Auflistung von allgemeinen Aufgaben, die Sie zum Anpassen des Buildprozesses verwenden können. Weitere Informationen finden Sie unter Referenz zu MSBuild-Aufgaben.

  • UsingTask-Element   Mit dem UsingTask-Element wird die Assembly angegeben, in der die Aufgaben für den Buildprozess enthalten sind.

In die MSBuild-Skriptdateien können andere Skriptdateien importiert werden. Sie können z. B. eine allgemeine Konfiguration in einer Datei definieren und diese anschließend in andere Konfigurationen einschließen. Weitere Informationen finden Sie unter Gewusst wie: Verwenden eines Ziels in mehreren Projektdateien.

Der Team Foundation Build-Prozess wird durch zwei Dateien gesteuert:

  • Microsoft.TeamFoundation.Build.targets

    Diese Datei definiert die Standardaufgaben und -ziele, die in Team Foundation Build enthalten sind, beispielsweise Clean, DropBuild und Compile. Jedes Ziel enthält die Aufgaben, die für dieses bestimmte Ziel aufgerufen werden. Einige Ziele in dieser Datei sind von anderen Zielen abhängig, sodass eine Kette von Zielen entsteht, die in einer bestimmten Reihenfolge ausgeführt werden. Beispielsweise ist das Ziel Compile vom Ziel BeforeCompile abhängig, sodass sämtliche im Ziel BeforeCompile definierten Aufgaben vor Compile ausgeführt werden. Es werden nicht unbedingt alle in dieser Datei definierten Ziele in jedem Build ausgeführt. Zum Beispiel führen Desktopbuilds das Ziel Clean nicht aus.

    Die Datei Microsoft.TeamFoundation.Build.targets ist in Visual Studio Team System enthalten und befindet sich im Verzeichnis <root>:\Programme\MSBuild\Microsoft\VisualStudio\TeamBuild\. Es ist nur eine Kopie dieser Datei auf einem Computer vorhanden, und sie wird von allen auf diesem Computer ausgeführten Builds gemeinsam verwendet.

    Wichtiger Hinweis:

    Nehmen Sie keine Änderungen an Microsoft.TeamFoundation.Build.targets vor. Wenn diese Datei geändert wird, wirkt sich dies auf alle Builddefinitionen aus. Um Builddefinitionen anzupassen, müssen Sie die ihnen zugeordnete Datei TfsBuild.proj ändern.

  • TfsBuild.proj

    Dies ist die Hauptkonfigurationsdatei für Team Foundation Build. Sie kann nur einer Builddefinition zugeordnet oder von mehreren Builddefinitionen gemeinsam genutzt werden. Diese Datei speichert die Konfigurationsparameter, die Sie im MSBuild-Projektdateierstellungs-Assistent bereitstellen. Dazu gehören das Teamprojekt, der bei Buildunterbrechungen erstellte Typ der Arbeitsaufgabe, die zu erstellende Konfiguration und die zu erstellenden Projektmappen. Der MSBuild-Projektdateierstellungs-Assistent erstellt diese Datei, wenn Sie eine neue Projektdatei für eine neue Builddefinition erstellen. Weitere Informationen hierzu finden Sie unter Gewusst wie: Erstellen einer Builddefinition. Microsoft.TeamFoundation.Build.targets wird in diese Datei importiert, und die Datei wird dann an MSBuild übergeben. Alle an dieser Datei vorgenommenen Änderungen wirken sich auf die Builds aller der Datei zugeordneten Builddefinitionen aus. Diese Datei wird standardmäßig in der Quellcodeverwaltung im Ordner $\MyProject\TeamBuildTypes\BuildDefinition gespeichert, wobei MyProject dem Teamprojektnamen und BuildDefinition dem Namen der Builddefinition entspricht. Sie können diese Datei auch in einem anderen Speicherort speichern, indem Sie den Pfad im Dialogfeld Builddefinition angeben.

    Im Kommentartext der Datei TfsBuild.proj sind Verwendungsbeispiele angegeben. Diese Beispiele zeigen unter anderem, wie benutzerdefinierte Ziele im SolutionToBuild-Element aufgerufen und wie benutzerdefinierte Eigenschaften an andere Elemente weitergegeben werden.

Auch die folgenden Dateien sind wichtig:

  • TfsBuildService.exe.config

    Sie können die Datei TfsBuildService.exe.config verwenden, um bestimmte Aspekte von Team Foundation Build zu konfigurieren. TfsBuildService.exe.config enthält Einstellungen für den Anschluss, den Sie für die Kommunikation mit Team Foundation-Server verwenden, für die Konfiguration der maximalen Anzahl von Prozessen, die von Team Foundation Build verwendet werden, für das Generieren von Fehlern und Warnungen pro Projekt oder pro Kombination aus Plattform und Konfiguration und für das Ändern von Namen der Unterverzeichnisse für Quell- und Binärdateien sowie Testergebnisse auf einem Build-Agent. Weitere Informationen finden Sie unter Gewusst wie: Ändern von Einstellungen in der Datei TfsBuildService.exe.config.

    Die Datei TfsBuildService.exe.config befindet sich in <root>:\Programme\Microsoft Visual Studio 9.0\Common7\IDE\PrivateAssemblies auf einem Anwendungsebenenserver.

  • TfsBuild.rsp

    Diese leere Datei wird vom MSBuild-Projektdateierstellungs-Assistenten generiert. Diese Datei kann verwendet werden, um eine benutzerdefinierte Protokollierung festzulegen oder die MSBuild-Eigenschaften zu überschreiben. Weitere Informationen hierzu finden Sie unter MSBuild-Antwortdateien.

Ziele, Eigenschaften und Aufgaben

In den folgenden Themen werden die Standardziele, -aufgaben und -eigenschaften beschrieben, die in Microsoft.TeamFoundation.Build.targets definiert sind.

  • Benutzerdefinierte Team Foundation-Buildziele
    Listet die in Microsoft.TeamFoundation.Build.targets definierten Ziele auf, die Sie überschreiben können, indem Sie benutzerdefinierte Aufgaben schreiben. Enthält Beispiele, die zeigen, wie der Buildprozess angepasst wird.

  • Anpassbare Team Foundation-Buildeigenschaften
    Listet die in Microsoft.TeamFoundation.Build.targets definierten Standardeigenschaften auf, die in der Datei TfsBuild.proj überschrieben werden können. Dieses Thema enthält Beispiele.

  • Team Foundation Build-Aufgaben
    Listet die in Microsoft.TeamFoundation.Build.targets definierten Standardaufgaben auf, die zum Anpassen von Builddefinitionen in der Datei TfsBuild.proj geändert werden können. Dieses Thema enthält Beispiele.

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Anpassen von Team Foundation Build mithilfe einer benutzerdefinierten Aufgabe

Weitere Ressourcen

Anpassen von Team Foundation Build

MSBuild-Grundlagen