版本号命名规范v1.0

更新时间:2023-08-12 19:24:01 阅读量: 初中教育 文档下载

说明:文章内容仅供预览,部分内容可能不全。下载后的文档,内容与下面显示的完全一致。下载之前请确认下面内容是否您想要的,是否完整无缺。

广州市易杰数码科技有限公司

版本号命名规范

本文件属广州市易杰数码科技有限公司所有,

未经书面许可,不得以任何形式复印或传播。

文件建立/修改记录

1

1.1

1.2

1.3 介绍(INTRODUCTION) .......................................................................................4 目的(PURPOSE) ....................................................................................................4 过程总体概述(PROCESS OVERVIEW)....................................................................4 职责分工 ..............................................................................................................4

1.3.1

1.3.2

1.3.3

1.3.4

1.4

1.5

1.6 项目经理 ................................................................................................4 项目组成员.............................................................................................4 QA ..........................................................................................................5 PMO .......................................................................................................5 文档编号命名规范................................................................................................5 代码包编号命名规范 ............................................................................................5 基线命名规范 .......................................................................................................6

1.6.1

1.6.2 项目里程碑说明 .....................................................................................6 基线命名规范 .........................................................................................6

1.7 分支命名规范 .......................................................................................................7

华为版本号说明 .................................................................................................................8

1 对"VXXX"的说明 ..........................................................................................................8

2. 对"RXXX"的说明 .........................................................................................................8

3. 对"LLL"的说明 ............................................................................................................9

4. 对"CXX"的说明............................................................................................................9

5. 对"BXXY"的说明 .........................................................................................................9

6. 对"SPXX"的说明 ..........................................................................................................9

1 介绍(Introduction)

1.1 目的(Purpose)

规范项目过程中的文档、代码、基线、分枝的命名规范,统一版本号的命名。

1.2 过程总体概述(Process Overview)

本规范介绍了内部版本号和外部版本号,外部版本号为对外发布的版本,参照客户提供的版本号,本规范重点介绍内部版本号的由来及规范,项目过程中的文档代码都需要上传到svn上,并在项目里程碑阶段进行基线,项目的成员通过命名能清晰的知道版本的内容和阶段,达到对版本的号的规范。

1.3 职责分工

1.3.1 项目经理

与客户确定外部版本号和版本号缩写(可参见sow)

明确外部版本号的缩写并作为内部项目名称使用(可参见sow)

划分每个版本的迭代层次

建库时依据制定的版本号申请建库

对项目过程中的版本号进行监控和执行

1.3.2 CMO

当单个配置项经过内部评审外部确认结束,可以作为后续活动开始的依据

时对当前的配置项基线化

识别哪些属于配置项,需要进行基线化即打标签

当到达里程碑结束时,检查当前的基线文件夹内的配置项是否齐全,当达

到里程碑的结束要求时,对基线文件夹打标签

1.3.3 项目组成员

每次打包时依据版本号命名规范进行命名

每次上传的文档、代码依据版本命名规范命名

维护项目过程中的版本号

1.3.4 QA

制定版本命名规范并进行维护

按照质量保证计划进行过程审计和产品审计

1.3.5 PMO

当项目命名规范发生较大偏差时进行纠正和改进

审批版本命名规范并进行正式下发

1.4 文档编号命名规范

文档编号一般由四个部分组成:

第一部分:公司名称。(必须出现)

第二部分:项目名称_终端名称,项目名称为外部版本号的缩写,《参见sow》。 第三部分:配置项的名称,如项目计划、度量表、会议纪要等。(必须出现)。 第四部分:由流水号XXY组成。

“XXY“中的前两位xx表示规划中的版本,最后一位y表示过程改错版本。

其中,xx从01开始,以1为单位连续递增,xx变化时,y复位到0开始。

Y从0开始,以1为单位连续递增

y的递增可能是由于人为的粗心、差错、不符合要求而进行的一次或者多次修改 例如: Easier_ ET_PC_项目计划_011

表示含义:ET项目pc端项目计划第一个正式版中修改了一次后的版本

1.5 代码包编号命名规范

代码包编号一般由四个部分组成:

第一部分:公司名称(必须出现)。

第二部分:项目名称_终端名称,项目名称为外部版本号的缩写,《参见sow》。

第三部分:迭代号+项目阶段(迭代号如果没有可以不写,迭代用字母G代替)项目阶段可以是CODE\ST\SDV\Releace。

第四部分:由流水号XXY组成。

“XXY“中的前两位xx表示规划中的版本,最后一位y表示过程改错版本。

其中,xx从01开始,以1为单位连续递增,xx变化时,y复位到0开始。

Y从0开始,以1为单位连续递增

y的递增可能是由于人为的粗心、差错、不符合要求而进行的一次或者多次修改

例如: Easier_ET_PC_G1ST1_010

表示的含义是: ET项目pc端在迭代一的第一轮ST结束后打了一个包

代码包2命名

Easier_ET_PC_ST_010代码包4命名Easier_ET_PC_release_010代码包9命名(非计划内打包)

Easier_ET_PC_GnST_011

注意:

1、 依照项目计划,在编码结束,自测结束,sdv测试结束、验收测试结束进行打包转测。

2、 其中自测结束是指开发人员的预测试结束也就是ST测试结束

3、 过程中由于人为的粗心、差错项目打错包、不符合要求转测失败属于非计划内的失

误,命名时不修改项目阶段,只修改流水号y,比如代码包9和代码包11

1.6 基线命名规范

1.6.1 项目里程碑说明

里程碑对项目来说是一个较为关键的点,通常它标志着一个阶段已经完成,另一个阶段即将开始。对项目完成的阶段进行总结,对识别的重大风险和问题进行管理,并提出解决方案,这些都是在里程碑点上进行的。当项目到达计划所安排的里程碑时,pm对该里程碑进行评审,检查里程碑所要求的计划完成情况、工作产品并分析收集的项目度量数据和进行项目基线等目前依据我们的软件开发特点分为需求阶段、编码阶段、ST阶段、迭代阶段、sdv阶段、验收阶段(需要与pm沟通项目的里程碑点,按照里程碑点进行基线)。

1.6.2 基线命名规范

基线由五部分组成:

第一部分为Baseline

第二部分为项目名称_终端名称,项目名称为外部版本号的缩写;

第三部分为配置项的名称,如项目计划、度量表、会议纪要等(如果对单个配置项基线化时,需要添加第三部分,否则可以省略);

第四部分为迭代+当前软件的阶段;

第五部分为基线建立的日期(可选);

Baseline _XX__XX_XX

打基线可以针对单个配置项进行基线,也可以针对里程碑点打基线。

1.6.2.1 单个配置项的基线命名

Baseline_ET_PC_项目计划_G1ST

表示的含义是:ET项目PC端迭代一ST阶段针对项目计划进行了基准化,标志着项目的进度以此计划为标准参照。

1.6.2.2 对里程碑点的基线命名

Baseline_ET_PC_G1ST

表示的含义是:ET项目PC端在迭代一针对ST阶段针进行了基准化,标志着ST阶段结束,可以进入下一个阶段。

里程碑2Baseline_ET_PC_Plan_20120504里程碑3Baseline_ET_PC_ST_20120504里程碑5Baseline_ET_PC_release_20120504

里程碑基线1:

Baseline_ET_PC_star_20120504里程碑4里程碑6Baseline_ET_PC_G1sdv_20120504Baseline_ET_PC_sdv_20120504

7里程碑9里程碑8Baseline_ET_PC_GNsdv_20120504

Baseline_ET_PC_GNst_20120504

注意:如果当前没有划分迭代可以省略G,日期是可选。

1.7 分支命名规范

分支名称由五部分组成:

第一部分为Branch。

第二部分为项目名称_终端名称,项目名称为外部版本号的缩写。

第三部分为内容。

第四部分为项目阶段。

第五部分为日期。

例如:Branch_XX_XX_XX_20120504

Branch_ET_PC_G1ST_20120504(可选)

表示的含义是:2012年5月4号对ET项目迭代一ST阶段的代码包打了一个分支。

华为版本号说明

外部版本号的完整的产品版本名称规则为:

商标+[子商标]+型号+中(英)文名称+VxxxRxxx[LLL]CxxBxxy[SPxx]

1)[ ]表示可选。

2)"V"、"R"、"C"、"B"、"SP"为分隔符;V后面三位数字;R后面三位数字;

LLL可选;C后面两位数字;B后面三位数字;SP后面两位数字,只在热补

丁时使用。

3) 商标、子商标、型号、中(英)文名称根据产品命名相关规范、指导及规

则制定。 说明

1 对"Vxxx"的说明

"Vxxx"(version)代表某一产品或其系列产品,根据市场定位或开发平台的不同,一个产品分为若干个V 级版本。每个V级版本根据市场竞争需要、技术、功能特性与成本因素等,有一个总体开发规划,按计划开发若干个R(Release)级版本。V 版本可以包含若干个Release版本。

如果满足下列任何一种情况,则必须产生新的Version 版本,即产品的大版本: 产品市场定位发生变化,引起产品特性的重大变化;

产品平台发生变化,与原有平台不能兼容。

V版本以三位数字表示,数字间不准许有任何其它字母、符号出现,从100开始,不同

平台或技术的同类产品尽量采用大数标示,即V后面第一位,如V100、V800。

2. 对"Rxxx"的说明

"Rxxx"(Release) 版本表示产品特性版本,可以包含若干个特性,形成一个具体的系列产品,一个Release 版本纳入什么特性,需要综合考虑市场竞争、技术与成本方面的因素,系列产品也可有自己的特性版本,系列产品可以在特性版本号上用特别的字母或数字表示。产品路标规划确定了该产品所有的大版本(Version),以及每个大版本(Version)包含的特性版本(Release)、系列产品的发布时间和所包含的特性。特性版本需要按照产品开发流程所规定的各个评审决策点进行评审。

如果满足下列情况,则必须产生新的Release 版本:

产品市场定位和产品平台没有发生变化,但是,衍生新的系列产品; 综合考虑市场竞争、技术与成本方面的因素,产品特性发生变化,有计划地向市场发布的版本。

R版本以三位数字表示,数字间不准许有任何其它字母、符号出现,从001开始,在同一个V下面以1为单位连续递增,例如:R001、R002。

3. 对"LLL"的说明

"LLL"为海外版本标识符,以三个字母表示,可选。对于国内版本,此项可以省略。具体的对应关系请见附表1( 海外版本标识符和相应的语言(国家)对照表);如果某个版本可以用于某一个地区,可以在附录中选择本地区的主要国家的标识符作为版本的海外标识。

4. 对"Cxx"的说明

"Cxx"(Customer)表示计划提供给客户的版本,以两位数字表示,数字间不准许有任何其它字母,从01开始,以1为单位连续递增。Cxx与某些Bxx对应,同一Bxx为Cxx版本时,Cxx不以Bxxy的y位及 SPxx而变化,即同一个Cxx可能对应一个Bxxy或同一Build的多个改错版本或热补丁版本。

5. 对"Bxxy"的说明

"Bxxy"(Build)表示开发与IBT过程中的Build版本。B后面的三位中的前两位xx表示规划的Build划,最后一位y表示每一个Build的过程改错版本。其中,

xx从01开始,以1为单位连续递增;RXX变化时,Bxxy版本复位到B010。

y从0开始,以1为单位连续递增。Bxx变化时,y复位到0开始。

6. 对"SPxx"的说明

SP是为了解决问题,对网上运行版本的热补丁版本,以两位数字表示,数字之间不允许有任何其它符号,如空格、"."、"-"等。从01开始,以1为单位连续递增。如果版本不是补丁,SPxx要省略。 例如:SP01、SP02。 SP为某一发布版本的补丁版本,只有对于已经发布的版本需要做补丁版本时才会有此项。做SP时,前面的所有版本序号不变。 举例说明:

A. V100R001B010

B. V100R001B011 表示V100R001的第1个Build的首个转测试版本,不发给客户。 表示V100R001的第1个Build的第1个转测试改错版本。

C. V100R001C01B023表示V100R001的第2个Build为第1个客户版本,一般用于试验局或ESS局。实际交付件为第2个Build的第3个改错版本。

D. V100R001C01B023SP01

E. V100R001B030 表示对V100R001C01B023的第一个热补丁版本。 表示V100R001的第3个Build的首个转测试版本,不发给客户。 F. V100R001C02B053 表示V100R001的第5个Build为第2个客户版本,可用于试验局、ESS局、或ESP局。实际交付件为第5个Build的第3个改错版本。

本文来源:https://www.bwwdw.com/article/sijj.html

Top