软件版本管理规范

XXXXXXXX 公司公司 技术文件技术文件 软件版本管理规范 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 目的目的 通过该文档来统一 规范公司的所有软件产品的版本管理 使得版本管理更加 正式和有效 本文档自2018年1月1日开始执行 1 2 适用范围适用范围 本规范中规定的相关内容适应于公司所有软件产品的版本管理 1 3 术语定义和缩写词术语定义和缩写词 版本号 产品 模块的版本标识 TAG SVN 中标识版本集合的工具和术语 BRANCH 即分支 SVN 中支持并行开发的工具和术语 1 4 统一大小写统一大小写 版本管理中所有固定字串统一为大写 版本管理中所有提到的产品 模块名称统一为小写 1 5 参考资料参考资料 CMMI 规范之 SCM软件版本管理规范 第第 2 章章 版本规范版本规范 2 1 版本格式版本格式 版本号包括 产品产品 模块简称 主版本号 副版本号 子版本号 模块简称 主版本号 副版本号 子版本号 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 ALPHAALPHA测试测试 TAGTAG Alpha版 内测版 专业测试人员测试用 一般而言 该版本软件的Bug较多 需要继续修改 格式 ALPHAALPHA 格式 例 dhtx 0 1 0 150331dhtx 0 1 0 150331 ALPHAALPHA 3 2 2 BETABETA测试测试 TAGTAG Beta版 公测版 该版本相对于Alpha版已有了很大的改进 消除了严重的错 误 但还是存在着一些缺陷 需要经过多次测试来进一步消除 此版本主要对像是 产品用户 格式 BETABETA 格式 例 dhtx 1 1 21 150331dhtx 1 1 21 150331 BETABETA 3 2 3 ReleaseRelease TAGTAG Release版 该版本意味 最终版本 在前面版本的一系列测试版之后 终归 会有一个正式版本 是最终交付用户使用的一个版本 该版本有时也称为标准版 一般情况下 Release不会以单词形式出现在软件封面上 取而代之的是符号 R 格式 R R 格式 例 dhtx 1 1 21 150331dhtx 1 1 21 150331 R R 3 2 4 产品基线产品基线 TAGTAG 定义产品基线 后缀是 PD BL 格式 PD BL 格式 例 dhtx 1 1 21 050331dhtx 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 目录中进行标记 命名