Gewusst wie: Erstellen von Teamprojekten auf Desktops
Aktualisiert: November 2007
Team Foundation Build bietet ein Feature für Desktopbuilds. Damit können Projektmappen erstellt und Tests auf den lokalen Binärdateien ausgeführt werden, bevor die Änderungen in den öffentlichen Team Foundation-Versionskontrolle-Server eingecheckt werden. Das Verhalten von Desktopbuilds unterscheidet sich in folgenden Punkten von öffentlichen Builds:
Bei Desktopbuilds werden nur die Kompilierung und die Tests durchgeführt.
Andere öffentliche Buildschritte, wie das Abrufen von Quellen aus der Versionskontrolle, das Aktualisieren von Arbeitsaufgaben, das Bezeichnen der Quellen, das Erstellen neuer Arbeitsaufgaben und das Kopieren an die Ablagespeicherorte, werden bei ihnen nicht durchgeführt.
Die Protokollierung der Ergebnisse erfolgt durch die standardmäßige MSBuild-Protokollierung, da die Team Foundation Build-Protokollierung für Desktopbuilds nicht aktiviert ist.
Bei Desktopbuilds werden keine Builddaten in der Datenbank gespeichert.
Es werden keine Statusberichte generiert. Die Buildausgabe wird in die Konsole geschrieben. Sie erhalten ausführliche Informationen, wenn Sie die Option Verbosity bei der Ausführung des MSBuild-Befehls aktivieren. Weitere Informationen finden Sie unter MSBuild-Befehlszeilenreferenz.
Weitere Informationen zum Hinzufügen von Builds zur Warteschlange finden Sie unter Gewusst wie: Starten oder Hinzufügen einer Builddefinition zur Warteschlange.
Erforderliche Berechtigungen
Zum Ausführen dieser Schritte müssen Sie über die entsprechenden Berechtigungen für das Dateisystem verfügen, damit Sie Dateien für den Build-Agent erstellen können. Darüber hinaus müssen Sie über die entsprechenden Dateisystemberechtigungen zur Ausführung aller zusätzlichen Prozesse verfügen, die Sie während des Buildprozesses angeben. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.
So führen Sie einen Desktopbuild aus
Synchronisieren Sie das Teamprojekt-Stammverzeichnis mit einem Verzeichnis auf dem lokalen Computer. Weitere Informationen finden Sie unter Gewusst wie: Abrufen der Quellcodeverwaltung für das Teamprojekt.
.gif "Hinweis")
Hinweis:In Team Foundation Build werden alle Builddefinitionsdateien in der Versionskontrolle gespeichert. Das Standardverzeichnis ist TeamBuildTypes. Es befindet sich unter dem Stammordner des Teamprojekts. Sie können beim Erstellen einer Builddefinition ein anderes Verzeichnis festlegen.
Verwenden Sie den Befehl MSBuild an der Visual Studio-Eingabeaufforderung (klicken Sie auf Start, auf Alle Programme, auf Microsoft Visual Studio 2008, auf Visual Studio Tools und dann auf Visual Studio 2008-Eingabeaufforderung), und geben Sie die Builddefinitionsdatei gemäß der folgenden Syntax als Argument an:
C:\temp\Team Project1\TeamBuildTypes\Main> MSBuild TfsBuild.proj /p:SolutionRoot=..\..
Hinweis:Der Ordnerpfad für die Builddateien kann anders lauten.
Wenn die Quelle bereits mit einem Verzeichnis synchronisiert wurde, z. B. d:\temp\mysources\solution1, können Sie die Buildtypdatei mit einem anderen Verzeichnis synchronisieren, z. B. c:\temp. Verwenden Sie den zuvor genannten Befehl, geben Sie hierbei jedoch den Speicherort der Quellen an. Die Befehlssyntax lautet:
MSBuild TfsBuild.proj /p:SolutionRoot= d:\temp\mysources
Alle Eigenschaften können an der Befehlszeile mit dem Schalter /p überschrieben werden. Die einzige erforderliche Eigenschaft für Desktopbuilds ist SolutionRoot.
Optional können Sie diese Eigenschaften für einen Desktopbuild überschreiben:
Verbose
RunFxCopFlag
Die folgenden Befehle bilden die zusätzliche Syntax für Team Foundation Build-Desktopbuilds:
msbuild TfsBuild.proj
Mit diesem Befehl führen Sie einen inkrementellen Buildvorgang und Tests aus.
msbuild TfsBuild.proj /t:Clean
Mit diesem Befehl führen Sie einen Bereinigungsvorgang für die Binärdateien und alle temporären OBJ-Ordner aus.
msbuild TfsBuild.proj /t:Compile
Mit diesem Befehl führen Sie eine inkrementelle Kompilierung aus.
msbuild TfsBuild.proj /t:Test
Mit diesem Befehl führen Sie nur Tests aus.
msbuild TfsBuild.proj /t:DesktopRebuild
Mit diesem Befehl führen Sie eine vollständige Kompilierung mit Bereinigung und Tests aus.
msbuild TfsBuild.proj /p:BinariesRoot=d:\NewBinariesRoot /p:TestResultsRoot=d:\NewTestResultsRoot
Mit diesem Befehl überschreiben Sie das Ausgabeverzeichnis durch Überschreiben von BinariesRoot, in das Produktbinärdateien kopiert werden, und TestResultsRoot, in dem die Testergebnisse gespeichert werden.
msbuild TfsBuild.proj /p:RunCodeAnalysis=false
Mit diesem Befehl deaktivieren Sie die Codeanalyse in einem Desktopbuild.
msbuild TfsBuild.proj /p:RunTest=false
Mit diesem Befehl deaktivieren Sie Testläufe in einem Desktopbuild.
Weitere Informationen zu MSBuild-Befehlszeilenoptionen finden Sie unter MSBuild-Befehlszeilenreferenz.
Siehe auch
Konzepte
Übersicht über die Protokollierung in MSBuild