共用方式為

HOW TO：建立組建定義

  • 發行項

更新：2007 年 11 月

Team Foundation Build 會使用「組建定義」(Build Definition) 來設定在 Team 專案中建置 (Build) 單一方案或一組方案的條件。若要執行組建，您必須建立新的組建定義，或是使用現有的組建定義。

當您使用 [組建定義] 對話方塊建立組建定義時，可以設定幾個選項。這些選項包括組建名稱、要建置之檔案的原始檔控制工作區，以及 TFSBuild.proj 專案檔的位置、組建代理程式、組建保留原則，以及組建觸發程序。如果您沒有現有的 MSBuild 專案檔，可以使用 [組建定義] 對話方塊啟動 [MSBuild 專案檔建立精靈]，為組建定義建立新的 TFSBuild.proj 檔。您也可以啟動 [組建代理程式屬性] 對話方塊來建立新的組建代理程式。

建立新的組建定義後，您就可以變更這些選項。如需詳細資訊，請參閱 HOW TO：編輯組建定義。

您可以編輯以 MSBuild 格式撰寫的 TFSBuild.proj 檔，進一步自訂您的組建定義。如需詳細資訊，請參閱自訂 Team Foundation Build。

移除組建定義時，會先刪除與組建定義關聯的組建，然後才會刪除組建定義本身。如需詳細資訊，請參閱 HOW TO：刪除組建定義。

必要的使用權限

您必須將 [管理組建] 使用權限設定為 [允許]，才能執行此程序。此外，應用程式層服務帳戶和 Team Foundation Build 服務帳戶對於組建放置位置必須有讀取/寫入權限。如需詳細資訊，請參閱 Team Foundation Server 使用權限。

若要建立新的組建定義

  1. 在 [Team 總管] 中，選取您要建立新組建定義的專案。

  2. 在 [建置] 功能表上，選取 [新增組建定義]。

    [組建定義] 對話方塊隨即出現，其中已選取 [一般] 索引標籤。

    秘訣

    索引標籤旁邊若出現警告圖示，表示這些索引標籤都需要輸入。

  3. 在 [組建定義] 文字方塊內指定要與組建定義產生關聯的名稱。

    輸入的名稱必須是唯一且有效的 Windows 檔名。

  4. 在 [描述] 文字方塊內加入適當的描述。

    這個描述會出現在 [佇列組建 "<Team 專案名稱>"] 對話方塊中。如需詳細資訊，請參閱 HOW TO：佇列或啟動組建定義。

  5. 按一下 [工作區] 索引標籤。

    根據預設，[工作資料夾] 資料表包含 Team 專案的原始檔控制資料夾 (您將為該專案建立新的組建定義) 和組建代理程式上的本機資料夾。組建代理程式上的本機資料夾列示於 [本機資料夾] 資料行內。組建代理程式上的所有工作區路徑會對應至顯示的預設根目錄。

  6. 若要將現有的工作區複製到工作資料夾清單中，請按一下 [複製現有工作區] 按鈕啟動 [選擇工作區] 對話方塊。

    您所選的工作區會成為組建代理程式上共同根目錄的子目錄。

    您也可以在 [原始檔控制資料夾] 內按一下空的資料表儲存格，然後再按一下省略符號 (…)，瀏覽要加入成為工作資料夾的原始檔控制資料夾。您所選的原始檔控制資料夾在組建代理程式上也會標準化為共同的根目錄。

  7. 按一下 [專案檔] 索引標籤。在 [專案檔] 窗格內，您可以瀏覽至現有的 TFSBuild.proj 專案檔，或啟動 [MSBuild 專案檔建立精靈] 建立新的 TFSBuild.proj 檔。

  8. 若要瀏覽至現有的 TFSBuild.proj 檔，請按一下 [瀏覽]。從 [瀏覽資料夾] 對話方塊的 [TeamBuildTypes] 資料夾選取現有的組建定義，然後按一下 [確定]。

    至此，TFSBuild.proj 檔便可在現有的組建定義及新的組建定義間共用。

    如果已找到 TFSBuild.proj 檔，則 [專案檔] 窗格內會顯示 [找到 MSBuild 專案檔: TFSBuild.proj] 文字。如果找不到專案檔，則 [專案檔] 窗格會顯示警告文字，並建議您建立新的 MSBuild 專案檔。 

    重要事項：

    您對共用的 TFSBuild.proj 檔所做的任何變更都會自訂所有組建定義與關聯的檔案。如需詳細資訊，請參閱自訂 Team Foundation Build。

    若要為您的組建定義建立新專案檔，請按一下 [建立]。[MSBuild 專案檔建立精靈] 隨即出現。

    1. 在 [選取並排列要建置的方案] 頁面上選取要建置的方案。若要排列方案，請選取單一方案，並使用清單右邊的方向鍵來變更其在建置順序中的位置。

      警告：

      在決定方案的建置順序時，請注意對其他方案具有相依性的方案。例如，如果 Solution2 對 Solution1 具有相依性，請將 Solution1 的建置順序設定在 Solution2 之前。

    2. 按 [下一步]。

      [選取要建置的組態] 頁面隨即出現。

    3. 在 [您要建置哪些組態] 下方的方格中，選取您想要納入組建定義的組態和平台。組建組態表示組態和平台 (例如，版本和任何 CPU)。

      注意事項：

      如果您是要建立 Web 專案的組建定義，請在 [平台] 下拉式功能表中選取 [混合平台]。

    4. 按 [下一步]。

      [選取建置選項] 頁面隨即出現。

    5. 視情況選取 [執行測試(例如執行 BVT 等)] 和 [執行程式碼分析] 核取方塊，指出您要啟用的建置選項。如果選取的是 [執行測試 (例如執行 BVT 等)] 核取方塊，請視情況使用下拉式選項來指定 [測試中繼資料檔] 和 [要執行的測試清單]。

      如需詳細資訊，請參閱使用測試清單和 撰寫高品質的程式碼。

      重要事項：

      為了要執行測試，組建代理程式上必須安裝 Team Edition for Testers。若要執行程式碼分析，組建代理程式上必須安裝 Team Edition for Developers。

    6. 按一下 [完成]。

      [組建定義] 對話方塊的 [專案檔] 窗格隨即出現。您建立的 TFSBuild.proj 檔儲存在原始檔控制內的 $<Team Project>\TeamBuild Types\<Build Definition Name>\TFSBuild.proj 中。

  9. 按一下 [保留原則] 索引標籤。在 [指定組建的保留方式] 清單中，您可以為已失敗、已停止、部分成功和完全成功的組建選取保留原則。從下拉式清單選取保留原則。如果選取 [<指定要保留的數目>]，則 [組建數目] 對話方塊隨即出現。在 [指定要保留的組建數目] 文字方塊中，指示您要為指定之建置結果保留的組建數目。

  10. 按一下 [組建預設值] 索引標籤。在 [組建預設值] 窗格中，您可以從 [組建代理程式] 下拉式清單選擇現有的組建代理程式。如果其中沒有組建代理程式，或者您要建立新的組建代理程式，請按一下 [新增]。[組建代理程式屬性] 對話方塊隨即出現。在 [顯示名稱]、[描述] 和 [電腦名稱] 文字方塊內填入資料，然後按一下 [確定]。如需詳細資訊，請參閱 HOW TO：建立和管理組建代理程式。

    在 [組建將在下列共用位置執行 (例如 \\server\share)] 文字方塊內輸入 UNC (\\server\share) 位置。當組建完成時，建置的二進位檔和記錄檔將會置於此資料夾中。

    注意事項：

    完成此步驟之前，您必須在組建代理程式電腦上建立公用資料夾，並賦予 TFSService 帳戶完整權限。如需 Team Foundation 服務帳戶的詳細資訊，請參閱 HOW TO：檢視 Team Foundation Server 服務。

  11. 按一下 [觸發程序] (Trigger) 索引標籤。

    1. 選取 [觸發程序] 窗格中的 [簽入不會觸發新組建]，僅依需求建置。

    2. 選取 [建置每次簽入 (較多組建)]，在每次簽入由組建定義建置的檔案變更時持續執行建置。

    3. 選取 [累積簽入，直到前一次組建完成 (較少組建)]，建立積存組建。如果選取了 [累積簽入，直到前一次組建完成 (較少組建)] 核取方塊，您就可以藉由選取 [建置最高頻率] 核取方塊並在 [分鐘] 文字方塊內輸入數字，指定執行建置的頻率。

      [minutes] 文字方塊的有效範圍為 0 至 2147483647 (Int32 MaxValue)。

      注意事項：

      如果使用 Visual Studio Team System 2008 Team Foundation Server Service Pack 1，您可以將積存組建間隔設定為 120 到 240 分鐘。如果使用不含 Service Pack 1 的 Visual Studio Team System 2008 Team Foundation Server，則 Team Foundation Build 會忽略該範圍內的任何值。

    4. 選取 [每週於下列日子建置]，建立排程組建。您可以使用為每個星期名稱提供的核取方塊，選取每一個您想要建置的日子。在 [將組建排入位於下列位置的預設組建代理程式佇列中] 文字方塊中輸入建置時間。

      注意事項：

      如果從上一次建置以來尚未簽入任何變更，則不會執行已排程的組建。

  12. 在填入所有必要資訊後，請按一下 [確定] 建立您的組建定義。

    建立的組建定義會顯示在 Team 總管的 [Builds] 資料夾內。若要檢閱儲存在伺服器上的組建定義資訊，請以滑鼠右鍵按一下 Team 總管內的組建定義，再按一下 [編輯組建定義]。[組建定義] 對話方塊隨即出現，其中包含您填入的資訊。您也可以變更這些輸入的資訊。如需詳細資訊，請參閱 HOW TO：編輯組建定義。

    重要事項：

    如果您的組建定義與其他組建共用 TFSBuild.proj 檔，則該組建定義和關聯的檔案不會顯示在 [原始檔控制總管] 的 [TeamBuildTypes] 資料夾內。只有原始的組建定義才會列出。

請參閱

工作

逐步解說：在 Team Foundation Build 中建立組建定義

HOW TO：建立 Team Foundation Build 代理程式的使用權限

HOW TO：設定及安裝 Team Foundation Build

逐步解說：使用自訂工作自訂 Team Foundation Build

概念

Team Foundation Build 概觀

其他資源

在 Team Foundation Build 中使用組建定義