2022年软件版本管理规范V.docx
精选学习资料 - - - - - - - - - 标题软件版本治理规范编 号F-03-007 页1/ 9次制订部门研发部版 次A001制订日期2022-12-02 软件版本治理规范制订:刘志敏审核: _ 批准: _ 文 件 修 订 记 录文件名工程设计变更治理程序编号F-02-002称版次修订内容修改页次修订日期修订者备注A00 新版本发行2007-10-7 刘志敏A01 流程优化后进行相应修订2022-12-02 姚旋1 名师归纳总结 - - - - - - -第 1 页,共 9 页精选学习资料 - - - - - - - - - 标题软件版本治理规范编 号F-03-007 页2/ 9次名师归纳总结 制订部门研发部版 次A001制订日期2022-12-02 第 2 页,共 9 页目录1.目的 .32.适用范畴.33.权责 .33.1.版本治理员.33.2.软件系统架构师.43.3.软件工程师.43.4.软件主管.53.5.软件测试工程师.54.作业流程.54.1.流程及发布.54.2.留意事项.64.3.软件归档掌握 .64.4.软件发布掌握 .74.4.1.发布内容 .74.4.2.发布评审(Review ) .74.4.3.软件产品正式版本发布流程如下 .85.相关文件.95.1.研发设计开发掌握程序 .95.2.项目方案.96.记录表单.96.1.软件概要设计评审检查表.96.2.软件具体设计评审检查表.96.3.软件集成测试报告评审检查表 .96.4.软件发布评审检查表 .96.5.SVN月度稽查检查表 .97.附件 .92 - - - - - - -精选学习资料 - - - - - - - - - 标题软件版本治理规范编 号F-03-007 页3/ 9次制订部门研发部版 次A001制订日期2022-12-02 1.目的1.1. 标 准化软件工作流程1.2. 软 件开发过程中代码安全1.3. 标 准化配置治理,规范开发文档输入输出1.4. 软 件版本掌握提高软件发布质量2.1.5. 对 配置治理进行跟进, 调查 , 改善 , 为订正预防供应方向适用范畴全部软件版本治理员、软件系统架构师、软件工程师、软件测试工程师、软件技术总监 / 副总监、软件主管3. 权责3.1. 版 本治理员1 负责版本服务器的日常保护2 版本服务器用户的添加,删除,修改拜访权限3 版本服务器数据库的建立4 版本服务器新项目模块库建立5 依据系统架构师对新建项目的模块划分 , 设置组成员版本服务器工作权限6 编译检查发布正式版本 , 确保代码是最新可用的7 项目完成对代码进行编译检查 , 清理全部项目文档并归档8 文档资料的定时备份 . 完成归档的项目资料按月备份 9 帮助解决版本服务器用户使用过程中所遇到的问题10 对 SVN服务器使用情形进行稽查提交3 SVN月度稽查报告检查表名师归纳总结 - - - - - - -第 3 页,共 9 页精选学习资料 - - - - - - - - - 标题软件版本治理规范编 号F-03-007 页4/ 9次制订部门研发部版 次A001制订日期2022-12-02 3.2. 软 件系统架构师1 对软件项目进行模块划分2 协同版本治理员在版本服务器上进行目录设置 , 保证代码安全3 检查组成员的上传代码 , 保证代码的质量4 按项目方案时间点 , 准时提交软件项目文件5 对单元测试中发觉的问题准时进行处理 . 并在服务器做好备份工作6 发布集成测试软件版本和集成测试报告给测试组做集成测试验证7 对后期测试发觉的 bug 要准时跟进支配解决,对修改的代码准时上传服务器并添加修改说明8 正式版本发布,按标准更新版本号,确保全部正式发布版本唯独9 项目完成对全部代码和文档做检查,提交版本治理员;对模块的代码组织进行模块化评审 , 归档,并提交相应说明文档3.3. 软 件工程师1负责对软件功能模块的编码工作, 确认后方可进行工作, 否2工作前对本地工作目录的代码进行检查是否为最新版本就必需先进行本地工作目录的更新3工作完成后准时将本地机工作目录下的代码进行checkin,防止代码丢失造成的损失4每次涉及到版本机的checkin都必需附上版本说明 说明修改的内容, 新增功能 , 解决的 bug 等 5听从系统架构师配置治理工作支配,文件代码要准时归档(明确为什么修改,6保护工作涉及代码的修改必需上传版本服务器,并且附修改说明修改哪些地方,修改日期,修改人等信息)4 名师归纳总结 - - - - - - -第 4 页,共 9 页精选学习资料 - - - - - - - - - 标题软件版本治理规范编 号F-03-007 页5/ 9次制订部门研发部版 次A001制订日期2022-12-02 3.4. 软 件主管1 负责把关产品的软件设计,确保设计满意要求 , 参加新产品需求说明书评审2 参加软件概要设计、具体设计、编码工作、单元测试、集成测试,对各环节进行检查评审,确保工作质量3 审批本组成员输出资料,确保输出资料精确无误4 把关软件概要设计、具体设计检查评审,确保设计满意需求5 把关软件单元测试报告、集成测试报告检查评审,确保发布到测试组的软件质量6 规划参加项目的本组成员,估量项目进度要求的各里程碑7 帮助、指导本组项目成员参考研发服务器上项目方案模板制作软件开发方案进度表8 审核软件开发方案进度表,确保时间利用最大化9 督导本组成员将项目方案任务落实到月、周工作方案中10负责测试用例库建设,并监督测试流程,把关测试质量3.5. 软 件测试工程师4.1帮助系统架构师和软件工程师完成软件单元测试, 集成测TD服务器软件系统测试, 对于测试中发觉的bug 与对应软件工程师沟通并上2软件测试通过后组织系统架构师和相关人员召开发布评审会3作业流程4.1. 流 程及发布详见软件组工作流程5 名师归纳总结 - - - - - - -第 5 页,共 9 页精选学习资料 - - - - - - - - - 标题软件版本治理规范编 号F-03-007 页6/ 9次制订部门研发部版 次A001制订日期2022-12-02 4.2. 注 意事项a 下班前更新时 , 不要把没有编译胜利的程序文件迁入版本服务器b 添加修改版本服务器上的文件,必需添加注释说明c 本机除了开发工程目录外,仍需建一个中间工程目录,目录下面可以依据自己需要新增子目录,每次工作前,先更新中间工程目录,使它与版本服务器上的工程文件完全一样d 备份文件代码迁入版本服务器前,必需对文件进行编译检查e 标签和分支的命名必需遵照标准进行 产品完整型号 +版本 +分支名称 f 备份文件归档时 , 将代码中编译冗余文件清除 如 :.a;.o 等等 g 产品到发布版本给测试的阶段,要修改版本服务器代码必需有系统工程师或相关人员审核确保代码的精确h 项目全部源代码仅有治理员和架构师把握 , 确保代码安全i 全部代码必需从版本服务器上下载 , 禁止以其它任何形式传递猎取代码j 正式软件必需由版本治理员发布 , 加强对软件版本的掌握4.3. 软 件归档掌握1开发完成后进行软件版本归档,内容主要有:软件名称(中、英文),版本号,编译后的可执行文件,源代码和文档(需求分析文档,概要设计,具体设计,测试用例和 bug 报告等)2 系统架构师确定要发布的版本号,然后由版本治理员检查是否满意版本提交条件,最终由版本治理员确认后,将该版本存档3 软件版本升级变更时,由系统工程师依据软件工程师提交的源代码和文档在版本服务器进行更新检查并知会版本治理员,然后由版本治理员检查是否满意版本提交条件,最终由版本治理员确认后,再将该版本存档4 当发生用户需求变更时,系统架构师提交程序需求变更设计说明,并另行标明在源程序和文档中何处进行了更换,最终由软件主管审核通过后,将该版本存档6 名师归纳总结 - - - - - - -第 6 页,共 9 页精选学习资料 - - - - - - - - - 标题软件版本治理规范编 号F-03-007 页7/ 9次制订部门5研发部版 次A001制订日期2022-12-02 确定每个版本责任人,同一软件可以有不同时期的责任人6版本提交归档后,软件的任何修改需先向治理人员申请,由版本治理员提交该版本,开发人员不能自行使用开发时使用的源程序7软件提交同时需附上编译说明文档, 内容包括 : 编译环境 , 编译工具 , 编译步骤等4.4. 软 件发布掌握4.4.1. 发布内容4.4.1.1. 在软件发布中,会因发布的类型不同而产生不同的发布包;可能会有以下几种类型 : . 产品升级发布 : 指在早期版本的基础上提高产品的特点集,当然也包括更新内容. 产品更新发布 通常是修复老产品的缺陷 如收集肯定时间内的产品缺陷,汇总产生如 3.0.1 进行更新发布. 补丁发布:补丁(紧急修复)是用来修复产品缺陷或掩饰缺点的;补丁和更新之间的区分是紧急程度和实施的工作量4.4.1.2.发布包的主要构成如下,假如是补丁或产品更新发布,发布包简化为程序、说明性文档和源码4.4.2.程序.源码.发布说明文档,包括各种readme (测试组供应).用户(操作)手册(测试组供应).全套项目文档.配置说明文档.其它发布评审(Review )对于软件正式发布,测试工程师要组织各相关人员召开评审会由系统工程师支持审核和检查,以保证发布的产品满意用户的需求及公司的各类规范7 名师归纳总结 - - - - - - -第 7 页,共 9 页精选学习资料 - - - - - - - - - 标题软件版本治理规范编 号F-03-007 页8/ 9次制订部门4.4.3.研发部版 次A001制订日期2022-12-02 .软件发布评审.项目文档的检查.源代码和安装程序的检查软件产品正式版本发布流程如下4.4.3.1.发布预备发布之前,全部程序由测试工程师进行确认测试;检查BUG系统内登记的全部bug 都已经被解决,或者遗留的bug 不影响系统的使用,假如有严峻bug 未解决就不能发布;程序打包前做测试4.4.3.2.测试工程师组织软件发布评审,由软件系统工程师主持评审4.4.3.3.源码、文档入库编译构建脚本和全部源代码;文档包括需求说明、设计说明、方案,测试文档,操作手册、使用demo 等4.4.3.4.系统工程师进行程序打包标记源码、文档版本tag 4.4.3.5.编写发布说明readme.txt Read me的内容应当包括产品版本说明;本次发布包含的文件包、文档说明; 本次发布包含或者新增的功能特性说明;遗留问题及影响说明;版权声明以及其他需要说明的事项4.4.3.6.正式发布通知通知开发、测试、市场、销售各相关部门并附上发布说明和介绍4.4.3.7. 后续工作 软件发布后,在使用过程中可能仍会发觉一些 bug,由公司BUG治理系统跟踪;在不影响正常使用的情形下,这些 bug 将在下一版本发布时解决;假如 bug 严峻影响使用,必需依据流程重新发布4.4.3.8. 暂时发布 软件产品未正式发布前,可能需要一个暂时版本供软件工程师或者用户应急使用,这时候需要暂时发布一个版本;这个版本只包括基本的程序包和必要的使用说明;暂时发布需要通知相关开发、测试工程师;系统工程师需要为源码、文档打 tag 标记8 名师归纳总结 - - - - - - -第 8 页,共 9 页精选学习资料 - - - - - - - - - 标题软件版本治理规范编 号F-03-007 页9/ 9次制订部门研发部版 次A001制订日期2022-12-02 5.相关文件5.1. 研 发设计开发掌握程序5.2. 项 目方案6. 记录表单6.1. 软 件概要设计评审检查表6.2. 软 件具体设计评审检查表6.3. 软 件集成测试报告评审检查表6.4. 软 件发布评审检查表6.5. SVN月度稽查检查表7. 附件软件组工作流程9 名师归纳总结 - - - - - - -第 9 页,共 9 页