共用方式為


HOW TO:在桌面上建置 Team 專案

更新:2007 年 11 月

Team Foundation Build 提供一項桌面組建功能,可讓您將變更簽入公用 Team Foundation 版本控制伺服器之前,先建置方案並針對本機二進位碼檔案執行測試。桌面組建的運作方式與公用組建的差異在於:

  • 桌面組建僅執行編譯和測試。

  • 桌面組建不會執行其他公用組建的步驟 (例如從版本控制取得原始檔、更新工作項目、標記原始檔、建立新的工作項目並將其複製到置放位置)。

  • 由於 Team Foundation Build 記錄器不會針對桌面組建啟用,所以會使用預設的 MSBuild 記錄器來記錄結果。

  • 桌面組建不會將組建資料儲存在資料庫中。

  • 它們不會產生任何狀態報告。建置輸出會寫入主控台中。您可以在執行 MSBuild 命令時,透過啟用 Verbosity 選項來了解詳細資料。如需詳細資訊,請參閱 MSBuild 命令列參考

如需如何將組建排入佇列的詳細資訊,請參閱 HOW TO:佇列或啟動組建定義

必要的使用權限

您必須擁有可以在組建代理程式上建立檔案的適當檔案系統使用權限,才能進行這個程序。而且,也必須擁有適當的檔案系統使用權限,以執行您指定做為建置程序一部分的所有額外程序。如需詳細資訊,請參閱 Team Foundation Server 使用權限

若要執行桌面組建

  1. 將 Team 專案根目錄同步至本機電腦上的目錄。如需詳細資訊,請參閱 HOW TO:取得 Team 專案的原始檔

    注意事項:

    Team Foundation Build 會將所有組建定義檔案儲存在版本控制內。預設的目錄是 Team 專案根目錄下的 TeamBuildTypes。建立組建定義時,您可以指定不同的目錄。

  2. 從 Visual Studio 命令提示字元使用 MSBuild 命令 (依序按一下 [開始]、[所有程式]、[Microsoft Visual Studio 2008]、[Visual Studio Tools] 和 [Visual Studio 2008 命令提示字元]),並使用組建定義檔做為引數,如下列語法所示:

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

    注意事項:

    您存放組建檔的資料夾路徑可以不同。

    如果原始檔已經同步至某個目錄 (例如 d:\temp\mysources\solution1),您就可以使用另一個目錄來同步處理此組建類型檔,例如:c:\temp。除了指定原始檔的位置以外,請使用上述的命令。命令語法如下:

    MSBuild TfsBuild.proj /p:SolutionRoot= d:\temp\mysources

    您可以使用命令列搭配 /p 參數,覆寫任何屬性。桌面組建唯一需要的屬性為 SolutionRoot

    您也可以選擇覆寫桌面組建的下列屬性:

    • Verbose

    • RunFxCopFlag

  3. 下列命令針對 Team Foundation Build 桌面組建提供其他語法:

    • msbuild TfsBuild.proj

      您可以使用這個命令,執行累加建置 (Incremental Build) 並執行測試。

    • msbuild TfsBuild.proj /t:Clean

      您可以使用這個命令,執行二進位碼檔案和所有中繼 obj 資料夾的清除作業。

    • msbuild TfsBuild.proj /t:Compile

      您可以使用這個命令執行累加編譯。

    • msbuild TfsBuild.proj /t:Test

      您可以使用這個命令僅執行測試。

    • msbuild TfsBuild.proj /t:DesktopRebuild

      您可以使用這個命令執行清除、完整編譯和測試。

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

      您可以使用這個命令,透過覆寫 BinariesRoot (複製產品二進位碼檔案的目錄) 和 TestResultsRoot (儲存測試結果的目錄) 來覆寫輸出目錄。

    • msbuild TfsBuild.proj /p:RunCodeAnalysis=false

      您可以使用這個命令,停用桌面組建中的程式碼分析。

    • msbuild TfsBuild.proj /p:RunTest=false

      您可以使用這個命令,停用桌面組建中的測試回合。

    如需 MSBuild 命令列選項的詳細資訊,請參閱 MSBuild 命令列參考

請參閱

概念

MSBuild 中記錄的概觀

MSBuild 屬性

參考

MSBuild 命令列參考

其他資源

在 Team Foundation Build 中執行組建