终端软件版本管理规范

文件编码AQ2I-01-S003 版本V01
文件层级□一阶□二阶
■三阶
文件类别
■体系文件
□技术文件
编制部门T终端部机密等级■内文□秘密□机密□绝密
编制人熊红旺文件类别■通用□项目
审核何天翼编制日期2017.6.15 审批何天翼生效日期2017.6.20 总页数7 分发编号01
文件发布盖章
终端软件版本管理规范
文件制/修订记录
页码章节制/修订记录
版本
修订人修订日期备注修订前修订后
全部首次制定无V01 熊红旺2017.6.20
目录
1.概述 (4)
2.软件版本的分类 (4)
3.软件版本的使用流程和规则 (4)
3.1测试部测试版本、预封版版本、封版版本使用流程和规则 (5)
3.2生产线软件版本使用规则 (6)
4.软件版本的发布流程和规则 (6)
5.软件版本标识规则 (6)
5.1软件版本号命名规则 (6)
5.1.1关于软件版本唯一标识的说明 (7)
5.1.2测试部测试版本的软件版本号 (7)
5.1.3预封版版本的软件版本号 (7)
5.1.4封版版本的软件版本号 (8)
5.1.5回归验证版本的软件版本号 (8)
5.1.6特殊版本的软件版本号 (8)
5.2版本文件夹命名规则 (8)
5.2.1正式发布版本文件夹命名规则 (8)
5.2.2回归测试版文件夹命名规则 (8)
5.3版本发布邮件通知的内容和格式 (9)
5.3.1正式发布版本邮件通知的内容和格式 (9)
5.3.2回归测试版本邮件通知的内容和格式 (9)
5.4版本说明的内容和格式 (10)
5.4.1正式发布版本说明的内容和格式 (10)
5.4.2回归测试版本说明的内容和格式 (10)
概述
为了让项目版本管理更规范，能够正确的标识和使用软件版本，T终端部特制订此规范，目的是统一软件版本的发布和管理，保障测试和生产时版本正确和一致，减少不必要的问题发生。

软件版本的分类
根据产品所处的研发阶段和软件版本的用途，软件版本分为：测试部测试版本、预封版版本、封版版本、回归验证版本、特殊版本。

正常版本发布不带调试信息的release版本。

软件版本分类用途标识方法备注
测试部测试版用于公司内部测试见下节不发送到外公司，只发布debug版本
预封版版本以封版为目标，当相
应版本的全部缺陷为
可接受缺陷时，其
release版本转为封版
版本见下节当公司产品在内部测试功能完整、无严重问题
后，项目部组织制订“预封版版本”发布计划，
此类版本发布和release两种版本，建议测试部
使用release版本进行测试，当发现重大问题
时，可使用debug版本验证
封版版本用于生产(批量销售
后，可用于已销售的
车机升级) 同预封版版
本，但只有
release版本
此为“预封版版本”中的缺陷可接受版本的
release版本
回归验证版本用于验证特定软硬件
缺陷是否已经解决，
不对公司以外发布！见下节一般只发布基于“测试部测试版本”、“预封版
本”(含“封版版本”)回归测试，测试先安装
基准版本，再升级补丁包，特殊情况下可以发
布完整版本。

此类版本只验证特定的缺陷是否
解决，不测试其它问题。

如果发现其它问题，
请到当前测试的版本中测试是否存在，相应的
Bug报到那个软件版本中，当当前测试版本已
经提交了测试报告，则等到下个版本发布时再
验证。

特殊版本用于解决特定的问题见下节用于演示，特殊定制版本，基于某个svn修订
号制作，可能专门修改部分程序，在版本说明
中注明即可，相应的版本应用软件部不维护，
一般只发布debug版本，不属于版本维护范畴，
不提bug。

软件版本的使用流程和规则
配置组除了软件部内部测试版本外，其他版本都将发布给测试部，配置组不对除了测试部以外的部门发送软件版本，以免造成版本不一致，相关人员需要使用软件版本时应该向负责此项目
的项目经理确认使用哪个软件版本；
当需要向生产或客户发送版本时，按以下要求及规则发送，同时保证发送的版本号是正确的；
测试部测试版本、预封版版本、封版版本使用流程和规则
是
否
是
否
）
e s a e l e r （本版版封证
验归回证
验归回过
通否是试测）
g u b e d （本版试测部试测）
e s a e l e r /g u b e d （本版版封预过
通否是试测告
报试测告
报试测过
通过
通过
通未过
通未本
版e s a e l e r 的受接可陷缺的中”本版版封预“划
计布发”本版版封预“订制织组部目项，后题问重严无、整完能功试测当
1、“测试部测试版本”默认发布release 版本，此版本发布需要在测试部发出测试报告后制定
下个版本发布计划
2、“预封版版本“发布release 版本，当公司产品在内部测试功能完整、无严重问题，同时测
试部发出测试报告后，项目部组织制订“预封版版本”发布计划。

3、“封版版本”预封版版本中的缺陷可接受的release 版本，由测试部报告后，产品研发经理
告之配置可转封版版本。

4、“回归验证版本”属于内部测试版本范畴，是由研发人员发起，验证特定问题的内部测试
包，不属于版本发布计划管理范畴，不能作为生产使用软件；测试需要根据版本说明先
安装基准版本，再安装回归测试，此版本不对公司以外发布。

注意：此版本只验证特定
的缺陷是否解决，不测试其它问题。

如果发现其它问题，需要到当前测试的版本中测试
是否存在，相应的Bug报到那个软件版本中，当当前测试版本已经提交了测试报告，则
等到下个版本发布时再验证。

5、如果特殊情况下需要将以上版本发给外部或客户，请找各部门领导签字确认，相关责任由
签字人承担。

生产线软件版本使用规则
1、当确定生产线使用版本后项目经理通知配置组，同时附带《测试报告》会签扫描件。

2、配置组将根据版本信息整理生产线需要的相关配置项并存放到生产专用包。

3、相关部门到指定路径取走生产专用包，发送生产线。

4、当要对已发布生产的版本做变更时必须走变更流程。

软件版本的发布流程和规则
参见《T终端部软件版本发布流程》
软件版本标识规则
软件版本号命名规则
软件版本号定义的范式：
软件版本号=主版本号+“.”+子版本号+“.”+修订号
+[“.”+版本标志]+[“.P”+补丁号]
主版本号=从“1”开始的十进制数
子版本号=从“0”开始的十进制数
修订号=从“0”开始的十进制数
版本标志=[“I”][“T”][ “D”]+[“.”+特殊说明]
特殊说明=“对于某版本的特殊标志，用于进一步标识版本”
补丁号=从“1”开始的十进制数
主版本号用于表示终端软件的架构，目前定义为“1”；主版本号改变，则子版本号、和修订号重置。

子版本号用于表示正式对外发布的版本。

修订号(注：不同于svn修订号)用于表示软件版本发布的基线，即：软件版本发向测试部进行测试(含回归测试)，得出测试报告，标志相应软件版本验证完成，项目经理根据产品的进展情况，组织确认何种缺陷需要修改，并制订新的软件版本发布计划，软件部组织对软件缺陷进行修改，软件配置组按计划制作新的软件版本，新的软件版本的修订号增“1”。

版本标志中的“I”表示此版本是软件部内部测试版本，内部测试版本的主版本号，子版本号，修订号承接上次版本发布时的数值，即不改变。

版本标志中如果出现“T”，表示此版本是测试部测试版本。

版本标志中如果出现“D”，表示是debug版本，否则是release版本。

关于软件版本唯一标识的说明
由于软件版本号主要用于标识软件版本发布的基线，在同一发布基线下，应用软件部内部测试版本，特殊版本可能多次发布，因此，软件版本号有时不能唯一标识软件版本之间的差异(也即，不能唯一的找到对应的源代码)。

对于每一次软件版本发布，版本说明中有两个字段，结合起来可以唯一标识一个软件版本: 发布时间和svn修订号。

测试部测试版本的软件版本号
软件版本号=主版本号+“.”+子版本号+“.”+修订号
其中，每发布一个版本，修订号增加“1”。

预封版版本的软件版本号
软件版本号=主版本号+“.”+子版本号+“.”+修订号
其中，每发布一个版本，修订号增加“1”。

封版版本的软件版本号
封版版本是预封版版本中的版本，其中的缺陷是可接受的，可用于生产或给用户升级。

回归验证版本的软件版本号
软件版本号=测试部测试版本或预封版版本的软件版本号+ “.B”+回归验证号
回归验证版本一般是在相应的软件版本的基础上打补丁，而不发布完整软件版本。

升级前，升级程序最好验证基础版本是否正确；升级后，终端上的软件版本信息是回归验证版本的软件版本信息。

特殊版本的软件版本号
软件版本号=主版本号+“.”+子版本号+“.”+修订号+[“.”+版本标志]
特殊版本是应特别的要求制作的，因此软件版本号也需特别指定。

在没有特别指定的情况下，主版本号，子版本号，修订号采用相应svn修订号最近的数据表示，版本标志中做特殊标志。

版本文件夹命名规则
正式发布版本文件夹命名规则
时间_项目名称_对外发布版本号_内部识别版本号_特别说明（可选）;
例:2014-04-20_7A1_ 1.0.0_10000
说明：各部分之间用“_”标识；各部分之内如果要需要分开，用“-”标注,或是“.”
回归测试版文件夹命名规则
基于测试的版本文件夹名称_back；
当多个back时，在此文件夹下建back1、back2…目录;
例:2014-05-07_7A1_ 2.1.2_15740
文件夹下有：back1、back2…
说明：各部分之间用“_”标识；各部分之内如果要需要分开，用“-”标注,或是“.”
补丁号从1开始十进制计数。

版本发布邮件通知的内容和格式
正式发布版本邮件通知的内容和格式
版本发布对象：测试部
版本抄送对象：项目管理部、产品研发部、研发经理
主题：时间_项目_最新升级包发布例：2014-05-09_7A1_最新升级包发布
Hi all：
项目名称：例：7A1
终端版本号：例：1.0.0.
内部修订号：例：10000
存放路径：例：服务器存放位置
版本用途：例：仅北京内部使用
版本修改说明：
注意事项（可选）：
回归测试版本邮件通知的内容和格式
同上，主题：时间_项目_回归验证包
公司名称文件编码AQ2I-01-S003
文件名称T终端软件版本管理规范页次/总页码10 /10
版本说明的内容和格式
正式发布版本说明的内容和格式
参见《T终端部软件正式版本发布说明》
回归测试版本说明的内容和格式
参见《T终端部软件回归测试版本发布说明》
10。