TortoiseSVN中Branching和Merging實踐

作者:eggcalm
來源:http://blog.csdn.net/eggcalm/article/details/6606520

使用svn幾年了,一直對分支和合並敬而遠之,一來是因爲分支的管理不該我操心,二來即使涉及到分支的管理,也不敢貿然使用合併功能,生怕合併出了問題對團隊造成不良影響,最主要的原因是,自己對分支的目的和合並的方法不甚瞭解,這纔是硬傷。

最近由於適配機型的需要(本人從事手機客戶端的開發),需要經常接觸分支和合並兩項工作,突然發現這玩意整不明白很難開展工作,遂這兩天着重研究了一下,有點收穫,怕以後忘了,故趁着餘溫尚在趕緊寫下來,好記性不如爛筆頭嘛。下文的實踐主要是參考了TortoiseSVN的幫助文檔和Subversion的在線文檔,Subversion的在線文檔:http://svnbook.red-bean.com/en/1.5/svn-book.html

話說我公司現在的源代碼管理挺亂的,svn目錄並沒有採取標準的source/branches、source/trunk結構,主線和分支放得到處都是,release版本也並沒有當成tag處理,而是當成branch來管理,經常還要在release版本上改來改去。。。

先說說什麼是branch。按照Subversion的說法,一個branch是某個development line(通常是主線也即trunk)的一個拷貝,見下圖:

這裏寫圖片描述

branch存在的意義在於,在不干擾trunk的情況下,和trunk並行開發,待開發結束後合併回trunk中,在branch和trunk各自開發的過程中,他們都可以不斷地提交自己的修改,從而使得每次修改在repository中都有記錄。

設想以下場景,如果你的項目需要開發一個新功能,而該功能可能會修改項目中的絕大多數文件,而與此同時,你的另一位同事正在進行bug fix,如果你的新功能不在branch中開發而直接在trunk中開發,那麼你極有可能影響另一位同事的bug fix,他/她在bug修復中可能會遇到各種各樣的問題,因爲你的頻繁提交代碼引入了過多的不穩定因素。你可能會說,那我在開發的過程中不提交不就行了,等到我全部開發結束我再提交,是,你可以這麼做,那還要版本控制幹什麼呢?也許等到你最後提交代碼的時候(也許一週,也許兩週?),你會發現有一大堆conflict等着你resolve。。。

那麼,正確的做法是什麼?使用branch,從trunk創建branch,然後在你的branch上開發,開發完成後再合併到trunk中。

關於branch先講到這裏,下面說說什麼叫做合併。很好理解,當branch開發完成後(包括必要的測試),將branch中的修改同步到trunk中,這個過程有可能包括修改文件、增加文件、刪除文件等等。

說到這裏,貌似本文差不多可以結束了,不就是分支和合並麼?只要再簡單地說說如何建立分支和如何合併就可以收尾了,可能只需兩個命令,也可能只需鼠標點幾下然後鍵盤敲兩下即可。其實事情遠非這麼簡單,愛動腦筋的同學可能會問了,將branch的改動merge到trunk的時候,和上文說的直接在trunk中全部開發完然後提交有何區別?你最後還不是要處理一大堆conflict?

這個問題問得非常好,其實這正是本文的重點:branch和trunk在並行開發的過程中如何感知對方,branch如何才能在開發過程中不會和trunk越走越遠,導致最後無法合併?試想一下,如果在你開發branch的過程中,trunk中的某個類文件已經被刪除了(這可能是另外一個傢伙在另一個branch上開發了兩週後才合併到trunk的),而你竟然在這個類文件上做了大量修改,試問你到最後合併回trunk的時候該有多蛋疼?解決這一問題的唯一手段是,branch要不停地和trunk保持同步,你要及時地知道trunk都做了什麼修改,這些修改是否會影響你正在開發的新功能,如果需要,你必須及時調整branch的代碼,使之能與trunk“兼容”。

那麼如何讓branch和trunk保持同步?合併,從trunk合併到branch,你沒聽錯,是從trunk合併到branch。關於TortoiseSVN的合併,有幾點需要注意:

  • TortoiseSVN的合併發生在本地,也即你的working copy中,你無需過多擔心會對repository中的代碼造成影響
  • 不管是從trunk合併到branch還是最終從branch合併回trunk,在每次合併前最好先update,然後將本地的修改先全部commit,保護好現場,萬一合併不理想隨時都可以revert
  • 合併完成後看是否能正確編譯,然後測試驗證,最後將合併後的改動提交到repository

下面我將step by step地演示如何一次完整的branching和merging,包括創建分支、分支開發、分支和主線同步,分支合併到主線的全過程,甚至包括如何在本地創建一個測試用的repository。

首先需要安裝TortoiseSVN,我安裝的版本是:TortoiseSVN 1.6.15, Build 21041 - 32 Bit , 2011/03/23 18:00:27

1、本地Repository的創建

repository的創建很簡單,假設我要在D:\TortoiseSVN\TestRepository目錄中創建repository,只需右鍵TestRepository目錄,依次選擇”TortoiseSVN” -> “Create repository here”便完成了repository的創建。

2、Check out

假設要check out到D:\TortoiseSVN\TestSVN,同樣很簡單,在D:\TortoiseSVN目錄下創建TestSVN目錄,然後在該目錄上右鍵,選擇”SVN Check out…”,在彈出的窗口中的”URL of repository”中填入”file:///D:/TortoiseSVN/TestRepository”,其他默認即可,最後點擊ok。

3、trunk創建新項目MyProject

相當簡單就不贅述了,只列出本次操作所作出的修改:
這裏寫圖片描述

4、創建branch

在/trunk/MyProject目錄上右鍵,依次選擇”TortoiseSVN” -> “Branch/tag…”,在彈出窗口的”To URL”中填入分支的地址,在這裏目標revision選擇HEAD revision,如下圖所示,添加log後點擊ok分支便建立了。這個操作速度非常快,新建的branch在repository中其實只是一個指向trunk某個revision的軟連接而已,並沒有真的複製文件。
這裏寫圖片描述

5、Check out分支

右鍵TestSVN目錄選擇”TortoiseSVN Update”即可將剛剛建立的分支下載回本地。進入/branches/MyProject目錄下你會發現其文件結構和/trunk/MyProject一模一樣。

6、branch提交一個新文件

這裏寫圖片描述

7、trunk緊接着提交一個修改

這裏寫圖片描述

8、branch再次提交一個修改

這裏寫圖片描述

9、將trunk中的修改同步到branch

6-8演示的是branch和trunk在獨立、並行地開發。爲了防止在“錯誤”的道路上越走越遠,現在branch意識到是時候和trunk來一次同步了(將trunk合併到branch)。

首先,在本地trunk中先update一下,有衝突的解決衝突,保證trunk和repository已經完全同步,然後在/branches/MyProject上右鍵,依次選擇”TortoiseSVN” -> “Merge…”,在彈出的窗口中選擇第一項”Merge a range of revision”,這個類型的Merge已經介紹得很清楚,適用於將某個分支或主線上提交的多個revision間的變化合併到另外一個分支上。

這裏寫圖片描述

點擊next後,出現如下窗口:

這裏寫圖片描述

由於是要從trunk合併到branch,理所當然這裏的”URL to merge from”應該填trunk的路徑,”Revision range to merge”很好理解,就是你要將trunk的哪些revision所對應的變化合併到branch中,可以是某一連串的revision,比如4-7,15-HEAD,也可以是某個單獨的revision號。由於在r4中,trunk修改了Person.Java中的talk()方法,所以這裏的revision只需填4即可。點擊next後出現下圖:

這裏寫圖片描述

在這裏只需保留默認設置即可。在點擊Merge按鈕前你可以先Test merge一把,看成功與否,以及merge的詳細信息。點擊Merge按鈕後trunk所做的修改將同步到branch中。

10、提交合並後的branch

這裏寫圖片描述

至此,branch已經完全和trunk同步,branch和trunk的代碼相處很融洽,沒有任何衝突,如果branch已經開發結束,那是時候將branch合併回trunk了,當然,如果branch還要繼續開發,那你將不斷地重複6-10這幾個步驟。

11、將branch合併回trunk

在/trunk/MyProject上右鍵(注意是在主線的目錄上右鍵),依次選擇”TortoiseSVN” -> “Merge…”,在彈出的窗口中,Merge type選擇第二項”Reintegrate a branch”,這種類型的合併適合在分支開發結束後將所有的改動合併回主線。

這裏寫圖片描述

點擊next後出現如下窗口:

這裏寫圖片描述

在這裏,”From URL”選擇/branches/MyProject,無需選擇revision號,Reintegrate會將branch上所有修改合併到trunk。後面的步驟和上文第9步中的一樣,不再囉嗦了。如無意外,branch將成功合併到trunk,你需要做的只是將合併後的trunk趕緊commit!

12、提交合並後的trunk

so easy…

13、刪除branch

如果你認爲你新加的功能已經開發完成了,你可以刪除你的分支

到這裏,我已經給你演示完了整個過程,我一身的汗也下來了,我想罷工了,不過最後我們還是看看所有的log信息吧,通過log能發現我們乾的所有事情:

這裏寫圖片描述

r1-r7正是我上文在乾的事情,從Message中你能發現我對trunk和branch都幹了什麼,另外,在Log Messages窗口的左下角勾選了”Include merged revisions”你還能看到額外的Merge information:

這裏寫圖片描述

圖中灰色的是和merge相關的log,共發生了兩次merge,第一次是在r6,在r6中,branch合併了trunk在r4時提交的變化;第二次是在r7,在r7中,trunk合併了branch從r2到r6的所有變化。

終於可以寫寫總結了:

  1. branch主要用於新功能的開發
  2. 合併發生在本地working copy,只要你不提交就不會影響到repository
  3. 合併前一定要先update、commit,保證不會out of day,並將本地的修改保存到repository
  4. branch和trunk並行開發的過程中,要經常同步,將trunk的修改合併到branch,合併時選擇”Merge a range of revision”
  5. branch最後合併回trunk時,merge type選擇”Reintegrate a branch”
發佈了59 篇原創文章 · 獲贊 20 · 訪問量 13萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章