天天看點

TortoiseSVN 分支和合并

使用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)的一個拷貝,見下圖:

TortoiseSVN 分支和合并

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

相當簡單就不贅述了,隻列出本次操作所作出的修改:

TortoiseSVN 分支和合并

4、建立branch

在/trunk/MyProject目錄上右鍵,依次選擇"TortoiseSVN" -> "Branch/tag...",在彈出視窗的"To URL"中填入分支的位址,在這裡目标revision選擇HEAD revision,如下圖所示,添加log後點選ok分支便建立了。這個操作速度非常快,建立的branch在repository中其實隻是一個指向 trunk某個revision的軟連接配接而已,并沒有真的複制檔案。

TortoiseSVN 分支和合并

5、Check out分支

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

6、branch送出一個新檔案

TortoiseSVN 分支和合并

7、trunk緊接着送出一個修改

TortoiseSVN 分支和合并

8、branch再次送出一個修改

TortoiseSVN 分支和合并

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間的變化合并到另外一個分支上。

TortoiseSVN 分支和合并

點選next後,出現如下視窗:

TortoiseSVN 分支和合并

由于是要從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後出現下圖:

TortoiseSVN 分支和合并

在這裡隻需保留預設設定即可。在點選Merge按鈕前你可以先Test merge一把,看成功與否,以及merge的詳細資訊。點選Merge按鈕後trunk所做的修改将同步到branch中。

10、送出合并後的branch

TortoiseSVN 分支和合并

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

11、将branch合并回trunk

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

TortoiseSVN 分支和合并

點選next後出現如下視窗:

TortoiseSVN 分支和合并

在這裡,"From URL"選擇/branches/MyProject,無需選擇revision号,Reintegrate會将branch上所有修改合并到 trunk。後面的步驟和上文第9步中的一樣,不再啰嗦了。如無意外,branch将成功合并到trunk,你需要做的隻是将合并後的trunk趕緊 commit!

12、送出合并後的trunk

so easy...

13、删除branch

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

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

TortoiseSVN 分支和合并

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

TortoiseSVN 分支和合并

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

終于可以寫寫總結了:

  • branch主要用于新功能的開發
  • 合并發生在本地working copy,隻要你不送出就不會影響到repository
  • 合并前一定要先update、commit,保證不會out of day,并将本地的修改儲存到repository
  • branch和trunk并行開發的過程中,要經常同步,将trunk的修改合并到branch,合并時選擇"Merge a range of revision"
  • branch最後合并回trunk時,merge type選擇"Reintegrate a branch"

原文:http://blog.csdn.net/eggcalm/article/details/6606520

繼續閱讀