2022年2022年软件版本管理制度文档

1、精选学习资料 - - - 欢迎下载软件版本治理规范系统软件开发部2021-9-20精品学习资料精选学习资料 - - - 欢迎下载目录1 引言31.1 目的31.2 范畴31.3 术语定义31.4 版序掌握记录41.5 版本更新记录42 版本治理42.1 流程图42.2 版本命名72.3 版本升级72.3.1 版本升级原就72.3.2 新版本的发布82.4 目录结构82.5 文档的存放92.5.1 文本文件的存放92.5.2 源代码的存放92.5.3 发行文档的存放92.6 权限掌握治理103 备份治理103.1 源文件备份103.2 库文件备份104 用户版本治理105版本工具的使用.115.

2、1配置治理工具.115.2cvs 的使用 .115.2.1常用命令 .115.2.2 简洁操作125.2.3 版本分支治理12精品学习资料精选学习资料 - - - 欢迎下载1 引言1.1 目的本文档为为规范xxxxxx有限公司软件版本治理而制定的；1.2 范畴本文档为系统软件开发部版本治理员供应有关版本治理规范的相关内容,包括：版本标识方法软件系统数据的存放文档的修改掌握文档的备份制度1.3 术语定义cvscvs为一个开源的版本掌握系统concurrent versions system的简称文档一种数据媒体和其上所记录的数据；配置治理标识和确定系统中配置项的过程, 在系统整个生存周期内掌握这

3、些项的投放和更动,记录并报告配置的状态和更动要求,验证配置项的完整性和正确性；软件配置软件的具体形状在某时刻的瞬时影像；配置项软件配置治理的对象称为配置项,如：系统规格说明书,项目开发方案,用户手册,源码；基线软件生存周期中各开发阶段末尾的标记,它的作用为把各阶段工作的划分更加明确化,使原来连续的工作在这些点上断开,使之便于检验和确定阶段成果；精品学习资料精选学习资料 - - - 欢迎下载1.4 版序掌握记录版序状态拟稿审核批准发布日期1.0系统软件开发部1.5 版本更新记录* a - 增加m - 修改d - 删除版本 /修订版修改页码修改记录修改人日期1.0初始版本2 版本治理2.1 流程图

4、2.1.1 文档归档流程文档编写人员评审人员配置治理员精品学习资料精选学习资料 - - - 欢迎下载编写文档修改文档格式规范化检查打评审版本精品学习资料精选学习资料 - - - 欢迎下载精品学习资料精选学习资料 - - - 欢迎下载不通过通过文档评审精品学习资料精选学习资料 - - - 欢迎下载确定版本（归档入库）2.1.2 文档变更流程精品学习资料精选学习资料 - - - 欢迎下载变更申请人评审人员文档编写人员配置治理员变更影响分通过精品学习资料精选学习资料 - - - 欢迎下载提交变更析及审批变更实施精品学习资料精选学习资料 - - - 欢迎下载精品学习资料精选学习资料 - - - 欢迎下

5、载取消变更不通过不通过精品学习资料精选学习资料 - - - 欢迎下载文档评审通过更新版本（归档入库）2.1.3 代码归档流程开发人员测试人员配置治理员源代码入库从 cvs 库提取源代码进行编译精品学习资料精选学习资料 - - - 欢迎下载从 cvs 库提取源代码修改源代码不通过系统测试通过制作安装程序打测试版本入库：安装程序源 代 码 测试报告评审报告更新版本精品学习资料精选学习资料 - - - 欢迎下载2.1.4 代码变更流程精品学习资料精选学习资料 - - - 欢迎下载变更申请人评审人员开发人员测试人员配置治理员变更影响分通过精品学习资料精选学习资料 - - - 欢迎下载提交变更取消变更析

6、及审批变更实施代码测试不通过不通过精品学习资料精选学习资料 - - - 欢迎下载测试报告评审通过更新版本（归档入库）2.1.5 配置治理流程开发人员项目治理人员测试人员配置治理员精品学习资料精选学习资料 - - - 欢迎下载完成开发任务提交测试任务测试方案.用例更新测试环境精品学习资料精选学习资料 - - - 欢迎下载测试执行精品学习资料精选学习资料 - - - 欢迎下载处理 bug回来测试精品学习资料精选学习资料 - - - 欢迎下载提交测试报告提交发布恳求确定版本信息制做安装程序新版本发布入库输出给市场部 发布文档更新流程说明：1.开发人员完成所负责模块的代码编写任务后,提交到项目经理处2

7、.项目经理向测试部门提交测试任务3.配置治理员预备测试所需的环境4.测试人员开展测试并实时提交bug5.开发人员处理测试过程中所显现的bug ,并提交给测试人员进行回来测试,直至bug 被关闭6.测试基本完成后,测试人员提交测试报告7.项目情形依据实际情形打算为否发布新的版本8.配置治理员与各相关人员经争论后确定好新版本各项信息9.配置治理员发布新版本精品学习资料精选学习资料 - - - 欢迎下载2.2 软件版本命名软件版本号由四部分组成,第一个1 为主版本号,其次个1 为子版本号,第三个1 为阶段版本号,第四部分为日期版本号加希腊字母版本号,希腊字母版本号共有5 种,分别为： alpha .

8、beta.rc.release；例如： 1.1.1.051021_beta；对于小项目或子系统而言,可简化为 <主版本号 >.<次版本号 >.<修订版本号 >,如 1.0.0；* 主版本号： 当功能模块有较大的变动, 比如增加多个模块或者整体架构发生变化；此版本号由项目打算为否修改；* 子版本号：当功能有肯定的增加或变化,比如增加了对权限掌握.增加自定义视图等功能；此版本号由项目打算为否修改；* 阶段版本号：一般为bug 修复或为一些小的变动,要常常发布修订版,时间间 隔不限,修复一个严峻的bug 即可发布一个修订版； 此版本号由项目经理打算为否修改；* 日

9、期版本号用于记录修改项目的当前日期,每天对项目的修改都需要更换日期版本号；此版本号由开发人员打算为否修改；* alpha 版: 此版本表示该软件在此阶段主要为以实现软件功能为主,通常只在软件开发者内部沟通,一般而言,该版本软件的bug 较多,需要连续修改；* beta 版: 该版本相对于 版已有了很大的改进,排除了严峻的错误,但仍为存在着一些缺陷,需要经过多次测试来进一步排除,此版本主要的修改对像为软件的ui ；* rc 版: 该版本已经相当成熟了, 基本上不存在导致错误的bug ,与即将发行的正式版相差无几；* release版: 该版本意味 “最终版本 ”,在前面版本的一系列测试版之后,终

10、归会有一个正式版本,为最终交付用户使用的一个版本；该版本有时也称为标准版；一般情形 下, release不会以单词形式显现在软件封面上,取而代之的为符号r；2.3 版本升级2.3.1 版本升级原就版本升级应严格纳入版本治理的掌握之下；应当谨慎地掌握版本的升级,保证高版本的向下兼容性,或供应严格定义的升级方法；在下面几种情形下,进行版本演化和升级：1.当产品发生重大修改和改进时,主版本号加1；重大修改和改进包括：1）平台迁移；2）开发工具的迁移；3）体系结构的变迁；2.当产品发生较小的改进或修改时,次版本号可以加1；3.对于改动量比较少的,如修改产品的错误,可升级修订版本号；4.记录版本升级过程

11、； 每次版本升级, 都要填写版本升级记录表, 记录表样例如下：精品学习资料精选学习资料 - - - 欢迎下载版本升级记录表主版本子系统名称子系统版本发布日期功能变更描述发布责任人批准人备注说明：版本号：记录当前发布的版本；发布日期：该版本批准发布的日期；修改文件：版本修改记录文件,一般为版本修改日志；2.3.2 新版本的发布新版本的发布包括主版本号和次版本号的升级,一般不包括内部版本号的升级；流程如下：1.依据项目进展情形,或者依据用户需要进行发布预备；2.将发布所需文件进行打包,放在指定目录中, 给目录加上标签 tag,标签中包含将要发布的版本信息；3.同样对源码文件也要加上与版本信息相关的

12、标签tag；标签 tag 命名规章如下：组成：模块首字母+下划线 +文件类型 +下划线 +主版本号 +次版本号 +内部版本号 +时间（ +下划线 +合并标记）样例： qzcj_src_1_0_0_110923,qzcj 表示采集模块的首字母, src 表示源码, 1_0_0表示将要发布的版本号, 合并标记可省略, 只在有合并操作时注明, 其中合并前的标记为 mbe, 合并后的标记为 maf；2.4 目录结构但为了能更好地治理各项目组的文档,建议可将被治理的配置项分为三大类：文档类.源码类及安装盘类, 这样存放比较清楚, 有利于版本治理, 现将目录结构整理如下：根目录一级目录二级目录对应配置项备

13、注精品学习资料精选学习资料 - - - 欢迎下载resp源码code前置采集源码后台运算源码业务应用源码数据库sql 文件业务支撑精品学习资料精选学习资料 - - - 欢迎下载文档doc公用开发包需求文档立项报告.需求分析.需求记录设计文档软件架构.总体设计.概要设计.具体设计.界面设计数据库文档数据字典.数据库搭建.备份仍原方案. pdm 设计测试文档测试方案.测试用例.测试报告用户文档用户手册.产品说明方案文档项目方案.年度月度方案外部接口文档标准规范精品学习资料精选学习资料 - - - 欢迎下载发布文件setupreleaserar 文件发布文档二级目录中的版本指一些特别的版本,不影响基

14、线版本；2.5 文档的存放2.5.1 文本文件的存放依据各项目部自己的情形,将系统用户需求记录.总体设计文档.具体设计及数据结构文件.测试记录.用户手册等放入cvs 仓库 doc 目录相应的子目录下；2.5.2 源代码的存放源代码包括如： java,jsp,bmp ,ico 等相关文件,为未经编译处理的.不能直接交付使用的产品文件以及编译产品所需的文件；联机帮忙文件hlp 在未生成 hlp 文件之前的 doc, rtf 等格式的文档也视为源代码；各子系统当前的程序源文件放入cvs 仓库 code 目录相应的 bb 目录下,对于一个子系统又分多个分子系统的情形,应在该目录下分别建立几个相应的子目

15、录；2.5.3 发行文档的存放发行文档为指产品交付用户使用所必需的文件；包括：产品可执行文件,用户使用说明书,联机帮忙（ hlp）；资源文件（ bmp ,ico 等）,环境配置文件等；以上文档作为制作发行盘的素材, 放在 cvs 仓库发布文件目录的release目录之下,精品学习资料精选学习资料 - - - 欢迎下载制作好的发行盘放在发布文件的setup 目录；2.6权限掌握治理为保证文档的安全性,一样性,以及防止意外修改,必需对不同的文档设置不同的拜访权限；文档权限类别：无任何权限,只读权限,全部权限；文档类别：设计文档,源码,发行文档；用户类别：开发人员.测试人员.项目经理.配置治理员等；

16、为了掌握不同的使用权限,依据要求在服务器上分别建立不同的用户,针对不同的配置项所在目录安排不同的权限；为了便于治理,应以表格的形式列出人员与治理对象的拜访关系（用户权限清单）,详见系统部 cvs 权限配置；3 备份治理为了保证文档的最大可复原性,要随时及定期地进行备份工作；3.1 源文件备份开发人员每天都要将自已当日修改的源文件提交（commit ）至 cvs 仓库；3.2 库文件备份为防止服务器显现反常, 需对服务器上的 cvs 仓库文件进行备份, 目前采纳的方案如下：工作日备份：每个工作日将原本位于d 盘的仓库文件在h 盘上备份一份,当d 盘仓库显现反常时,用户可把root 目录修改至 h

17、 盘备份的目录,再进行更新操作；每周备份：每周五下班时将h盘备份文件异地备份至其它ip （目前备份在192.168.53.68上）；每月备份：每个月底将最新版本备份至光盘；4 用户版本治理为了更好地治理源程序,应为每一用户建立一个用户版本文件,该文件应包含以下内容：用户编号：精品学习资料精选学习资料 - - - 欢迎下载用户名称：软件版本号： 开头使用时间：联系人：联系电话：用户程序更换日志样例如下：更换版本号修改模变更缘由变更概述软件位置变更备注时间块名称人员说明：1） 用户购买软件时要为该用户建立一个包含上述内容的一个用户版本文件,并填写有关数据；2） 用户进行版本更新时要求填写该文件的版

18、本变更记录,用以反映用户版本的变更情形；5 版本工具的使用5.1 配置治理工具开发部采纳 cvs进行配置治理, cvs为一个 c/s 系统,多个开发人员通过一个中心版本掌握系统来记录文件版本,从而达到保证文件同步的目的；目前采纳的 cvs服务端为 cvsnt-2.5.03.2260,客户端为 tortoisecvs-1.8.29；5.2 cvs的使用5.2.1 常用命令英文命令中文命令操作.说明备注checkout提取 /取出将文件下载到本地目录第一次下载目录用commit提交将改动过的文件提交到版本库每次对文件更新后使用update更新将文件同步到最新版本猎取最新版本tag标签给某个版本添加

19、一个标记符号便于合并分支与主线branch分支创建某个文件的分支建立特别版本时用到精品学习资料精选学习资料 - - - 欢迎下载merge合并将分支文件（或主文件）的更换合并到主文件（或分支文件）diff比较不同比较任意两个版本间的不同精品学习资料精选学习资料 - - - 欢迎下载reversion graph版本分支图查看文件各版本（包括分支文件）的走向图查询各个版本及tag精品学习资料精选学习资料 - - - 欢迎下载history历史查看文件各个版本更新历史查询版本具体信息5.2.2 简洁操作文件提取：初次使用需将源文件从仓库提取出来,执行checkout 命令将库文件提取至本地相应位置

20、；定时更新：开发人员每天早上对源代码或文件进行更新操作（右键执行update 操作）；实时更新：某一开发人员提交更换后,可通知其它人员进行更新操作；实时提交： 对某一文件进行更换完成后,执行 commit 命令将更换提交至仓库,更换前先进行更新操作,如多个人员对同一文件同时进行操作,会产生冲突,这时需要对冲突进行处理；冲突处理：提交产生冲突时,先对文件进行同步（即更新）操作,之后会产生一个合并文件, <号前为两个版本相同部分,号前为本地版本修改的内容, >前为当前服务器最新版本修改的内容,找到最近提交该文件的同事,进行协商后对源文件进行修改并提交；创建分支 /标签：右键菜单中挑选branch 或 tag找开创建对话框,输入branch 名 或 tag名,选中 create new branch / create new tag,点击 ok 即可；查看版本 /历史：文件（非文件夹）右健菜单中挑选revisiongraph.或 history. ,可查看该文件的版本更新记录或历史信息；5.2.3 版本分支治理我们把一个项目的主要开发过程称作开发基线；当某一个特别大事发生的时候,例如,有一个用户有特别的需求,于为就从这个开发基线里分别出来一个叉,以满意用户特别的需求,这个叉有它自己的进展方向,这就为分支；-分支/-开发基线上面这个点,