广州市易杰数码科技有限公司版本号命名规范本文件属广州市易杰数码科技有限公司所有,未经书面许可,不得以任何形式复印或传播。
文件建立/修改记录1介绍(INTRODUCTION) (4)1.1目的(P URPOS E) (4)1.2过程总体概述(P RO CESS O V ERV IEW) (4)1.3职责分工 (4)1.3.1项目经理 (4)1.3.2项目组成员 (4)1.3.3QA (5)1.3.4PMO (5)1.4文档编号命名规范 (5)1.5代码包编号命名规范 (5)1.6基线命名规范 (6)1.6.1项目里程碑说明 (6)1.6.2基线命名规范 (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.2CMO●当单个配置项经过内部评审外部确认结束,可以作为后续活动开始的依据时对当前的配置项基线化●识别哪些属于配置项,需要进行基线化即打标签●当到达里程碑结束时,检查当前的基线文件夹内的配置项是否齐全,当达到里程碑的结束要求时,对基线文件夹打标签1.3.3项目组成员●每次打包时依据版本号命名规范进行命名●每次上传的文档、代码依据版本命名规范命名●维护项目过程中的版本号1.3.4QA●制定版本命名规范并进行维护●按照质量保证计划进行过程审计和产品审计1.3.5PMO●当项目命名规范发生较大偏差时进行纠正和改进●审批版本命名规范并进行正式下发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\Releac e。
第四部分:由流水号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代码包1命名Easier_ET_PC_G1SDV_010代码包5命名Easier_ET_PC_G2SDV_010代码包7命名Easier_ET_PC_GnST_010代码包3命名Easier_ET_PC_SDV _010SDV1SDV2验收代码包8命名Easier_ET_PC_GnSDV1_010代码包10命名Easier_ET_PC_GnSDV2_010代码包12命名Easier_ET_PC_Gnrelease_010代码包11命名(非计划内打包)Easier_ET_PC_GnSDV1_011代码包9命名(非计划内打包)Easier_ET_PC_GnST_011代码包6命名Easier_ET_PC_GnCODE_010注意:1、 依照项目计划,在编码结束,自测结束,sdv 测试结束、验收测试结束进行打包转测。
2、 其中自测结束是指开发人员的预测试结束也就是ST 测试结束3、 过程中由于人为的粗心、差错项目打错包、不符合要求转测失败属于非计划内的失误,命名时不修改项目阶段,只修改流水号y,比如代码包9和代码包111.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 阶段结束,可以进入下一个阶段。
注意:如果当前没有划分迭代可以省略G,日期是可选。
里程碑2Baseline_ET_PC_Plan_20120504里程碑3Baseline_ET_PC_ST_20120504里程碑4Baseline_ET_PC_sdv_20120504里程碑5Baseline_ET_PC_release_20120504里程碑6Baseline_ET_PC_G1sdv_20120504里程碑7Baseline_ET_PC_G2sdv_20120504里程碑8Baseline_ET_PC_GNst_20120504里程碑9Baseline_ET_PC_GNsdv_20120504里程碑基线1:Baseline_ET_PC_star_201205041.7分支命名规范分支名称由五部分组成:第一部分为Branc h。
第二部分为项目名称_终端名称,项目名称为外部版本号的缩写。
第三部分为内容。
第四部分为项目阶段。
第五部分为日期。
例如:Branch_XX_XX_XX_20120504Branch_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版本。
如果满足下列任何一种情况,则必须产生新的V ersion 版本,即产品的大版本:产品市场定位发生变化,引起产品特性的重大变化;产品平台发生变化,与原有平台不能兼容。
V版本以三位数字表示,数字间不准许有任何其它字母、符号出现,从100开始,不同平台或技术的同类产品尽量采用大数标示,即V后面第一位,如V100、V800。
2. 对"Rxxx"的说明"Rxxx"(Release) 版本表示产品特性版本,可以包含若干个特性,形成一个具体的系列产品,一个Release 版本纳入什么特性,需要综合考虑市场竞争、技术与成本方面的因素,系列产品也可有自己的特性版本,系列产品可以在特性版本号上用特别的字母或数字表示。
产品路标规划确定了该产品所有的大版本(V ersion),以及每个大版本(V ersion)包含的特性版本(Release)、系列产品的发布时间和所包含的特性。
特性版本需要按照产品开发流程所规定的各个评审决策点进行评审。
如果满足下列情况,则必须产生新的Release 版本:Ÿ产品市场定位和产品平台没有发生变化,但是,衍生新的系列产品;Ÿ综合考虑市场竞争、技术与成本方面的因素,产品特性发生变化,有计划地向市场发布的版本。
R版本以三位数字表示,数字间不准许有任何其它字母、符号出现,从001开始,在同一个V下面以1为单位连续递增,例如:R001、R002。