共用方式為

使用組建工作區

  • 發行項

如同您需要 您的開發電腦上的工作區 開發應用程式，您必須指定組建代理程式使用建置和測試應用程式的工作區。

您想要怎麼做？

  • 為您的組建定義指定工作區

  • 如需組建工作區定義的範例

  • 複製工作區中的資料

  • 了解組建工作區的運作方式

為您的組建定義指定工作區

當您 定義建置流程時，您應遵循某些最佳做法，當您指定某個工作區。

包含所有必要的資料夾。

確認包含所有含有建置流程所需之檔案的資料夾。 例如，在中，如果您加入其他方案加入至 [處理序] 索引標籤的 [建置的項目。] 欄位中，您可能必須將另一個對應至工作區。

只包含必要的資料夾。

對應為 [現用] 的 [狀態] 值建置流程所需的資料夾。 如果一個對應資料夾的子資料夾含有建置流程不需要的檔案，請將它與 [隱匿] 的 [狀態] 值。 在許多情況下，建立組建定義時，Team 專案的根資料夾會在工作區中對應。 此組態會造成組建代理程式下載 Team 專案的之版本控制資料夾中的所有檔案。 如果此資料夾包含許多資料，您的組建可能會浪費建置系統資源和透過下載它不需要大量的資料會拖慢建置流程。

從 [流程] 索引標籤的 [要建置的項目] 欄位中移除項目時，尋找可從工作區中移除的對應。

提示

如需最佳化工作區的詳細資訊，請參閱 最佳化工作區。

使用 $(SourceDir) 語彙基元將伺服器資料夾對應至 .. \Sources 子目錄的本機資料夾。

在大部分情況下，組建代理程式上原始程式檔的最佳位置是在工作目錄的 ..\Sources 子目錄底下。 在 [組建代理程式資料夾] 方塊中使用 $(SourceDir) 語彙基元，即可指定這個位置。

請注意，工作區是如何影響簽入所觸發的組建定義。

如果您已經將組建定義的 [觸發程序] 設為 [連續整合]、[正在復原組建] 或 [閘道簽入]，您對應的伺服器資料夾會繫結至建置流程。 這個範例。 開發人員簽入資料夾的變更。 這個資料夾在組建定義的工作區對應，而該組建定義具有 [閘道簽入] 觸發程序。 變更會封鎖，直到建置流程已完成。

組建定義工作區範例

Roberto (組建工程師) 建立了 Storefront Nightly 組建定義。

組建定義工作區範例

步驟 1 此組建定義會建置兩個方案：$/Core/Controllers/Controllers.sln 和 $/Core/Viewers/Viewers.sln。 因此，它必須對應兩個含有這兩個方案的資料夾、這兩個方案包含的專案，以及這兩個方案所需的所有其他檔案。

步驟 2 為了改進建置流程的效率，Roberto 排除含有建置流程不需要之文件檔案的資料夾：$/Core/Viewers/Docs。

步驟 3 這兩個方案相依於一些來自其他公司元件庫中的二進位碼。 這些二進位碼受到所有權機制保護，要求它們必須位於特定的實體資料夾：c:\adatum\widgets。

複製工作區中的資料

把對應從一個工作區複製到另一個工作區，可以節省時間。

若要從其中一個工作區複製對應

  1. 按一下 [複製現有工作區]。

  2. 在 [選擇要複製的工作區] 對話方塊中，從工作區複製對應。

若要從另一個組建定義工作區或另一個小組成員的工作區複製對應

  1. 請執行下列其中一個步驟：

    • 若要從另一個組建定義工作區複製對應物件，請開啟組建定義，然後按一下 [工作區] 索引標籤。

    • 若要從另一個小組成員的工作區複製對應物件，請要求該小組成員開啟 [檔案] 功能表，然後按一下 [原始檔控制]，再按一下 [工作區]。 選取該工作區，然後按一下 [編輯]。

  2. 以滑鼠右鍵點選 [工作資料夾] 資料表中的資料列，然後按一下 [全選]。

  3. 以滑鼠右鍵點選 [工作資料夾] 資料表中的資料列，然後點選[複製]。

  4. 建立一個文字檔，然後將 [剪貼簿] 內容複製到該文字檔，再加以儲存。

  5. 建立一個組建定義，或修改現有的組建定義，其為您所複製之對應的目標。

    如需詳細資訊，請參閱建立組建定義或編輯組建定義。

  6. 在 [工作區] 索引標籤上，以滑鼠右鍵按一下 [工作資料夾] 資料表中的資料列，然後按一下 [貼上]。

  7. 視需要調整供組建代理程式使用的對應。 尤其確認 [組建代理程式資料夾] 方塊中的值是正確的，或包含 $(SourceDir) 語彙基元，視何者適用而定。

了解組建工作區的運作方式

在建置流程期間，組建代理程式會進行編譯並另外處理原始程式檔。 在組建代理程式處理這項工作之前，會先將檔案從版本控制伺服器上的資料夾下載至本機工作目錄。 為了加快下載這些檔案的速度，組建代理程式會建立一個版本控制工作區，將伺服器上的資料夾對應至組建代理程式的本機工作目錄資料夾。

組建工作區扮演的角色

在建置流程開始前

步驟 1 在建置系統中為每個組建代理程式設定工作目錄。 如需詳細資訊，請參閱部署和設定組建代理程式。

步驟 2 當您建立組建定義時，在 [工作區] 索引標籤上指定那些包含您要下載之檔案的資料夾，以及這些資料夾應該如何對應至組建代理程式的本機資料夾。

在建置流程期間

步驟 3 建置流程會將您的工作區規格傳遞至 CreateWorkspace 活動 工作流程活動，以便在其工作目錄中建立工作區。

步驟 4 建置流程會使用 DownloadFiles 活動 活動將檔案下載至工作區。 在這個步驟之後，組建代理程式會開始處理 (如編譯) 這些檔案。