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

發行項
08/21/2008

更新：2007 年 11 月

本逐步解說將示範如何設定 Team Foundation Build 的組建定義。在您開始進行這個逐步解說之前，具備一些 Team Foundation Build 的基本知識是很重要的。如需詳細資訊，請參閱使用 Team Foundation Build 管理組建。

在本逐步解說中，您將使用 [組建定義] 對話方塊逐一進行設定組態定義的程序。此外也將建立組建代理程式所需的權限，而且使用者將執行新建立的組建定義。在這個逐步解說中，您將完成下列工作：

建立新的組建定義。
選取要建置的方案。
選取組建代理程式和置放位置。
選取建置步驟。
選取組建的組態和平台。
建立組建代理程式上的使用權限。
建立指定使用者的使用權限，讓使用者能夠執行新建立的組建定義。

必要條件

Visual Studio Team System Team Foundation Server.
與 Team Foundation Server 的連接而且至少一個現有的 Team 專案。如需詳細資訊，請參閱逐步解說：聯結 Team 專案和HOW TO：建立 Team 專案。
原始檔控制伺服器中的工作區，其中至少包含一個要建置的方案。如需詳細資訊，請參閱 HOW TO：建立對應工作區。

必要的使用權限

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

若要建立新的組建定義

在 Team 總管中，選取您要建立新組建定義的專案。
在 [建置] 功能表上，選取 [新增組建定義]。

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

秘訣

索引標籤旁邊若出現警告圖示，表示這些索引標籤都需要輸入。
在 [組建定義] 文字方塊內指定要與組建定義產生關聯的名稱。

輸入的名稱必須是唯一且有效的 Windows 檔名。
在 [描述] 文字方塊內加入適當的描述。

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

根據預設，[工作資料夾] 資料表包含 Team 專案的原始檔控制資料夾 (您將為該專案建立新的組建定義)。鏡像原始檔控制階層架構的本機資料夾會在組建代理程式上建立。[本機資料夾] 資料行會列出組建代理程式上的本機資料夾。組建代理程式上的所有工作區路徑會對應至顯示的預設根目錄。
若要將現有的工作區複製到工作資料夾清單中，請按一下 [複製現有工作區] 按鈕啟動 [選擇工作區] 對話方塊。

您選取的工作空間會正規化為組建代理程式上的共同根目錄。

您也可以在 [原始檔控制資料夾] 內按一下空的資料表儲存格，然後再按一下省略符號 (…)，瀏覽要加入成為工作資料夾的原始檔控制資料夾。您選取的原始檔控制資料夾也會正規化為組建代理程式上的共同根目錄。
按一下 [專案檔] 索引標籤。在 [專案檔] 窗格內，您可以瀏覽至現有的 TFSBuild.proj 專案檔，或啟動 [MSBuild 專案檔建立精靈] 建立新的 TFSBuild.proj 檔。
若要瀏覽至現有的 TFSBuild.proj 檔，請按一下 [瀏覽]。從 [瀏覽資料夾] 對話方塊的 [TeamBuildTypes] 資料夾選取現有的組建定義，然後按一下 [確定]。

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

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

重要事項：

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

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

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

若要為您的組建定義建立新專案檔，請按一下 [建立]。

[MSBuild 專案檔建立精靈] 隨即出現。

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

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

按 [下一步]。

[選取要建置的組態] 頁面隨即出現。
在 [您要建置哪些組態] 下方的方格中，選取您想要納入組建定義的組態和平台。組建組態表示組態和平台 (例如，Release 和 Any CPU)。

注意事項：

如果您是要建立 Web 專案的組建定義，則請選取 [混合平台]。
按 [下一步]。

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

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

重要事項：

為了要執行測試，組建代理程式上必須安裝 Visual Studio Test 版。若要執行程式碼分析，組建代理程式上必須安裝 Development 版。
按一下 [完成]。

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

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

注意事項：
如果您是要建立 Web 專案的組建定義，則請選取 [混合平台]。

重要事項：
為了要執行測試，組建代理程式上必須安裝 Visual Studio Test 版。若要執行程式碼分析，組建代理程式上必須安裝 Development 版。

按一下 [組建預設值] 索引標籤。

在 [組建預設值] 窗格中，您可以從 [組建代理程式] 下拉式清單選擇現有的組建代理程式。
如果其中沒有組建代理程式，或者您要建立新的組建代理程式，請按一下 [新增]。

[建置代理程式屬性] 對話方塊隨即出現。
在 [顯示名稱]、[描述] 和 [電腦名稱] 文字方塊內填入資料，然後按一下 [確定]。

如需詳細資訊，請參閱 HOW TO：建立和管理組建代理程式。

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

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

注意事項：
產生的每一個組建都會放置到個別的目錄中，您將需要確定設定組建電腦所用的帳戶具有這個 UNC 位置的寫入權限。

按一下 [觸發程序] (Trigger) 索引標籤。
1. 選取 [觸發程序] 窗格中的 [簽入不會觸發新組建]，僅依需求建置。
2. 選取 [建置每次簽入 (較多組建)]，在每次簽入由組建定義建置的檔案變更時持續執行建置。
3. 選取 [累積簽入，直到前一次組建完成 (較少組建)]，建立積存組建。
  
  如果已核取 [累積簽入，直到前一次組建完成 (較少組建)] 核取方塊，您就可以藉由選取 [建置最高頻率] 核取方塊並在 [分鐘] 文字方塊內輸入數字，指定執行建置的頻率。[minutes] 文字方塊的有效範圍為 0 至 2147483647 (Int32 MaxValue)。
4. 選取 [每週於下列日子建置] 建立排程組建。您可以使用為每個星期名稱提供的核取方塊，選取每一個您想要建置的日子。在 [將組建排入位於下列位置的預設建置代理程式佇列中] 文字方塊中輸入建置時間。
  
  注意事項：
  
  如果從上一次建置以來尚未簽入任何變更，則不會執行已排程的組建。
在填入所有必要資訊後，請按一下 [確定] 建立您的組建定義。

建立的組建定義會顯示在 Team 總管的 [Builds] 資料夾內。

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

若要檢閱儲存在伺服器上的組建定義資訊，請以滑鼠右鍵按一下 Team 總管內的組建定義，再按一下 [編輯組建定義]。

[組建定義] 對話方塊會顯示並且包含您填入的資訊。您也可以變更輸入的資訊。如需詳細資訊，請參閱HOW TO：編輯組建定義。

重要事項：
如果您的組建定義與其他組建共用 TFSBuild.proj 檔，則該組建定義和關聯的檔案不會顯示在 [原始檔控制總管] 的預設位置 [TeamBuildTypes] 資料夾內。只有原始的組建定義才會列出。您也可以將 TFSBuild.proj 檔儲存在另一個位置。

若要建立組建使用權限

連絡系統管理員，以取得之前選取的建置電腦，並判斷執行 Visual Studio Team Foundation Build 服務的帳戶名稱。
依序選取 [Team] 功能表上的 [Team 專案設定] 和 [群組成員資格]，

[專案群組] 對話方塊隨即出現。
在 [專案群組] 的 [使用者和群組] 清單中，尋找稱為 [Build Services] 的群組，然後按一下 [屬性]，

[Team Foundation Server 群組屬性] 對話方塊隨即出現。
選取 [成員] 索引標籤。

如果上一個步驟所取得的帳戶有出現在成員清單中，所選的組建電腦即可建置這個組建定義，否則，請使用下列步驟：
在 [加入成員] 區段中，選擇 [Windows 使用者或群組]，然後按一下 [加入]，

[選取使用者或群組] 對話方塊隨即出現。

在 [選取使用者或群組] 對話方塊中，輸入與建置電腦上用於這個組建定義的 Visual Studio Team Foundation Build 服務相關的帳戶。

注意事項：
如果此組建定義是建置在多部建置電腦上，則所有的 Visual Studio Team Foundation Build 服務帳戶都需要以這個專案的 'Build Services' 群組成員的形式加入。