Freigeben über

Team Foundation Build-Konfigurationsdateien

  • Artikel

In diesem Thema werden die von der Upgradevorlage verwendeten Konfigurationsdateien erläutert. Weitere Informationen zur Upgradevorlage finden Sie unter Definieren eines Builds mithilfe der Upgradevorlage. Die zum Erzeugen dieser Dateien verwendeten Funktionen, z. B. der MSBuild-Projektdateierstellungs-Assistent, sind nur in Visual Studio Team System 2008 verfügbar.

Wenn Sie einen Upgradevorlagenbuild verarbeiten, verwendet Team Foundation Build das MSBuild-Modul. Der 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:

  • Zielelement   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 drei 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 Verwaltung von Anwendungslebenszyklen von Visual Studio 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.

    Wichtig

    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. Diese Datei wird vom MSBuild-Projektdateierstellungs-Assistenten erstellt, wenn Sie eine Projektdatei für eine neue Builddefinition erstellen. Weitere Informationen finden Sie unter Erstellen einer einfachen 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 den Teamprojektnamen und BuildDefinition den Namen der Builddefinition darstellt. 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.

  • 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. Dieses Thema enthält Beispiele, die die Anpassung des Buildprozesses veranschaulichen.

  • 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 auch 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 auch Beispiele.