分支管理介绍
先说说什么是branch。
branch [br?nt?] n. 分支; 树枝; 部门,分科; 支流; vi. 分支形成; 分支扩张; [计] 下分支的指令; vt. 使分支; 使分叉;
trunk [tr??k] n. 树干; 躯干; 象鼻; 汽车车尾的行李箱;
merge [m?:rd?] vt.融入; (使)混合; 相融; 渐渐消失在某物中;
1
branch [br?nt?] n. 分支; 树枝; 部门,分科; 支流; vi. 分支形成; 分支扩张; [计] 下分支的指令; vt. 使分支; 使分叉;
2
trunk [tr??k] n. 树干; 躯干; 象鼻; 汽车车尾的行李箱;
3
merge [m?:rd?] vt.融入; (使)混合; 相融; 渐渐消失在某物中;
按照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,包括创建分支、分支开发、分支和主线同步,分支合并到主线的全过程。
1、创建仓库
假设我要在D:\TortoiseSVN\TestRepository目录中创建repository,只需右键TestRepository目录,依次选择"TortoiseSVN" -> "Create repository here"便完成了repository的创建。
2、检出资源
假设要check out到D:\TortoiseSVN\TestSVN。在D:\TortoiseSVN目录下创建TestSVN目录,然后在该目录上右键,选择"SVN Check out...",在弹出的窗口中的"URL of repository"中填入"file:///D:/TortoiseSVN/TestRepository",其他默认即可,最后点击ok。
3、创建项目
在主线trunk中创建新项目MyProject
4、创建分支
在 /trunk/MyProject 目录上右键,依次选择 TortoiseSVN --> Branch/tag...,在弹出窗口的【To URL】中填入分支的地址,在这里【目标revision】选择HEAD revision,然后添加log,点击ok后分支便建立了。
5、检出分支
在TestSVN目录右键,选择 TortoiseSVN Update 即可将刚刚建立的分支检出到本地。进入 /branches/MyProject 目录下你会发现其文件结构和 /trunk/MyProject 一模一样,因为目前此分支就是 trunk 的一个拷贝。
6、开发分支branch和主线trunk
在分支中修改并提交一个修改。
在trunk中修改并提交一个修改。
在分支中再修改并提交一个修改。
7、核心步骤:将主线trunk中的修改同步到分支branch中
前面第6步演示的是branch和trunk在独立、并行地开发。为了防止在错误的道路上越走越远,现在branch意识到是时候和trunk来一次同步了。
将主线trunk合并到分支branch的步骤:
- 1、首先在本地主线trunk中update一下,有冲突的解决冲突,保证trunk和repository已经完全同步。
- 2、然后在 /branches/MyProject 上右键,依次选择 TortoiseSVN --> 【Merge...】 --> 在弹出的窗口中选择第一项 【Merge a range of revision】,意思是:将某个分支或主线上提交的多个revision间的变化,合并到另外一个分支上。
- 3、点击next,由于是要从主线trunk合并到分支branch,所以这里的 URL to merge from 应该填主线trunk的路径,Revision range to merge 就是你要将主线trunk的哪些revision所对应的变化合并到当前分支branch中。
- 4、点击next,这里只需保留默认设置即可。在点击Merge按钮前你可以先Test merge一把,看成功与否,以及merge的详细信息。点击Merge按钮后trunk所做的修改将同步到branch中。
8、提交合并后的branch
至此,branch已经完全和trunk同步,branch和trunk的代码相处很融洽,没有任何冲突。
如果branch已经开发结束,那就是时候将branch合并回trunk了,当然,如果branch还要继续开发,那你将不断地重复6-7这几个步骤。
9、核心步骤:将分支branch合并回主线trunk
在主线的目录 /trunk/MyProject 上右键,依次选择 TortoiseSVN -> Merge... ,在弹出的窗口中,Merge type选择第二项 Reintegrate a branch ,这种类型的合并,适合在分支branch开发结束后将所有的改动合并回主线trunk。
在点击next后弹出的窗口中,"From URL"选择 /branches/MyProject,无需选择revision,Reintegrate会将branch上所有修改合并到trunk。
后面的步骤和上文第7步中的一样。
如无意外,branch将成功合并到trunk,你需要做的只是将合并后的主线trunk赶紧commit!
10、提交合并后的trunk
so easy...
11、删除branch
如果你认为你新加的功能已经开发完成了,你可以删除你的分支