软件源代码版本管理与发布.doc

修订记录 日期 版次 描述 作者 审核 批准 2010-9-9 1.0 初版发布 赵渊博 目 录 修订记录 2 1. 引言 4 1.1. 目的 4 1.2. 术语 4 1.3. 参考资料 5 2. 软件版本管理 5 2.1. 版本阶段说明 5 2.2. 版本命名规范 5 2.3. 版本号修改规则 5 2.4. SVN版本库分支与合并策略 6 2.4.1. 版本库管理说明 6 2.4.2. 版本库操作说明 6 2.4.3. 各种源码变动时，版本库操作方案 7 2.4.4. 版本库发布模式 9 2.5. 版本号发布 13 2.5.1. 版本发布追踪表 13 引言 目的 该文档是配置管理计划的一部分，主要用于源代码版本管理与发布。也可用于项目配置管理与发布。该文档使项目组成员熟悉并按文档约定执行版本管理与发布。该文档列举在开发过程中会出现的开发情况，规范在开发过程中分支的类型，何时分支、何时合并。该文档根据实际项目操作实践处于不断完善中。 应该此方案最基本的前提是需要熟悉SVN客户端操作。 术语 名称 解释 备注 Svn Subversion的缩写，版本控制管理工具 Tsvn tortoiseSVN的缩写，版本控制管理工具的客户端 修订版本(revision) 每一次提交修改到版本库，就会使版本库进入一个新的状态，称之为修订版本。每一个修订版本都会被赋予一个唯一的，比前一个修订版本号大一的自然数。一个新建立的版本库的修订版号为0，其中除了空的根目录外，什么都没有。 版本库（Repository）存放修订版的数据库 本地工作拷贝（Local working copy）修订版在本地的副本 版本的检入（Check in）本地副本提交到服务器的版本库 检出（Check out）从服务器的版本库中取出修订版成为本地副本 标签（Tags）版本加一个名字，便于检出 分支（Branches）修订版打分支，以后可以平行修改，互不干扰 合并（Merging）分支的修订版合并为一个新的修订版 冲突（Conflict）并发版本控制时防止修订版混乱的错误机制 参考资料 《Version Control with Subversion》 《SMOP文档格式定义规范》 软件版本管理 版本阶段说明 * Alpha版: 此版本表示该软件在此阶段主要是以实现软件功能为主，通常只在软件开发者内部交流，一般而言，该版本软件的Bug较多，需要继续修改。 * Beta版: 该版本相对于α版已有了很大的改进，消除了严重的错误，但还是存在着一些缺陷，需要经过多次测试来进一步消除，此版本主要的修改对像是软件的UI。 * RC版: 该版本已经相当成熟了，基本上不存在导致错误的BUG，与即将发行的正式版相差无几。 * Release版: 该版本意味“最终版本”，在前面版本的一系列测试版之后，终归会有一个正式版本，是最终交付用户使用的一个版本。该版本有时也称为标准版。一般情况下， Release不会以单词形式出现在软件封面上，取而代之的是符号(R)。 版本命名规范 软件版本号由四部分组成，第一个1为主版本号，第二个1为子版本号，第三个1为阶段版本号，第四部分为日期版本号+希腊字母版本号+SVN最后修订版本号，希腊字母版本号共有5种，分别为：base、alpha、beta、RC、release。例如：1.1.1beta_334。 版本号修改规则 主版本号(1)：当功能模块有较大的变动，比如增加多个模块或者整体架构发生变化。此版本号由项目经理和技术主管决定是否修改。 * 子版本号(1)：当功能有一定的增加或变化，比如增加了对权限控制、增加自定义视图等功能。此版本号由项目经理和技术主管决定是否修改。 * 阶段版本号(1)：一般是 Bug 修复或是一些小的变动，要经常发布修订版，时间间隔不限，修复一个严重的bug即可发布一个修订版。此版本号由技术主管决定是否修改。 * 日期版本号 :用于记录修改项目的当前日期，每天对项目的修改都需要更改日期版本号。此版本号由开发人员决定是否修改。 * 希腊字母版本号+SVN最后修订版本号(beta_334):此版本号用于标注当前版本的软件处于哪个开发阶段，当软件进入到另一个阶段时需要修改此版本号。此版本号由项目决定是否修改。 SVN版本库分支与合并策略 版本库管理说明 源代码版本管理采用主干和分支的开发模式，建立分支必然会涉及到合并，如果要使用主干分支方案就必须接受合并可能带来的操作繁复。 源代码的变动主要有几种： 1、建立新项目 2、修改bug 3、根据新需求增加新功能 4、项目技术方案重大变革、