软件源码版本管理规范.docx

软件版本管理规范 第一章 目的 本规范详尽规定软件项目版本管理的对象、存储目录、分支、权限、维护等内容，使软件项目版本管理流程化并规范化， 保证在系统开发和实施过程中项目的完整性和一致性。 第二章 适用范围 所有系统开发及实施项目的软件项目都应进行版本管理。 项目中所有正式文档和代码都应纳入配置库 （可使用工具成立配置库， 本文所述使用的是SVN）进行版本管理。 第三章 职责 配置库管理员： 负责配置库的平时维护和管理； 监察开发及测试部门实时提交版本管理对象（即配置项）。 此岗位可由开发或测试人员兼任。 第四章 内容 4.1. 版本管理对象包括但不限于： 项目总体计划可行性研究报告开发计划 需求说明书需求设计原型设计说明书 系统开发变更申请单系统管理手册 用户操作手册培训计划 培训记录 源程序 支持系统运行的配置文件 精选文库 存储过程脚本 测试计划 测试用例 测试脚本 测试报告 上线计划 上线申请 版本维护日志 4.2. 配置库的目录构造 每个项目在配置库中应拥有唯一的项目名称。 配置库目录构造与项目内部的目录 构造建议按下列格式创建。 配置库目录构造规划： tags( 发布 ) ┃ ├ ┃ ├ ┃ ├ ┃ ├ ┃ └ trunk( 主版本 ) ┃ └projectA ┃ ├src ┃ ├MY_MOOC ┃ ├doc ┃ ├tool ┃ ├。。。 branches( 分支 ) ├SY_ABC TJ_ABC ├WH_MOOC -- 2 精选文库 其中，项目内部的目录构造： | –projectA | –src （保留该项目的源程序） | –doc （保留项目有关文档） | –000. 项目管理 （保留项目过程管理有关文档） | –010. 项目计划 （保留项目计划有关文档） | –020. 项目需求 （保留项目需求有关文档） | –030. 系统设计 （保留项目设计有关文档） | –030. 系统测试 （保留项目代码测试有关文档） | –040. 系统实施 （保留项目部署实施有关文档） | –050. 系统运维 （保留项目运维文档，包括培训、用户手册等） | –060. 技术资料 （保留项目技术文档，包括第三方技术资料等） | –。。。 （保留项目过程管理有关文档） | –tool （包括该项目特定的开发、编译、测试等工具） 4.3. 分支 (branch) 建议使用分支来共同不同职能小组对同一个配置库的使用， 可按照以下方式进行分支的管理。 解决方案成立三个分支，包括主版本开发 (trunk) 、分支版本开发 (branches) 和发布 (tags) 。 主版本开发 是所有分支版本的基准版本，主版本的开发分支。开发部门开发使用。 分版本开发 主版本的分支版本， 供开发部门开发使用。 开发工程师如果以主版本为基准， 进行软件项目开发，要先将 trunk 目录下的代码分支到 branches 目录的一个子目 录，在那里对代码进行开发。多个主版本的分版本可通过在 branches 顶级目录创建多个分支目录来区分。 发布 测试和发布专用分支， 该分支代码不允许任何形式的改正。 每个经过测试后的不同版本的代码做快照放到此分支文件夹下。 -- 3 精选文库 4.4. 权限管理 应付配置库的接见权限进行管理， 保证软件系统的完整性和安全性。 建议按如下 方式进行管理。 开发工程师 仅拥有自己所属项目的 add file 、delete file 、 check out 、check in 权限， 无目录创建和删除权限。开发工程师若想创建目录，需向配置库管理员申请。 测试工程师 拥有每个项目的测试分支的 add file 、delete file 、check out 、 check in 权 限，无目录创建和删除权限，关于其他分支只有只读权限。 配置库管理员 拥有全部权限，但增删项目和增删目录需要有项目负责人批准。 其他人员 若需要配置库接见权限， 需经技术总监或经技术总监授权的项目经理批准， 由配 置库管理员分派权限。 4.5. 版本管理 应付软件系统的版本进行管理， 保证版本的正确性和可追忆性。 建议按如下方式 进行管理。 版本维护 软件工程各阶段产生的各样文档和代码， 应实时并统一上载到配置库由配置库管 理员统一管理。关于要改正的配置项，应从配置库中检出（ check out ）后改正， 改正完成后实时检入（ check in ），并填写改正的原因和内容。配置项的历史版 本应保留在配置库中。 分支迁移 从开发分支到测试分支的迁移，由开发工程师操作。迁移的时机有： 当开发负责人提交测试申请时； 开发过程中进行测试，改正好一个或多个 bug，需要测试工程师考证时。从测试分支到发布分支的