Gewusst wie: Anpassen der SolutionToBuild-Elementgruppe
Aktualisiert: November 2007
Die Team Foundation Build-Projektdatei TFSBuild.proj kann angepasst werden. Hierzu werden Eigenschaften und Ziele in der SolutionToBuild-Elementgruppe an den Build übergeben. Sie können auch Projektmappen in der SolutionToBuild-Elementgruppe für den Build hinzufügen oder daraus entfernen. Weitere Informationen zur Datei TFSBuild.proj finden Sie unter Team Foundation Build-Konfigurationsdateien.
Erforderliche Berechtigungen
Damit Sie diese Verfahren ausführen können, müssen die Berechtigungen Build verwalten und Arbeitsbereiche verwalten auf Zulassen festgelegt sein. Weiterhin müssen die Berechtigungen Einchecken und Auschecken auf Zulassen festgelegt sein.
Bearbeiten der Team Foundation Build-Projektdatei
Bevor Sie die Datei TFSBuild.proj bearbeiten können, müssen Sie sie aus der Quellcodeverwaltung auschecken.
So bearbeiten Sie die Datei TFSBuild.proj
Zeigen Sie im Menü Ansicht auf Weitere Fenster, und klicken Sie dann auf Quellcodeverwaltungs-Explorer.
Erweitern Sie im Quellcodeverwaltungs-Explorer im Bereich Ordner das Teamprojekt, und wählen Sie TeamBuildTypes aus.
Um die letzte Version von TFSBuild.proj abzurufen, klicken Sie mit der rechten Maustaste auf den Ordner TeamBuildType, und klicken Sie dann auf Letzte Version abrufen.
Dieser Vorgang ermöglicht das Auschecken der Dateien zum Bearbeiten.
Doppelklicken Sie im Anzeigebereich auf den Namen der Builddefinition, die Sie ändern möchten, klicken Sie mit der rechten Maustaste auf TFSBuild.proj, und klicken Sie dann auf Auschecken zum Bearbeiten. Wählen Sie im Dialogfeld Auschecken die Option Keine - Gemeinsames Auschecken zulassen aus, und klicken Sie dann auf Auschecken.
Neben der Datei TFSBuild.proj wird ein rotes Häkchen angezeigt, das den Quellcodeverwaltungsstatus der Datei angibt.
Doppelklicken Sie auf die Datei TFSBuild.proj, um sie im XML-Editor von Visual Studio zu öffnen.
Übergeben von Eigenschaften in die SolutionToBuild-Elementgruppe
Team Foundation Build enthält zwei reservierte Eigenschaften, die Sie verwenden können, um Builddefinitionen anzupassen:
CustomPropertiesForClean übergibt benutzerdefinierte Werte in jede Projektmappe, wenn Team Foundation Build das Clean-Ziel aufruft.
CustomPropertiesForBuild übergibt benutzerdefinierte Werte in jede Projektmappe, wenn Team Foundation Build das Standardziel aufruft (in der Regel Build).
So übergeben Sie Eigenschaften in die SolutionToBuild-Elementgruppe
Suchen Sie das <SolutionToBuild>-Tag in der Datei TFSBuild.proj.
Um dem Standardziel eine benutzerdefinierte Eigenschaft hinzuzufügen, geben Sie zwischen dem <SolutionToBuild>-Tag und dem </SolutionToBuild>-Tag Folgendes ein. Beispiele:
<SolutionToBuild Include="$(SolutionRoot)\HelloWorld.sln"> <CustomPropertiesForBuild> Context=TeamBuild;RootDirectory=$(SolutionDir) </CustomPropertiesForBuild> </SolutionToBuild>Dieser XML-Code zeigt für die Buildeigenschaft RootDirectory auf die Standard-SolutionDir-Eigenschaft.
Verwenden Sie die gleiche Syntax, um benutzerdefinierte Eigenschaften in der CustomPropertiesForClean-Eigenschaft zu übergeben.
Optional können Sie auch benutzerdefinierte Eigenschaften in einzelne SolutionToBuild-Elemente übergeben, indem Sie sie in Metadaten angeben.
Beispiele:
<SolutionToBuild Include="$(SolutionRoot)\HelloWorld.sln"> <Properties> OutDir=$(BinariesRoot)\$(Solution)\$(Platform)\$(Configuration\ </Properties> </SolutionToBuild>Dieser XML-Code gibt das Ausgabeverzeichnis für eine oder mehrere Builddefinitionen an, die dieser TFSBuild.proj-Datei zugeordnet sind.
.gif "Hinweis")
Hinweis:Das Hinzufügen des CustomPropertiesForBuild-Tags und des CustomPropertiesForClean-Tags führt zu XML-Schema-Validierungswarnungen in Visual Studio. Sie können diese Warnungen gefahrlos ignorieren.
Hinzufügen zu und Löschen von Projektmappen aus der SolutionToBuild-Elementgruppe
Sie können die SolutionToBuild-Elementgruppe bearbeiten, um Projektmappen hinzuzufügen oder zu entfernen, die von der oder den Builddefinitionen erstellt werden, die der Team Foundation Build-Projektdatei TFSBuild.proj zugeordnet sind.
So fügen Sie zu erstellende Projektmappen hinzu oder entfernen sie
Suchen Sie das <SolutionToBuild>-Tag in der Datei TFSBuild.proj.
Wenn in der Builddefinition die Erstellung von nur einer Projektmappe festgelegt ist, ähnelt der SolutionToBuild-Eintrag dem folgenden XML-Code:
<ItemGroup> <SolutionToBuild Include="$(BuildProjectFolderPath)\path\MySolution.sln" /> <Targets></Targets> <Properties></Properties> </SolutionToBuild> </ItemGroup>Um eine weitere Projektmappe hinzuzufügen, fügen Sie einen weiteren Satz mit <SolutionToBuild></SolutionToBuild>-Tags nach dem öffnenden <ItemGroup>-Tag und vor dem schließenden </ItemGroup>-Tag hinzu.
<SolutionToBuild Include="$(BuildProjectFolderPath)\path\MySolution.sln" /> <Targets></Targets> <Properties></Properties> </SolutionToBuild> <SolutionToBuild Include="$(BuildProjectFolderPath)\path\MySecondSolution.sln" /> <Targets></Targets> <Properties></Properties></SolutionToBuild>Um eine Projektmappe zu entfernen, entfernen Sie die <SolutionToBuild></SolutionToBuild>-Tags und alles zwischen den Tags für die Projektmappe, die Sie nicht mehr erstellen möchten.
Aufrufen eines benutzerdefinierten Ziels in der SolutionToBuild-Elementgruppe
Sie können benutzerdefinierte Ziele für einzelne SolutionToBuild-Elemente aufrufen, indem Sie sie in Metadaten angeben.
So rufen Sie ein benutzerdefiniertes Ziel in der SolutionToBuild-Elementgruppe auf
Suchen Sie das <SolutionToBuild>-Tag in der Datei TFSBuild.proj.
Verwenden Sie die folgende Syntax, um ein Ziel aufzurufen und Eigenschaften zu übergeben.
<SolutionToBuild Include="$(BuildProjectFolderPath)\path\MySolution.sln"> <Targets>MyCustomTarget1;MyCustomTarget2</Targets> <Properties>Property1=Value1;PropertyTwo=Value2</Properties> </SolutionToBuild>Dieser XML-Code ruft die Ziele MyCustomTarget1 und MyCustomTarget2 auf und übergibt die Eigenschaften Property1 und Property2.
Siehe auch
Aufgaben
Gewusst wie: Erstellen einer Builddefinition