Freigeben über


Gewusst wie: Erstellen von Teamprojekten auf Desktops

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 Quellcodeverwaltung in Team Foundation-Server eingecheckt werden. Das Verhalten von Desktopbuilds unterscheidet sich in folgenden Punkten von öffentlichen Builds:

  • Es werden nur Kompilierung und Tests durchgeführt.

  • Andere öffentliche Buildschritte, wie das Abrufen von Quellen aus der Quellcodeverwaltung, das Aktualisieren von Arbeitsaufgaben, das Bezeichnen der Quellen, das Erstellen neuer Arbeitsaufgaben und das Kopieren an die Ablagespeicherorte, werden bei Desktopbuilds nicht durchgeführt.

  • Die standardmäßige MSBuild-Protokollierung wird für die Protokollierung von Ergebnissen verwendet, da die Team Foundation Build-Protokollierung für Desktopbuilds nicht aktiviert ist.

  • Builddaten werden nicht in der Datenbank gespeichert.

  • Es werden keine Statusberichte erstellt. Die Buildausgabe wird auf der Konsole ausgegeben. Sie erhalten ausführliche Informationen, wenn Sie bei der Ausführung des Befehls MSBuild die Option Verbose aktivieren.

  • Informationen zum Erstellen eines öffentlichen Builds finden Sie unter Gewusst wie: Ausführen eines Builds mit einem Buildtyp.

In der folgenden Vorgehensweise wird veranschaulicht, wie Sie einen Desktopbuild durchführen.

So führen Sie einen Desktopbuild aus

  1. 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.

    Hinweis

    Team Foundation Build speichert alle Buildtypdateien in der Quellcodeverwaltung und verwendet ein Verzeichnis mit dem Namen TeamBuildTypes, das sich im Teamprojekt-Stammordner befindet.

  2. Verwenden Sie den Befehl MSBuild an der Visual Studio-Eingabeaufforderung (klicken Sie auf Start, auf Alle Programme, auf Microsoft Visual Studio 2005, auf Visual Studio Tools und dann auf Visual Studio 2005-Eingabeaufforderung), und geben Sie die Buildtypdatei gemäß der folgenden Syntax als Argument an:

    C:\temp\Team Project1\TeamBuildTypes\Main> MSBuild TfsBuild.proj /p:SolutionRoot=..\..

    Hinweis

    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:solroot= d:\temp\mysources

    Alle Eigenschaften können an der Befehlszeile mit dem Schalter /p überschrieben werden. Die für einen Desktopbuild erforderlichen Eigenschaften sind SolutionRoot und TeamBuildRefPath.

    Die überschreibbaren optionalen Eigenschaften für Desktopbuilds sind:

    • Verbose

    • RunFxCopFlag

  3. Die folgenden Befehle bilden die zusätzliche Syntax für Team Foundation Build-Desktopbuilds:

    • So führen Sie einen inkrementellen Buildvorgang und Tests aus

      msbuild TfsBuild.proj

    • So führen Sie einen Bereinigungsvorgang für die Binärdateien und alle temporären OBJ-Ordner aus

      msbuild TfsBuild.proj /t:Clean

    • So führen Sie eine inkrementelle Kompilierung aus

      msbuild TfsBuild.proj /t:Compile

    • So führen Sie nur Tests aus

      msbuild TfsBuild.proj /t:Test

    • So führen Sie eine vollständige Kompilierung mit Bereinigung und Tests aus

      msbuild TfsBuild.proj /t:DesktopRebuild

    • So überschreiben Sie das Ausgabeverzeichnis durch Überschreiben des BinariesRoot, wobei Produktbinärdateien und der TestResultsRoot kopiert werden, in dem die Testergebnisse gespeichert werden

      msbuild TfsBuild.proj /t:BinariesRoot=d:\NewBinariesRoot /t:TestResultsRoot=d:\NewTestResultsRoot

    • So deaktivieren Sie die Codeanalyse in einem Desktopbuild

      msbuild TfsBuild.proj /p:RunCodeAnalysis=false

    • So deaktivieren Sie Testläufe in einem Desktopbuild

      msbuild TfsBuild.proj /t:RunTest=false

    Weitere Informationen zu MSBuild-Befehlszeilenoptionen finden Sie unter MSBuild-Befehlszeilenreferenz.

Sicherheit

Zum Ausführen dieser Schritte müssen Sie Mitglied der Sicherheitsgruppe Administratoren für den Computer sein, auf dem der Buildvorgang ausgeführt wird. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.

Siehe auch

Referenz

MSBuild-Befehlszeilenreferenz

Konzepte

Integration von Visual Studio (MSBuild)
MSBuild-Protokollierungen
MSBuild-Eigenschaften

Weitere Ressourcen

Ausführen von Builds in Team Foundation Build