Exemplarische Vorgehensweise: Hinzufügen von Buildschritten mit der BuildStep-Aufgabe
Aktualisiert: November 2007
Eine BuildStep-Aufgabe ist eine speziell für Team Foundation Server geschriebene MSBuild-Aufgabe. Sie fügen eine BuildStep-Aufgabe zu einem Build hinzu, indem Sie BuildStep-Elemente zu einem Target-Element in der Datei TFSBuild.proj der Builddefinition für die Projektmappe hinzufügen.
Vorbereitungsmaßnahmen
Bevor Sie eine BuildStep-Aufgabe zu einer Builddefinition hinzufügen, benötigen Sie Folgendes:
Zugriff auf die Datei TFSBuild.proj für die Builddefinition, die Sie anpassen möchten. Weitere Informationen zum Erstellen einer Builddefinition finden Sie unter Gewusst wie: Erstellen einer Builddefinition.
.gif "Wichtiger Hinweis")
Wichtiger Hinweis:Beim Anpassen der Datei TFSBuild.proj wird jede zugeordnete Builddefinition angepasst.
Ein lokaler Arbeitsbereich, der die Teamprojektdateien und die Builddateien enthält. Weitere Informationen finden Sie unter Gewusst wie: Erstellen eines zugeordneten Arbeitsbereichs und unter Gewusst wie: Abrufen der Quellcodeverwaltung für das Teamprojekt.
Erforderliche Berechtigungen
Die Verfahren in diesem Thema können nur ausgeführt werden, wenn die Berechtigungen Einchecken und Auschecken auf Zulassen festgelegt sind. Weitere Informationen hierzu finden Sie unter Team Foundation Server-Berechtigungen.
Um Buildschritte mithilfe der BuildStep-Aufgabe hinzuzufügen, führen Sie die folgenden Schritte aus:
Hinzufügen einer Aufgabe zur Projektdatei
Hinzufügen eines Informationsbuildschritts zur Projektdatei
Hinzufügen einer Aufgabe zur Projektdatei
Mithilfe der BuildStep-Aufgabe können Sie Buildschritte hinzufügen und aktualisieren. In diesem Verfahren wird beschrieben, wie Sie die Datei TFSBuild.proj in folgender Weise ändern:
Hinzufügen eines Buildschritts
Durchführen einer Aufgabe
Aktualisieren des Buildschritts mit dem Status Erfolgreich, wenn die Aufgabe erfolgreich abgeschlossen wurde, oder mit dem Status Fehler, wenn die Aufgabe fehlgeschlagen ist
Bei der BuildStep-Aufgabe in diesem Beispiel werden die Quelldateien an einen neuen Speicherort kopiert.
So fügen Sie einen Buildschritt zur Datei TFSBuild.proj hinzu und aktualisieren diesen
Starten Sie Visual Studio.
Checken Sie die Datei TFSBuild.proj, die Sie ändern möchten, aus der Team Foundation-Versionskontrolle aus, und öffnen Sie sie im XML-Editor von Visual Studio.
Fügen Sie dem <ItemGroup>-Element den folgenden XML-Code hinzu. Sie können den XML-Code zu dem vorhandenen <ItemGroup>-Element hinzufügen, oder Sie fügen ein neues <ItemGroup>-Element hinzu:
.gif "Hinweis")
Hinweis:Der Code in diesem Schritt gibt die Ordner an, in denen die zu kopierenden Quelldateien gespeichert sind. Andere MSBuild-Aufgaben erfordern möglicherweise andere Erweiterungen des XML-Codes. Weitere Informationen zu den Anforderungen für MSBuild-Aufgaben finden Sie in der Referenz zu MSBuild-Aufgaben.
<ItemGroup> <SourceFileFolder Include="C:\WorkingFolder\TeamBuildTypes\**\*.cs" /> </ItemGroup>Fügen Sie am Ende der Datei TFSBuild.proj direkt vor dem </Project>-Element den folgenden XML-Code ein:
</ItemGroup> <Target Name="BeforeCompile"> <BuildStep TeamFoundationServerUrl="$(TeamFoundationServerUrl)" BuildUri="$(BuildUri)" Message="Working..."> <Output TaskParameter="Id" PropertyName="StepId" /> </BuildStep> <!-- Perform a task... --> <Copy SourceFiles="@(SourceFileFolder)" DestinationFolder="C:\NewSourceFileFolder" /> <BuildStep TeamFoundationServerUrl="$(TeamFoundationServerUrl)" BuildUri="$(BuildUri)" Id="$(StepId)" Status="Succeeded" /> <OnError ExecuteTargets="MarkBuildStepAsFailed" /> </Target> <Target Name="MarkBuildStepAsFailed"> <BuildStep TeamFoundationServerUrl="$(TeamFoundationServerUrl)" BuildUri="$(BuildUri)" Id="$(StepId)" Status="Failed" /> </Target> </Project>Hinweis:Weitere Informationen über Team Foundation Build-Ziele und eine Liste von benutzerdefinierbaren Zielen finden Sie unter Benutzerdefinierte Team Foundation-Buildziele.
Speichern Sie die Änderungen, und schließen Sie die Datei TFSBuild.proj.
Checken Sie die Datei TFSBuild.proj in die Versionskontrolle ein.
Führen Sie die Builddefinition aus.
Weitere Informationen hierzu finden Sie unter Gewusst wie: Starten oder Hinzufügen einer Builddefinition zur Warteschlange.
Die Meldung zu dem Buildschritt wird in Build Explorer angezeigt. Im Buildprotokoll finden Sie ausführliche Informationen zu Erstellung und Aktualisierung des Buildschritts. Die kopierten Dateien werden zudem in dem angegebenen Verzeichnis angezeigt. Weitere Informationen hierzu finden Sie unter Gewusst wie: Überwachen des Buildstatus.
Hinzufügen eines Informationsbuildschritts zur Projektdatei
Wenn Sie keine Aufgabe durchführen, sondern lediglich einen Informationsbuildschritt hinzufügen möchten, sollten Sie nicht die Id Output-Eigenschaft verwenden und den Status direkt festlegen. Bei diesem Verfahren wird nur eine Meldung zu dem Buildverfahren hinzugefügt, die beim Öffnen des Builds in Build Explorer angezeigt wird.
So fügen Sie einen Informationsbuildschritt zu der Datei TFSBuild.proj hinzu
Starten Sie Visual Studio.
Checken Sie die Datei TFSBuild.proj, die Sie ändern möchten, aus der Team Foundation-Versionskontrolle aus, und öffnen Sie sie im XML-Editor von Visual Studio.
Fügen Sie am Ende der Datei TFSBuild.proj direkt vor dem </Project> -Element den folgenden XML-Code ein:
</ItemGroup> <Target Name="AfterCompile"> <BuildStep TeamFoundationServerUrl="$(TeamFoundationServerUrl)" BuildUri="$(BuildUri)" Message="Compile step complete." Status="Succeeded" /> </Target> </Project>Hinweis:Weitere Informationen über Team Foundation Build-Ziele und eine Liste von benutzerdefinierbaren Zielen finden Sie unter Benutzerdefinierte Team Foundation-Buildziele.
Speichern Sie die Änderungen, und schließen Sie die Datei TFSBuild.proj.
Checken Sie die Datei TFSBuild.proj in die Versionskontrolle ein.
Führen Sie die Builddefinition aus.
Weitere Informationen hierzu finden Sie unter Gewusst wie: Starten oder Hinzufügen einer Builddefinition zur Warteschlange.
Sie können die Meldung in Build Explorer und im Buildprotokoll anzeigen. Weitere Informationen hierzu finden Sie unter Gewusst wie: Überwachen des Buildstatus.