共用方式為

逐步解說：設定和使用桌面組建

  • 發行項

更新：2007 年 11 月

在 Team Foundation Build 中，程式開發人員可以建置 (Build) Team 專案並在本機執行測試之後，再簽入變更。本逐步解說會說明如何執行桌面組建。

桌面組建的差異

桌面組建案例的行為與公用組建有下列幾點的差異：

  • 只會執行編譯 (Compilation) 與測試 (如果已啟用這兩項功能的話)。

  • 不會在桌面組建中執行其他公用建置步驟，例如同步、清除、程式碼變換、複製到置放位置、工作項目更新以及建立新工作項目。

  • 使用預設的 MSBuild 記錄器，並將建置輸出寫入到主控台 (Console)。

  • 建置和測試結果的資料並不會發行或放入倉儲中。

桌面組建結果

Team Foundation Build 記錄器不會用於桌面組建，因此，不會有任何資料放入資料庫來建立狀態報告。若要檢視桌面組建的結果，您必須重新導向預設的 MSBuild 記錄器輸出檔，並進行檢視。您可以使用 MSBuild 命令的 verbose 選項，控制 MSBuild 記錄器的詳細資訊。如需詳細資訊，請參閱 MSBuild 中記錄的概觀。

必要條件

必要的使用權限

您必須將 Team Foundation Server 的 [啟動組建] 使用權限設定為 [允許]，才能完成此逐步解說。如需詳細資訊，請參閱 Team Foundation Server 使用權限。

若要執行桌面組建

  1. 在本機從 Team Foundation 版本控制手動同步處理 Team 專案根目錄。

    例如：

    Team Foundation 版本控制伺服器的預設結構如下：

    注意事項：

    這個結構可能與 Team Foundation 版本控制伺服器上的結構不同。

    $\

    Portfolio Project1

    **     Team Build Types**

    **          Main**

    **               TFSBuild.proj**

    **     Solution1**

    **     Solution2**

    **     Solution3**

    將 Team project1 同步處理到本機目錄 C:/temp 之後，本機目錄的結構如下所示：

    C:/Temp

    **          /Portfolio Project1**

    **               /Team Build Types**

    **                    /Main**

    **                         /TFSBuild.proj**

    **               /Solution1**

    **               /Solution2**

    **               /Solution3**

    重要事項：

    本機目錄結構必須完全符合伺服器的結構，才能正確執行組建。

  2. 在命令列上執行 MSBuild，以啟動 Team Foundation Build 處理序。請輸入下列命令：

    C:\temp\Portfolio Project1\Build Configurations\Main> MSBuild TeamBuild.proj

    會解析 TFSBuild.proj 中方案的路徑，因為 TFSBuild.proj 中提及的預設方案根目錄為 “.../..”。此外，傳遞給 MSBuild 工作的方案會將這個方案根目錄屬性當做 ($solutionroot)/Solution1 使用；因此在此情況下，方案根目錄的值會變成 C:/Temp/Portfolio Project1。

    注意事項：

    您可以視需要使用 /p 參數來修改方案根目錄。如需詳細資訊，請參閱 MSBuild 屬性的＜從命令列設定屬性＞一節。

請參閱

其他資源

Team Foundation Build 逐步解說