svn merge

先说说什么是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

 

一、本地Repository的建立

repository的建立很简单，假设我要在D:\TortoiseSVN\TestRepository目录中建立repository，只需右键TestRepository目录，依次选择"TortoiseSVN" -> "Create repository here"便完成了repository的建立。

 

二、Check out

假设要check out到D:\TortoiseSVN\TestSVN，一样很简单，在D:\TortoiseSVN目录下建立TestSVN目录，而后在该目录上右键，选择"SVN Check out..."，在弹出的窗口中的"URL of repository"中填入"file:///D:/TortoiseSVN/TestRepository"，其余默认便可，最后点击ok。

 

三、trunk建立新项目MyProject

至关简单就不赘述了，只列出本次操做所做出的修改：

 

四、建立branch

在/trunk/MyProject目录上右键，依次选择"TortoiseSVN" -> "Branch/tag..."，在弹出窗口的"To URL"中填入分支的地址，在这里目标revision选择HEAD revision，以下图所示，添加log后点击ok分支便创建了。这个操做速度很是快，新建的branch在repository中其实只是一个指向trunk某个revision的软链接而已，并无真的复制文件。

 

五、Check out分支

右键TestSVN目录选择"TortoiseSVN Update"便可将刚刚创建的分支下载回本地。进入/branches/MyProject目录下你会发现其文件结构和/trunk/MyProject如出一辙。

 

六、branch提交一个新文件

 

七、trunk紧接着提交一个修改

 

八、branch再次提交一个修改

 

九、将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中。

 

十、提交合并后的branch

 

至此，branch已经彻底和trunk同步，branch和trunk的代码相处很融洽，没有任何冲突，若是branch已经开发结束，那是时候将branch合并回trunk了，固然，若是branch还要继续开发，那你将不断地重复6-10这几个步骤。

 

十一、将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！

 

十二、提交合并后的trunk

so easy...

 

1三、删除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的全部变化。