使用組建工作區

  • 發行項

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

您想要怎麼做？

  • 指定組建定義的工作區

  • 請參閱組建工作區定義範例

  • 在工作區之間複製資料

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

指定組建定義的工作區

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

包含所有必要的資料夾。

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

只包含必要的資料夾。

只將您的建置流程需要的資料夾對應至 [使用中] 的 [狀態] 值。 如果對應資料夾的子資料夾含有建置流程不需要的檔案，將它對應為 [已隱匿] 的 [狀態] 值。 在許多情況下，建立組建定義時，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 活動將檔案下載至工作區。 在這個步驟之後，組建代理程式會開始處理 (如編譯) 這些檔案。