SVN trunk(主线) branch(分支) tag(标记) 用法详解和详细操作步骤

在实现上，branch和tag，对于svn都是使用copy实现的，所以他们在默认的权限上和一般的目录没有区别。

一般情况下：

trunk(主干|主线|主分支)：是用来做主方向开发的，新功能的开发应放在主线中，当模块开发完成后，需要修改，就用branch(比如：新增日志功能的开发，或某些客户的个性化需求)。
branch(分支)：分支开发和主线开发是可以同时进行的，也就是并行开发，分支通常用于修复bug时使用。

tag(标记)：用于标记某个可用的版本，可以标记已经上线发布的版本，也可以标记正在测试的版本，通常是只读的。

使用场景：

比如3.0开发完成，这个时候要做一个tag，即tag_release_3.0，然后基于这个tag做发布。当trunk进入3.1的开发后，发现3.0有bug，那么就需要基于tag_release_3.0做一个分支(branch)，即branch_bugfix_3.0,基于这个进行bug修复。等到bugfix结束，做一个tag,即tag_release_3.0.1。然后根据需求branch_bugfix_3.0是否并入主干。

再如:你的项目的某个版本（例如1.0版本）已经完成开发、测试并已经上线了，接下来接到新的需求，新需求的开发需要修改多个文件中的代码，当需求已经开始开发一段时间的时候，突然接到用户或测试人员的反馈，项目中有个重大bug需要紧急修复，并且要求bug修复后要立即上线；此时应该怎么修复bug呢？是在当前已经开发新需求的基础上进行修复吗？答案是否定的，原因是：如果是在已经开发新需求的基础上进行修复bug，那么新需求还没开发好，更没有测试，怎么立刻（或最可能快的）上线？！再次如果新功能的开发和bug修复的代码都涉及到同一段代码冲突了怎么办 。很显然不能在当前开发的代码基础上进行bug修复工作完美的解决方案是：在当时完成的那个版本中进行bug fix，这样带来的好处是：

1：bug修复好之后可立即上线，不会因为新需求还没有完成或测试而延迟上线时间

2：bug修复是在原来上线的那个版本进行修复的，引起新bug的风险小，如果是在新需求的基础上修复bug, 那么新功能可能会带来新的bug。

在这里需要说明下分三个目录的原因，如果项目分为一期、二期、三期，那么一期上线时的稳定版本就应该在一期完成时将代码copy到branch上，这样二期开发的代码就对一期的代码没有影响，如果新增的模块就不会部署到生产环境上。而branches上的稳定版本就是发布到生产环境上的代码。如果用户使用过程中发现有BUG，则只需在branches上修复BUG，修改完后再编译branches上最新的代码发布到生产环境即可。tags的作用是将branches上修改的BUG代码合并到trunk上时创建个版本标识，以后branches上修改的bug代码再合并到trunk上时就从tags的version到branches最新的version合并到trunk，以保证前期修改的bug代码不会再合并。如果客户想对产品做定制，但是我们并不想修改原有的SVN中trunk的代码，可以用SVN建立一个新的branches，从这个branches做为一个新的起点开发。

SVN仓库目录结构Repository：

trunk
tags
branches

SVN具体操作步骤：(TortoiseSVN版本: 1.8.8)

一：创建仓库

1. 创建目录结构D:\TortoiseSVN\Repository\Repo-iOS

2. 在该目录结构上右键

---> TortoiseSVN

---> Create repository here(创建仓库这里) 
---> Create folder structure(创建文件结构) ---> Start Repobrowser(开始仓库浏览) ---> Ok
       

二：将项目上传到SVN上

       桌面右键

       ---> TortoiseSVN

       --->repo-browser--> URL:  file:///D:/TortoiseSVN/Repository/Repo-iOS ---> Ok

       --> 选中trunk文件夹右键

       ---> Add folder... 

       ---> 选中要上传到SVN的项目的最外层目录，输入日志

       ---> Ok
       

三：Check Out 

1. 在电脑任意位置创建一个存放项目代码的目录，例如：D:\TortoiseSVN\Repository\Source
2. 将代码检出到该位置
   

四：开发周期

       1. 在目录D:\TortoiseSVN\Repository\Source\trunk\MyAppProject上进行开发，注意是在trunk主线上

因为项目刚建立，这是在开发新功能，所以要在主线上开发

       2. 开发一段时间后，经测试，上线到App Store，Android上传到其它应用商城，摘取上线时的HomeViewController文件中一段代码如下

[objc] view plain copy

 

1. - (void) viewDidLoad {  
2.    [super viewDidLoad];  
3.    // -----------------------------------------  
4.     int y = 0;  
5.     int result = 10 / y;     
6.     NSLog(@"iOS APP 第一阶段开发完成了！ 结果是：%ld", result);  
7.    // End  
8. }  

       3. 在D:\TortoiseSVN\Repository\Source\tags 目录下新建一个目录：1.0,并将该目录提交到SVN上，然后右键         D:\TortoiseSVN\Repository\Source\trunk\MyAppProject该目录---> TortoiseSVN---->Branch/tag... -----> To Path :/tags/1.0/MyAppProject 并选中 Head revision in repository ---> Ok此时Source/tags/1.0 目录中没有任何内容，需要更新一下该目录做update操作。更新之后看到一个完整的项目源码保存到该目录中（该目录下的源码可看做是trunk目录下版本为1.0的一个副本），查看一下/tags/1.0/HomeViewController中的viewDidLoad和trunk/MyAppProject/HomeViewController中的viewDidLoad代码完全一样。

       4. 开发下一阶段的新需求，开发中ing

       5. 用户或测试人员反馈应用有重大bug，需要立即修复该bug并尽快上线， 此时程序员需要为 tags/1.0下的MyAppProject 打一个分支branch，
          操作过程如下：选中Source/tags/1.0/MyAppProject 右键 TortoiseSVN---->Branch/tag... -----> To Path ：/branches/MyAppProject  ---> Ok
 此时看D:\TortoiseSVN\Repository\Source\branches目录下仍然没有任何内容，也需要update一下，更新之后发现该目录下
 也出现一个完整的项目代码（该代码可看做是tags/1.0/MyAppProject的一个副本），注意打分支和打标记都是使用Branch/tag...菜单，不同的是To Path 的目录不一样，图解看打分支的图，只是to path 值不一样，此时branches/MyAppProject/HomeViewController中的viewDidLoad和tags/1.0/MyAppProject/HomeViewController中的viewDidLoad代码完全一致。

       6. 切换工作空间，使用Xcode|Eclipse集成工具打开/branches/MyAppProject下的项目，然后在此基础上调试并修复bug，注意打开的必须是分支中的项目

       7. bug 修复好后，先提交修改的文件，并进行客户端App上线，上线完成后再将branches/MyAppProject/打个tag到1.0.1目录下（tags/1.0.1）（操作步骤同步骤3），tag操作完成后，可以看到tags/1.0.1/HomeViewController.viewDidLoad 和  branches/MyAppProject/HomeViewController.viewDidLoad是完全一致的，将branches/MyAppProject打一个新的tag是以便于下次在此基础上再次修复bug，至此bug修复已经完成；修复bug后的代码如下：

[objc] view plain copy

 

1. - (void) viewDidLoad {  
2.    [super viewDidLoad];  
3.    // -----------------------------------------  
4.     int y = 10;  
5.     int result = 10 / y;  
6.     NSLog(@"iOS APP 第一阶段开发完成了！ 结果是：%ld", result);  
7.    // End  
8.   
9.    NSLog(@"1.0 版本闪退bug 已修复, 程序出现除0异常");  
10. }  

       8. 接下来将branch和trunk进行合并，操作步骤如下：

         右键 branches/MyAppProject ------>TortoiseSVN

         ----> Merge... 

         ---> Merge a range of revisions 

         ----> Next --->URL to merge from : file:///D:/TortoiseSVN/Repository/Repo-iOS/trunk/MyAppProject 

         ----> Next

         ----> Merge
       

9. 将trunk和branches进行合并 步骤如下，

  右键/turnk/MyAppProject ----> Merge... -----> Merge a range of revisions   -----> Next 

----->  URL to merge from : file:///D:/TortoiseSVN/Repository/Repo-iOS/branches/MyAppProject

  步骤同上，只是  URL to merge from   的路径不一样。合并完成后，查看一下/trunk/MyAppProject/HomeViewController/viewDidLoad方法如下：

[objc] view plain copy

 

1. - (void) viewDidLoad {  
2.    [super viewDidLoad];  
3.    // -----------------------------------------  
4.     int y = <strong>10</strong>;            // <strong>可以看到branches分支中的代码已经合并到主线上了</strong>  
5.     int result = 10 / y;  
6.     NSLog(@"iOS APP 第一阶段开发完成了！ 结果是：%ld", result);  
7.    // End  
8.   
9.    NSLog(@"<strong>1.0 版本闪退bug 已修复, 程序出现除0异常</strong>");  
10.   
11.    NSLog(@"其他同事在主线trunk中进行新需求开发...");  
12.    NSLog(@"其他同事在主线trunk中进行新需求开发...");  
13. }  

10. 此时合并彻底结束，branches目录下的源码如果不想要也可以删掉，接着修改bug的这位程序员需要切换工作空间到主线上来，使用Xcode重新打开trunk/MyAppProject项目，接着开发尚未完成的新功能。SVN目录如下：

         

说明：

1. 分支开发和主干开发是两个完全独立的过程，两者可以同时进行开发
2. 因分支和主干开发是并行的，所以两者可以任意的多次提交当前工程所修改的文件