软件版本管理标准规范.doc

XXXX企业
技术文件
软件版本管理规范

XXXX企业
二○一八 年 一 月

目 录
第1章 引言 - 1 -
1.1 目标 - 1 -
1.2 适用范围 - 1 -
1.3 术语定义和缩写词 - 1 -
1.4 统一大小写 - 1 -
1.5 参考资料 - 1 -
第2章 版本规范 - 2 -
2.1 版本格式 - 2 -
2.2 版本升级规则 - 2 -
第3章 TAG 规范 - 3 -
3.1 TAG 转换规则 - 3 -
3.2 版本 TAG - 3 -
3.2.1 ALPHA测试 TAG - 3 -
3.2.2 BETA测试 TAG - 3 -
3.2.3 Release TAG - 3 -
3.2.4 产品基线 TAG - 4 -
第4章 BRANCH 规范 - 5 -
4.1 固定后缀 - 5 -
4.2 BRANCH 转换规则 - 5 -
4.3 项目 BRANCH - 5 -

第1章 引言
1.1 目标
经过该文档来统一、规范企业全部软件产品版本管理，使得版本管理愈加正式和有效。
本文档自1月1日开始实施。
1.2 适用范围
本规范中要求相关内容适应于企业全部软件产品版本管理。
1.3 术语定义和缩写词
版本号：产品/模块版本标识
TAG：SVN 中标识版本集合工具和术语
BRANCH：即分支，SVN 中支持并行开发工具和术语
1.4 统一大小写
版本管理中全部固定字串统一为大写
版本管理中全部提到产品/模块名称统一为小写
1.5 参考资料
CMMI 规范之--SCM软件版本管理规范

第2章 版本规范
2.1 版本格式
版本号包含：产品/模块简称、主版本号、副版本号、子版本号、build 号
格式：<产品/模块简称> <主版本号> . < 副版本号>.<子版本号>.<build 号>
2.2 版本升级规则
Ø 主版本号升级规则
² 新产品或模块立项，主版本号为0；
² 主体构件进行重大修改，主版本号加1；
² 主版本号变更时，副版本号同时置 0。
Ø 副版本号升级（关键针对新功效）
² 新产品或模块，副版本号为 1；
² 主体构件重大修改，副版本号加 1；
² 主体构件之间接口协议重大修改，副版本号加 1；
² 和其它产品或模块之间接口协议重大修改，副版本号加 1；
² 重大功效增加或增强，副版本号加 1；
² 当副版本号变更时，子版本号同时置 0。
Ø 子版本号升级（关键针对修改bug）
² 新产品或模块立项，子版本号为 0；
² 为增强现有功效模块，不增加新功效模块，主体构件未做重大修改，而且主体构件之间接口协议也未做重大修改，子版本号加1；
² 为修改 bug，而产品主体构件未做重大修改，而且产品主体构件之间接口协议也未做重大修改，子版本号加1。
Ø build 号升级
² build 号部分为生成版本日期；
² 每次送测必需有 build 号，上线等也必需有build 号；
² 例：050331

第3章 TAG 规范
3.1 TAG 转换规则
从版本号和项目编号转换成 TAG 对应部分遵照以下标准：
a、字母和数字不变
b、空格“ ”转换成下划线“_”
c、小数点“.”转换成减号“-”
3.2 版本 TAG
3.2.1 ALPHA测试 TAG
Alpha版：内测版。专业测试人员测试用，通常而言，该版本软件Bug较多，需要继续修改。
格式：<产品/模块简称>_<主版本号>-<副版本号>-<子版本号>-<build 号>_ ALPHA
格式（例）：dhtx_0-1-0-150331_ALPHA
3.2.2 BETA测试 TAG
Beta版：公测版。该版本相对于Alpha版已经有了很大改善，消除了严重错误，但还是存在着部分缺点，需要经过数次测试来深入消除，此版本关键对像是产品用户。
格式：<产品/模块简称>_<主版本号>-<副版本号>-<子版本号>-<build 号>_ BETA
格式（例）：dhtx_1-1-21-150331_BETA
3.2.3 Release TAG
Release版：该版本意味“最终版本”，在前面版本一系列测试版以后，终究会有一个正式版本，是最终交付用户使用一个版本。该版本有时也称为标准版。通常情况下，Release不会以单词形式出现在软件封面上，取而代之是符号(R)
格式：<产品/模块简称>_<主版本号>-<副版本号>-<子版本号>-<build 号>_ R
格式（例）：dhtx_1-1-21-150331_R
3.2.4 产品基线 TAG
定义产品基线 后缀是：_PD_BL
格式：<产品/模块简称>_<主版本号>-<副版本号>-<子版本号>-<build 号>_PD_BL
格式（例）：dhtx_1-1-21-050331_PD_BL
第4章 BRANCH 规范
4.1 固定后缀
BRANCH名称固定后缀为：_BRANCH
4.2 BRANCH 转换规则
BRANCH转换规则同TAG 转换规则
4.3 项目 BRANCH
项目分支用来支持并行项目标开发工作，同一项目使用相同项目分支
格式：<项目编号转换结果>_BRANCH
第5章 代码存放及公布规范
5.1 代码存放规则
1. 软件开发在svn对应项目标trunk目录中进行。
2. 需要公布测试版本在svn对应项目标tag目录中进行标识，命名规则参见第三章。
5.2 公布规则
1. 软件公布由项目经理进行操作。
2. 项目经理在tag目录中对待测试版本进行标识。注意，不要修改tag目录中代码。
3. 用标识版本打包生成测试包，上传到测试FTP服务器。