共用方式為

逐步解說：探索 Team Foundation 版本控制

  • 發行項

更新：2007 年 11 月

本逐步解說將示範 Visual Studio Team System Team Foundation Server 中的版本控制整合功能。

本逐步解說將說明如何在 Visual Studio Team System Team Foundation Server 的 IDE 內使用版本控制。特別的是，您可以學習如何完成下列工作：

  • 將 Team Foundation 版本控制設定為 Visual Studio Team System Team Foundation Server 預設的版本控制外掛程式。

  • 在 Visual Studio 中建立新的專案。

  • 將專案加入至版本控制，進而建立本機工作區 (Workspace)，以便在其中儲存、編輯和測試您的版本控制檔案。

  • 簽入您的方案。

  • 在版本控制的專案中加入檔案，並編輯現有的檔案。

  • 讓版本控制伺服器認可本機工作區中所有暫止的變更。

必要條件

在您完成這個逐步解說以前，您必須：

必要的使用權限

若要完成這個逐步解說，您必須擁有 Read 和 Checkin 權限。

將 Team Foundation 版本控制設定為原始檔控制外掛程式

在使用 Team Foundation 版本控制之前，您必須將 Visual Studio 設定為使用 Team Foundation 版本控制外掛程式，如下列程序所示。如需詳細資訊，請參閱 HOW TO：設定 Visual Studio 以使用 Team Foundation 版本控制。

注意事項：

當您在安裝 Visual Studio 後安裝 Team 總管時，Visual Studio 會自動設定為使用 Team Foundation 版本控制外掛程式。

若要設定 Visual Studio 以使用 Team Foundation 版本控制

  1. 在 [工具] 功能表中，選取 [選項]。

  2. 在 [選項] 對話方塊中，找出 [原始檔控制] 並將它展開，然後按一下 [外掛程式選擇]。

  3. 在 [目前的原始檔控制外掛程式] 下拉式清單中，選取 [Visual Studio Team Foundation Server]。

  4. 按一下 [確定]。

將專案加入至版本控制

建立專案時，您可能會想要將這些專案加入至版本控制，以便在 Team Foundation 版本控制內管理這些專案。第一次將專案加入至版本控制時，Team Foundation 版本控制會為您建立一個工作區。工作區 (Workspace) 是指 Team Foundation 伺服器上之檔案和資料夾的用戶端複本。在加入、編輯、刪除、移動、重新命名或管理任何版本控制項目時，您所做的變更便會保存在用戶端。在本機電腦的工作區中，會將這些變更當做暫止的變更來追蹤。

工作區提供了獨立的空間，您可以在其中撰寫和測試程式碼，您的修改不會對簽入之原始檔的穩定性造成影響。您與工作夥伴所做的變更會相互隔離。在將工作區內暫止的變更簽入，而讓 Team Foundation 伺服器認可 (Commit) 這些變更之前，這些變更會維持在隔離的狀態。

您可以在電腦上為每一部 Team Foundation 伺服器都建立一個工作區。如需詳細資訊，請參閱使用版本控制工作區。

若要建立新的方案和專案

  1. 在 [檔案] 功能表上，按一下 [新增]，然後再按一下 [專案]。

  2. 在 [新增專案] 對話方塊中，於 [專案類型] 窗格內選取 [Visual C# ]。

  3. 在右窗格中，按一下 [Windows Form 應用程式]。

  4. 在 [名稱] 方塊中輸入 MyWindowsApp，然後在 [位置] 方塊中輸入路徑。

  5. 選取 [加入至原始檔控制] 方塊，然後按一下 [確定]。

  6. 在 [將方案加入至原始檔控制] 方塊中，選取要用於此逐步解說的 Team 專案。

  7. 按一下 [確定]。

您也可以從命令列或 Visual Studio 的功能表加入方案和專案，不過用這些方式加入專案和方案並不會進行繫結。繫結可提供版本控制的功能，包括在 [方案總管] 中表示狀態的各種版本控制圖示。如需詳細資訊，請參閱 HOW TO：繫結和解除繫結專案及方案、Add 命令和 HOW TO：將非專案或非方案的檔案和資料夾加入至版本控制。

暫止的變更視窗

[暫止的變更] 視窗會提供關於工作區內暫止變更的狀態資訊。您可以使用它來追蹤與變更關聯的資訊，例如相關的工作項目和簽入提示。您可以使用 [檢視] 功能表存取 [暫止的變更] 視窗。如需詳細資訊，請參閱使用簽入和暫止的變更視窗。

注意事項：

您應該從伺服器取得所有相關原始檔的最新版本並編譯程式碼，確認建置時沒有任何錯誤，然後再簽入暫止的變更。

接著您必須使用 [暫止的變更] 視窗，將新的方案檔簽入版本控制。

若要將方案的暫止變更簽入版本控制

  1. 在 [建置] 功能表中按一下 [建置方案]，以確認應用程式建置時沒有任何錯誤。

  2. 如果尚未開啟 [暫止的變更] 視窗，請按一下 [檢視] 功能表上的 [其他視窗]，然後按一下 [暫止的變更]。

    [暫止的變更] 視窗會將您的方案檔列為 [加入]。這表示這些檔案已經在您的工作區中建立，但是尚未加入至伺服器。

  3. 在 [暫止的變更] 視窗對話方塊的 [註解] 方塊內，輸入「將新專案加入至版本控制」的註解。

  4. 按一下 [簽入] 將暫止的加入變更簽入伺服器。

    如需詳細資訊，請參閱暫止的變更和 HOW TO：簽入暫止的變更。如需詳細資訊，請參閱將變更送出至版本控制伺服器。

編輯版本控制的專案

版本控制屬於 Visual Studio 開發工作的一部分，而且已完全整合到其中。例如，當您將檔案加入到版本控制的專案時，Visual Studio 會以無訊息模式簽出並自動更新專案檔。

當您將檔案加入到版本控制的專案時，Visual Studio 會假設您想要以某個方式編輯檔案，然後再將檔案提供給工作夥伴使用。因此，新加入的檔案不會自動簽入，而且版本控制會將此動作視為暫止的加入動作。當您明確簽入未認可的變更時，就會在伺服器內建立新的變更集

若要將檔案加入至版本控制的專案

  1. 以滑鼠右鍵按一下 [方案總管] 中的專案，然後按一下 [加入]，再按 [類別]。

  2. 在 [加入新項目] 對話方塊中，按一下 [加入]，將 Class1.cs 加入到專案中。

Class1.cs 會與 [暫止的變更] 視窗中的其他專案檔一起出現，而且其 [變更類型] 為 [加入]。在 [方案總管] 中，您可以看到專案的信號圖示已經從藍色鎖變成紅色核取記號，這個圖示表示專案檔已經簽出。請注意，Class1.cs 旁會出現加號 (+)，表示目前有暫止的新增項目。

當您決定編輯已簽入的專案檔時，會以無訊息模式自動簽出這些檔案。

若要編輯版本控制專案中的現有檔案

  1. 在 [方案總管] 的 [屬性] 資料夾上，按兩下 AssemblyInfo.cs。

  2. 在程式碼編輯器中，將類似 using System.IO.Ports; 的新 using 指示詞加入到此檔。

請注意，當您開始編輯 AssemblyInfo.cs 時，Team Foundation 便會自動將它簽出。在 [方案總管] 中，它的信號圖示會變成核取記號，系統會此檔案加入 [暫止的變更] 視窗中的原始程式檔清單內。

讓工作區與最新的伺服器版本同步

您可以使用「取得最新的版本」作業，使工作區內的檔案與最新的伺服器版本保持同步。如果您在簽入之前都先進行同步處理及建置，則可以避免發生整合組建中斷的情形。當您和另一位使用者都簽入非衝突性但互不相容的變更 (兩者結合會讓應用程式無法編譯) 時，可以中斷建置。

若要從伺服器將最新的版本擷取至您的工作區和組建

  1. 以滑鼠右鍵按一下 [方案總管] 中的方案，然後按一下 [取得最新的版本 (遞迴)]。

  2. 在 [建置] 功能表中按一下 [建置方案]，以確認應用程式建置時沒有任何錯誤。

將暫止的變更簽入到伺服器

一旦確定應用程式是使用最新的版本建置，您就可以將變更簽入至 Team Foundation 版本控制，並讓其他小組成員可以看到此專案。

注意事項：

如果應用程式因為您沒有時間進行測試，或是要讓其他開發人員檢閱程式碼而尚未建置，那麼可以先將變更擱置，不要簽入。如需詳細資訊，請參閱使用版本控制擱置集。

您可以使用下列方式簽入暫止的變更：

  • 使用 [檔案] 功能表的 [原始檔控制] 子功能表。

  • 在 [方案總管] 或原始檔控制總管中，以滑鼠右鍵按一下已簽出的檔案。

  • 在 [暫止的變更] 視窗中按一下 [簽入]。

若要將所有暫止的變更都簽入至伺服器

  1. 按一下 [檢視] 功能表上的 [其他視窗]，然後按一下 [暫止的變更]。

  2. 在 [暫止的變更] 視窗的 [註解] 方塊中輸入註解，說明變更的性質。

    例如，您可以輸入「加入 using 指示詞」，以及「為了啟用對 Directory 類別的呼叫」，說明變更的原因。

  3. 開啟 [工作項目] 通道，並選取與暫止的變更有關的任何工作項目。

    如需詳細資訊，請參閱 HOW TO：使工作項目與變更集產生關聯。

  4. 開啟 [簽入提示] 通道，並為 [程式碼檢閱者]、[安全性檢閱者] 和 [效能檢閱者] 的簽入提示加入註解。

    注意事項：

    簽入提示可以由系統管理員設定為強制欄位。這些簽入提示必須在簽入程序期間完成。在文字方塊背景中，強制性欄位會以灰色表示。

    如需如何建立簽入提示和建立工作項目轉換的詳細資訊，請參閱逐步解說：自訂簽入原則與簽入提示。

  5. 按一下 [簽入]。

Team Foundation Server 簽入流程的設計，是為了提供個別使用方便性及小組擴充性。為了獲得最佳的使用方便性，[暫止的變更] 視窗基本上會假設您想要簽入所有的變更；但是，您也可以輕易地個別將不想簽入之暫止的變更排除；通常簽入會套用整組相關的變更，而不是個別的變更。相反地，當您從 [方案總管] 或 [檔案] 功能表簽入時，Visual Studio 會假設您只想要簽入選定項目的變更。當您選取檔案容器 (例如，專案或方案) 時，即表示選取要簽入該項目及其內含的項目。

Team Foundation Server 管理員可以將一組自訂的「簽入原則」(Check-in Policy) 與 Team 專案產生關聯，確保所有的簽入項目都符合特定的方針或需求。

個別的小組成員可以建立「工作項目」(Work Item)，追蹤產品的缺失或功能需求，並使工作項目與特定專案產生關聯。當您完成工作項目時，可以在 [暫止的變更] 視窗的 [工作項目] 通道上將它標記為與來源變更有關聯；當您讓工作項目與來源變更產生關聯時，就可確保責任歸屬並得以詳細追蹤工作狀態。

最後，您和其他小組成員都可以在每一個簽入中加入有意義且一致的提示。用來建立 Team 專案的流程範本會決定簽入提示的形式和內容。Team Foundation Server 管理員可以為您的小組自訂範本。簽入提示可包括以下分類：效能影響、文件需求、測試指示和建置指示。

簽入流程

當您按一下 [簽入] 時，系統會將所選的原始程式檔和 [暫止的變更] 視窗中指定的簽入提示與工作項目搭配在一起，Team Foundation 版本控制接著會將此配套上載到 Team Foundation 並將其認可為新的變更集。「變更集」指的是一組檔案修訂、簽入提示、關聯的工作項目和版本控制中繼資料，是儲存在伺服器上並方便管理的單一實體。如需詳細資訊，請參閱使用版本控制變更集。

再來，變更集所包含的工作項目都會更新，使其包含可連回新建變更集的連結。

然後會根據現有且預先定義的處理規則，在工作流程當中進行工作項目轉換；例如，您的小組可能會定義一個規則：當您簽入 Bug 時，如果它的子狀態是「有修正可用」，則自動將 Bug 的狀態從「作用中」變更為「已解決」。這些處理規則和工作流程是由用來建立 Team 專案的流程範本所建立，但是可由 Team Foundation Server 系統管理員加以修改或自訂。如需詳細資訊，請參閱自訂流程範本。

最後，Team Foundation 版本控制會產生電子郵件，告知要收到簽入告知的小組成員。

後續步驟

當您完成本逐步解說的步驟之後，您可以進一步了解 Team Foundation 版本控制中的某些進階功能。如需詳細資訊，請參閱逐步解說：版本控制的進階功能。此逐步解說將說明如何對版本控制項目進行分支、合併及套用標籤。

請參閱

工作

逐步解說：建立新的 Team 專案

概念

使用簽入和暫止的變更視窗

其他資源

Team Foundation 版本控制逐步解說

使用 Team Foundation 版本控制