版本控制规范耀邦软件规范
版本控制规范
版本 1.0
配置管理
文档类别: 耀邦软件规范
文档名称: 版本控制规范
文档标识: ybsw-scm-ver
版本: 1.0
修订号: 0
状态: 讨论稿
访问路径: ybsw_vob\tech
模板: ybsw-tmpl-word.dot v2.0
所有人: SEPG
创建...
耀邦软件
版本控制规范
版本 1.0
配置管理
文档类别: 耀邦软件规范
文档名称: 版本控制规范
文档标识: ybsw-scm-ver
版本: 1.0
修订号: 0
状态: 讨论稿
访问路径: ybsw_vob\tech
: ybsw-tmpl-word.dot v2.0
所有人: SEPG
创建人/创建时间: 2006-4-1
批准人/批准时间:
修订历史:
日期
版本
修订号
说明
作者
2006-4-1
1.0
0
第一次讨论稿
目录
1. 简介 4
1.1 目的 4
1.2 范围 4
2. 产品标识 4
2.1 内部标识 5
2.1.1 产品代码 5
2.2 外部标识 5
2.2.1 产品名称 5
2.2.2 版本号 6
3. 版本号设置规则 6
3.1.1 主版本号 6
3.1.2 副版本号 6
3.1.3 Release号 7
4. 源代码标识 7
5. 文档标识 8
6. 产品包标识 9
7. 产品光盘标识 9
版本控制规范
1. 简介
目的
软件的配置是指组成软件的各个可区分的部分。其中每个部分叫做一个“配置项”,一个配置项可以包含多个子配置项。例如,一个软件由若干子系统组成,则子系统是配置项;一个子系统由若干组件/模块组成,则组件/模块也是配置项;软件文档也是软件的配置项。
在软件的生产和维护阶段,需要经常对软件进行修改和测试。将软件分解成若干配置项,便于开发和测试人员精确地定位需修改和测试的对象,有利于软件的版本控制。
版本控制规范用于确定软件配置项的命名与版本号管理的规则,以确保清楚地、唯一地标识软件的各个组成部分及其状态,并建立这些部分之间的一致性关系。
范围
版本控制的范围包括:
✧ 源代码:用计算机编程语言编写的源代码文件
✧ 文档:需求规格说明书、总体
说明书、数据库设计说明书、详细设计说明书等描述软件功能和结构的技术文档;项目
等项目管理文档以及各种测试文档和用户文档
✧ 产品包:将源代码进行编译得到的可运行的软件系统
2. 产品标识
在每个软件产品立项时建立该软件产品的标识,以唯一地代表一个软件产品或项目,产品标识也称为项目标识。
产品标识分为内部标识和外部标识,其内容分别包括:
内部标识
产品代码
在产品立项时即为产品分配唯一的代码,代码形式为:
YBRD
xx为产品立项年份的末两位,yyy是为当年立项产品分配的流水号。如:YBRD01005,YBRD02002,分别代表2001年立项的第五个项目和2002年立项的第二个项目。
产品代码唯一标识地标识特定版本的产品。
产品的开发、测试、入库直至销售都将使用此唯一的代码。
当产品产生重大升级,重新立项时,应分配新的产品代码。
外部标识
产品名称
新产品立项时,为产品赋予产品名称;当已有产品升级时,则沿用前一版本产品的名称。
产品名称包括:
✧ 产品(中文)名称:如:统一客户资料系统,动态网络资源管理系统
✧ 产品英文名称:如:Unified Custom Information System,Dynamic Network Resource Management System
✧ 产品英文简称:如:UCI,DNRMS
产品名称用于相关文档、标签(Label)的制作和产品的发布。
产品名称不是某一产品的唯一标识,必须与版本号一起用才能标识特定产品。
版本号
版本号用来标识开发、测试、交付阶段的不同状态的产品,版本号为:
v<主版本号>.<副版本号>.[附属标记]
✧ 主版本号:立项时设置,在整个项目开发过程中不改变
✧ 副版本号:立项时设置,在整个项目开发过程中不改变
✧ Release号:又叫Build号,内部测试开始之前设置,初始值为0,此后每产生一次小的修改,Release号+1
✧ 附属标记:内部测试版为a,外部测试版为b,正式发布版为空
版本号的一般形式如:v1.0.7a,v1. 0.9b,v1. 0.12。
3. 版本号设置规则
主版本号
1、 设置时间:产品立项时设置
2、 负责人:产品经理
3、 设置规则:
✧ 新产品立项,主版本号为1
✧ 产品构架发生改变,主版本号+1
✧ 产品主体构件进行重大修改,主版本号+1
✧ 产品主体构件间接口协议发生更改,主版本号+1
副版本号
1、 设置时间:产品立项时设置
2、 负责人:产品经理
3、 设置规则:
✧ 新产品立项,副版本号为0
✧ 为处理产品Bug或改进现有功能/性能,对现有功能模块做大的修改,但不增加新的功能模块,副版本号+1
✧ 为增加产品功能,在原版本产品上增加新的功能模块,而产品的主体构件未做重大修改,并且产品的主体构件之间的接口协议也未做修改,副版本号+1
✧ 为适应不同用户需求,对产品进行更改,而产品的主体构件未做重大修改,并且产品的主体构件之间的接口协议也未做修改,副版本号+1
✧ 当主版本号变更时,副版本号同时置0
Release号
1、 设置时间:产品开发结束,内部测试开始之前
2、 负责人:项目经理
3、 设置规则:
✧ Release号初始值为0
✧ 测试过程中,每进行一次修改,Release号+1
✧ 正式发布后,为修改程序中的小Bug,每修改一次Release号+1
4. 源代码标识
总体设计完成时,依据《软件配置清单》,建立源码库,纳入配置管理系统。
由于源代码牵涉到大量的文件,为维护它们之间的一致性,对源代码使用标签(Label)进行管理,即对同一版本的所有源代码文件打上同样的标签。标签的命名规则如下:
1、 单元测试阶段
以软件单元(子系统/组件/模块)为单位建立标签,标签形式为:
<产品英文简称>_<软件单元英文简称>_v<主版本号>.<副版本号>.< Release号>a
<组件/模块英文简称>在《软件配置清单》中确定
初始Release号为0,此后每经过一次修改,Release号+1
例如:DNRMS_ZYZL_v1.0.3a,DNRMS_ZYZL_v1.0.5a
2、 系统测试(内部测试)阶段
以系统为单位建立标签,标签形式为:
<产品英文简称>_ v<主版本号>.<副版本号>.< Release号>a
初始Release号为0,此后每经过一次修改,Release号+1
例如:DNRMS_v1.0.0a,DNRMS_v1.0.7a
3、 验收测试(外部测试)阶段
以系统为单位建立标签,标签形式为:
<产品英文简称>_ v<主版本号>.<副版本号>.< Release号>b
初始Release号与内部测试结束点的Release号保持一致,此后每产生一次修改,Release号+1;若需重新进行内部测试,则附属标记降为a
例如:DNRMS_v1.0.7b,DNRMS_v1.0.9b
4、 正式发布阶段
以系统为单位建立标签,标签形式为:
<产品英文简称>_ v<主版本号><副版本号>
初始Release号与验收测试结束点的Release号保持一致,此后每产生一次修改,Release号+1;若需重新进行内部测试,则附属标记降为a
例如:DNRMS_v1.0.9,DNRMS_v1.0.12
5. 文档标识
项目开始时,依据《软件配置清单》建立文档库,纳入配置管理系统。
文档标识包括文档名称、文档ID和版本号。
1、 文档名称
具体的<文档名称>的列表参见《文档管理规范》
2、 文档ID
文档ID形如:
<产品英文简称>-<文档类别>-<文档代码>
例如:DNRMS-REQ-SRS,UCI-DSN-GDS
具体的<文档类别>与<文档代码>的列表参见《文档管理规范》
文档以ID作为文件名
3、 版本号
文档版本号形如:
v<主版本号>.<副版本号>.
例如:v1.0.3,v1.0.14
文档的主、副版本号与产品主、副版本号保持一致,Release号初始值为0,之后每修订一次文档,Release号+1
文档的标签与源代码的标签应保持一致:即当每次给源代码打标签的时候,应给源代码所依据的技术文档及其对应的测试文档和用户文档均打上同样的标签。
6. 产品包标识
产品包的内容包括由源代码编译得到的可执行程序及其安装程序、配置文件、发布声明等。
在内部测试完成时,依据《软件配置清单》建立发布库,纳入配置管理系统。
产品包分为完整版和升级版两种。完整版用来完整安装软件产品,升级版用来对旧版本进行升级。软件产品开发完成后,除了制作产品包的完整版外,应根据该产品以前版本的客户使用情况以及升级安装的需求,制作若干升级版。
注意:a、产品包的版本号与生成它的源代码的版本号保持一致
b、产品包的附属标记不为a(即在内部测试阶段不生成产品包)
c、产品包必须与生成它的源代码打上一样的标签,从而保证其与源码之间的一致性
a) 完整版标识
完整版标识形如:
<产品英文简称> v<主版本号>.<副版本号>. [b| ]
例如:DNRMS v1.0.12,UCI v2.0.3b
b) 升级版标识
升级版标识形如:
<产品英文简称> v<主版本号>.<副版本号>. [b| ] p<旧主版本号>.<旧副版本号>.<旧Release号> [b| ]
例如:DNRMS v1.0.13b p1.0.12,UCI v2.1.2 p2.0.3
7. 产品光盘标识
产品光盘的内容包括产品包、用户文档以及客户要求的技术文档、源代码等。
产品光盘的名称为:耀邦[<客户名称>]<产品名称><版本号>
对特定客户发布的版本加<客户名称>
<版本号>为光盘中所包含的软件包的版本号
例如:耀邦动态网络资源管理系统v1.0.4,耀邦中国联通统一客户资料系统v2.1.3b
文档已经阅读完毕,请返回上一页!
本文档为【版本控制规范】,请使用软件OFFICE或WPS软件打开。作品中的文字与图均可以修改和编辑,
图片更改请在作品中右键图片并更换,文字修改请直接点击文字进行修改,也可以新增和删除文档中的内容。
[版权声明] 本站所有资料为用户分享产生,若发现您的权利被侵害,请联系客服邮件isharekefu@iask.cn,我们尽快处理。
本作品所展示的图片、画像、字体、音乐的版权可能需版权方额外授权,请谨慎使用。
网站提供的党政主题相关内容(国旗、国徽、党徽..)目的在于配合国家政策宣传,仅限个人学习分享使用,禁止用于任何广告和商用目的。