TortoiseSVN-分支管理


一、分支与合并的概念

分支:版本控制系统的一个特性是能够把各种修改分离出来放在开发品的一个分割线上。这条线被称为分支。分支经常被用来试验新的特性,而不会对开发有编译错误的干扰。当新的特性足够稳定之后,开发品的分支就可以混合回主分支里(主干线)。

合并:分支用来维护独立的开发支线,在一些阶段,你可能需要将分支上的修改合并到最新版本,或者将最新版本的修改合并到分支。

二、 SVN分支的意义

简单说,分支就是用于区分开发版本与当前发布版本的。

  1.  主干负责新功能的开发
  2.   分支负责修正当前发布版本的bug(对于可以放入下个发布版本的改进性bug可以直接在主干上开发)
  3.  分支上修改的bug,经常性merge到主干上,尽量及时merge(避免大面积红色区域)。
  4.  只能分支往主干靠拢(merge),不能反向!
  5. 直到下个新版本发布,该分支停止修改

三、 如何创建分支与合并分支

1、将一个整项目建一个分支

建立时要注意:

  1. 当前复制源,即专业术语中的 "主干(truck)"
  2. 分支存放的位置. 当然,分支也是在SVN版本库中.
  3. 写上日志.这个大家应该懂的.
  4. 是否把主干的路径切换到分支.如果勾选了,建立分支后,在主干里做出的修改并提交后,更新会提交到分支上。主干的版本源内容不会变.

这时我们看一下 trunk 目录的属性,可以看到它的路径已经变成: /calc/branches/my-calc-branch 了。

为了避免产生困惑。以及失误。在建立的时候不要勾上 "切换到分支" 的选项。如果勾上了,我们还是切换回去:

注意:

  1. 主干的目录
  2. 版本库源路径

这时你便可以在 /calc/branches/my-calc-branch 分支上开发新的功能,且不会影响到其他成员开发或维护主干的内容。

2、合并主干的变更

也许过了一段时间,原本的 /calc/trunk 主干可能已经有其他成员陆续修正了一些 Bugs,但这时你的分支 /calc/branches/my-calc-branch 就可以直接套用主干 ( /calc/trunk ) 的更新,除了避免重复的工作外 ,也可以避免版本的冲突,因为多人改同样的文件可能发生冲突。

经常將 开发主干 ( /calc/trunk ) 的变更透过 svn merge 合并至 分支 ( /calc/branches/my-calc-branch ) 是一个非常好的习惯,这样才不会让你脱离主干(trunk) 过久而导致将分支 ( /calc/branches/my-calc-branch ) 合并回 主干 ( /calc/trunk ) 时发生许多冲突。

从主干 ( /calc/trunk ) 合并至分支 ( /calc/branches/my-calc-branch ) 通常选第 1 个,也就是 [Merge a range of revisions]

注意.我们是在分支上使用的 Merge 功能.因为是要在分支上应用主干的更新。

在 Merge 的窗口有以下注意事項:

1.合并的来源,由于我们打算从主干 ( /calc/trunk ) 合并至分支 ( /calc/branches/my-calc-branch ),所以合并的來源要选 /calc/trunk 才对!
2.合并的结果会直接与目前「工作目录」(Working Copy) 做比对,并修改目前工作目录中的所有文件。因此建议在做合并之前可以将所有尚未 commit 的档案先 commit 到版本库,避免不必要的冲突事件发生。

在正式进行合并(Merge)之前,建议先执行 Test merge 看看是否会发生什么事!

若无异状则可直接按下 [Merge] 按钮进行合并动作,这时从 主干 ( /calc/trunk ) 分支出来的到目前工作目录的版本就会做个比较,然后直接套用变更到你现有的文件、目录或属性里。

在合并之后如果没有发生冲突,不代表真的没冲突,所以必须再次对原始码做出验证后才能 commit 进版本库,建议可参考以下流程:

1.将项目进行建置(Build)
2.如果没问题再对项目进行单元测试(Unit Testing)或手动测试(Manual Testing)
3.如果都没问题再 commit 目前合并无误的版本到版本库!

3、合并分支到主干

最后我们的 my-calc-branch 分支已经将新功能开发完成且测试无误,所以要将 分支 ( /calc/branches/my-calc-branch ) 的最终版本合并回 主干 ( /calc/trunk ),这时的手续如下:

从 分支 ( /calc/branches/my-calc-branch ) 合并回 主干 ( /calc/trunk ) 通常选第 2 个,而特别选择 [Reintegrate a branch] 这个选项是很重要的,因为这有以下好处:

  1. 让 Subversion 能知道 主干 ( /calc/trunk ) 是从哪个分支、哪些版本合并进来的
  2. 有效节省 Subversion Repository (SVN储存库) 的空间,因为不用重复储存分支的所有变更信息
  3. 可以产生 Revision graph 得知项目开发的分支状况

一样可以先 测试合并(Test merge) 再正式进行 合并(Merge)。

 

合并完后再将变更commit 到版本库

4、删除使用完毕的分支

当 分支 ( /calc/branches/my-calc-branch ) 合并回 主干 ( /calc/trunk ) 并 commit 了之后,该分支就没用了,该分支如果未来不再更新或继续开发,Subversion 也不会继续追踪这个分支的变更 (因为之前已经 Reintegrate 过了),建议将该分支删除。