[VSTS/TFS] Branch and Merge with VSTS (Visual Studio Team Services) (如何在 VSTS 進行分支與合併)

前言

一直很想實作如何在 Visual Studio Team Servcies (VSTS, 舊名為 Visual Studio Online) 進行程式的分支與合併, 畢竟切版本, 在軟體開發過程, 是無法避免的.

整個過程大致如下:

一.  在 Visual Studio Team Services 建立 Team 專案

二.  在 Visual Studio 2015 建立空白方案

三.  在 Visual Studio 2015 加入 ASP.NET MVC 新專案

四. 加入至原始檔控制

五. 建立 主分支 (Main Branch)

六. 建立 工作分支 (Working Branch)

七. 在 工作分支 (Working Branch) 開始作開發及程式修訂

八. 確定沒問題了, 該併回主分支(Main Branch) 了

一.  在 Visual Studio Team Services 建立 Team 專案

1.. 以 Microsoft Account 登入 Visual Studio Online Service, 選取 [New]

2..輸入專案名稱(VSTSBranchDemo2)及版控方式(Team Foundation Version Control),按下[Create Project]

3..建立完成會出現以下畫面,按[Navigate to Project],查看建立的Team專案狀況

4.. 出現如下頁面時, 先按右上角的 [X], 先行跳過

5.. 最後的結果:

二.  在 Visual Studio 2015 建立空白方案

註:為使方案名稱與專案名稱不同,所以先建一個空白方案,後續再加入新專案

1.. 建立空白方案: 一開始先 '不要' 加入原始檔控制, 否則預設會是本機的 Git

三.  在 Visual Studio 2015 加入 ASP.NET MVC 新專案

1..加入一個最簡單的ASP.NET MVC專案

專案建立完成

按下[全部儲存],以儲存 .sln 的異動


建置方案, 確定目前版本OK, 才加入原始檔控制

四. 加入至原始檔控制

1..確定目前已連到VSTS,否則,加入至原始檔控制,預設會是Git

這邊只要確定有連接上即可, 不需要選任何 Team 專案

2..將方案加入至原始檔控制

這裡一定要注意, 要改位置, 不然後續的版控設定會有問題

預設配置:

要將'輸入方案資料夾名稱'清空

在 {方案總管} 可以看到程式項目前方出現 '+' 號, 代表本機新增的項目, 但尚未簽入至 VSTS

3..簽入最原始的版本

項目高達240個, 原因是加入了packages下的檔案, 這些可以不用納入版控;所以先 [排除]

終於可以簽入了,記得要寫入'註解'

五. 建立 主分支 (Main Branch)

1..到{原始檔控制總管}看一下目前的狀況,先將packages資料夾下子資料夾全部刪除,以避免納入版控

取得最新版本, 以便將 BuildProcessTemplates 也取回本機

最後結果

2..在{原始檔控制總管},新增資料夾,名稱為Main (代表主分支)

3..把MvcWeb資料夾, VSTSBranchDemo3.sln及VSTSBranchDemo3.vssscc移到Main資料夾下

回到{Team Explorer}的[暫止的變更]進行[簽入]

回到 {檔案總管}, 把多餘的資料夾移除

註: 雖說可以移除, 但為了保險起見, 還是建議另建資料夾保留, 以防萬一

4.. 把 Main 資料夾 轉換為分支

在{原始檔控制總管}查一下結果, Main前方的圖示,已經改變為分支符號

六. 建立 工作分支 (Working Branch)

1.. 在 {原始檔控制總管} 點取 Main, 按右鍵, 進行分支

分支完的結果

按右鍵,取得最新版本

此時,我們就有2個分支了,一個Main,一個Working

要改Main的版本或Working的版本, 記得要在對的資料夾開 .sln

七. 在 工作分支 (Working Branch) 開始作開發及程式修訂

1.. 在檔案總管的 VSTSBranchDemo3 資料夾下, 有 Main 及 Working 這2個子資料夾

2..進到Working子資料夾,開啟VSTSBranchDemo3.sln方案

點取方案,確定一下路徑是來自Working

2..打開Views\Home\About.cshtml,開始改程式

把以下的"About",改為"關於"

//ViewBag.Title ="About";

ViewBag.Title ="關於";

3.. 執行看看, 確定測試 OK, 就可以簽入到 VSTS 了.


簽入至 VSTS

4.. 查一下 工作分支(Working) 的異動記錄, 確定有簽入

八. 確定沒問題了, 該併回主分支(Main Branch) 了

1..開啟{原始檔控制總管},選取Working;選取[合併]

請注意: 上面那個對話框有提到, 合併作業是在本機的工作區進行, 必須進行簽入作業, 才能將變更認可到伺服器.

所以請到 '暫止的變更', 看一下狀況, 有1個異動 ( About.cshtml ), 且是在 Main 子資料夾下, 代表要 [簽入] 後, 才會更新到 VSTS 的 Main 分支

2..回到主分支(Main),查一下異動記錄,確定有剛才所作的簽入

九. 參考文件

1.. Microsoft, Connect to Visual Studio Team Services from Eclipse, Xcode, Visual Studio, and more

2.. Microsoft, Branch folders and files

3.. StackOverflow, How to work with files on a new branch

4.. StackOverflow, How to branch my Visual Studio Online (TFS) Solution?