软件版本管理规定.doc

上海精佑通信技术有限公司企业标准（管理标准）Q/HT 00012005软件版本管理规定V1.042005-04-11 发布 2005-04-11实施目 录1范围42术语和定义42.1软件42.2产品软件42.3生产支持软件43软件版本命名规则53.1软件版本命名组成53.2手机软件版本命名53.3模块软件版本命名53.4手机PC侧软件版本命名63.5模块PC侧软件版本命名63.6手机生产支持软件版本命名73.7模块生产支持软件版本命名83.8公用于所有手机和模块的软件版本命名93.9无线上网卡相关软件版本命名93.10无线上网卡驱动软件版本命名103.11正式版本号的升级规则103.12版本的电子文件命名规则104软件版本发布流程115禁止条例136管理条例137附录13文档版本变更记录：版本号拟制日期拟制人版本描述存档编号V1.002005-4-11郝军初始版本V1.012005-4-27郝军1 版本号前增加“V”,用以明显标识版本号2 版本号和时间之间以下划线分隔3 增加生产支持软件种类4 增加无线上网卡生产支持软件、管理器软件和驱动软件命名5 增加版本发布流程的文字说明V1.022005-7-1郝军增加手机和模块生产支持软件的类型：射频补丁软件（RFP）V1.032005-7-15郝军更改版本号升级规则，更改资料外发申请表V1.042005-7-26郝军增加机卡合一版本的命名规则注：1）拟制、审核、会签、批准不走电子流程时，必须用钢笔或签字笔填写，不得用铅笔、圆珠笔填写。前 言为规范公司产品软件版本的管理与控制，保证产品版本的有效与质量，制定本标准。本标准由公司技术部拟制，技术部归口管理。本标准由技术部会同软件部、测试部和计划部共同起草。本标准主要起草人：郝军、王瑾本标准于2005年4月首次发布。 软件版本管理规定1 范围 本标准规定了公司产品软件版本的控制与管理。 本标准适用于公司产品软件版本的控制与管理。2 术语和定义 下列定义适用于本标准。2.10 软件指与产品相关的所有软件，按功能可以分为产品软件和生产支持软件。2.20 产品软件指可以下载到产品中的可执行文件或PC机中运行的手机助理软件。包括a) 手机软件：指手机项目中可以下载到手机中的可执行文件；b) 模块软件：指模块项目中可以下载到模块中的可执行文件；c) PC侧软件：指在PC机中运行的手机助理软件。d) 无线上网卡相关软机：指与无线上网卡相关的下载、UI测试、管理器软件。e) 无线上网卡驱动软件：因为转换芯片（串口/PCMCIA）可能不同（现在用的是CF950），所以驱动软件可能有所不同。2.30 生产支持软件指产品软件之外的支持软件。包括：a) 激活软件：指激活加密版本手机的软件；b) 打印软件：指打印各种标贴的软件；c) 校准软件：指校准手机各种参数的软件；d) 终测软件：指对手机进行综合测试的软件；e) 下载软件：指下载手机软件到手机中的工具软件；f) 多窗体下载软件：最多支持16个端口同时下载的工具软件；g) 写ESN号软件：指向手机中写ESN号的软件；h) 写IMEI号软件：指向手机中写IMEI号的软件；i) 写板号软件：指向手机中写主板号的软件；j) 写数据库软件：指向数据库中写ESN/IMEI的软件；k) 烧号软件：指向手机中写手机号码的软件；l) 功能测试软件：指测试手机各种功能的软件；m) 绑定软件：指手机捆绑销售时锁网、锁卡、锁号的软件；n) 解绑定软件：指解除手机绑定功能的软件；o) 解锁软件：指解除手机开机密码的软件；p) 维修软件：指手机生产维修用的软件；q) 装箱打印软件：指打印手机包装的软件；r) 生产支持软件包:指生产支持软件的压缩包文件；s) LCD测试软件:指生产线LCD检测专用软件；t) BOOT软件:指具有启动引导和修复功能的软件；u) 耦合测试软件：指耦合方式下的射频指标测试软件；v) 板测软件：整机装配前的射频校准终测软件。w) 射频补丁软件：修改射频参数，使之达到射频指标测试要求。3 软件版本命名规则3.10 软件版本命名组成公司产品的正式软件版本命名由四部分组成。第一部分是产品标识，第二部分是中间以圆点隔开的版本数字，第三部分是日期，第四部分是功能标识，用于区分PC侧软件、生产支持软件、CDG测试软件和机卡合一软件等。3.20 手机软件版本命名手机软件版本的命名规则如下所示：产品标识VX.YY_YYMMDD功能标识版本号和时间之间以下划线分隔。为了适用下载软件，手机软件版本命名长度不超过20位，最后不足20位以符号补齐。具体含义见表1。表1 手机软件版本命名规则描述描述项名称描述项说明产品标识最大八位字母或数字的组合，不足八位的，和版本号之间留有一位空格，如“C100V”,“C200V”等VV代表版本号的起始位主版本X一位数字表示，初始值为1，表示软件的主版本号次版本YY两位数字表示，初始值为00，表示软件的次版本号时间YYMMDD六位数字表示，2位数字年，2位数字月，2位数字日功能标识字母或数字的组合。对于手机机卡分离版本，此项空缺，以符号补齐20位；对于手机机卡合一版本，用NUS标识；对于CDG测试版本，用CDG标识例如：C200VV1.00_050530C100VV1.01_050407NUS3.30 模块软件版本命名模块软件版本的命名规则如下所示：产品标识VX.YY_YYMMDD功能标识版本号和时间之间以下划线分隔。为了适用下载软件，模块软件版本命名长度不超过20位，最后不足20位以符号补齐。具体含义见表2。 表2 模块软件版本命名规则描述描述项名称描述项说明产品标识最大八位字母或数字的组合，不足八位的，和版本号之间留有一位空格，第一位大写英文字母表示硬件标识，后续位是升级保留代码，如“A0V”,“AIV”等VV代表版本号的起始位主版本X一位数字表示，初始值为1，表示软件的主版本号次版本YY两位数字表示，初始值为00，表示软件的次版本号时间YYMMDD六位数字表示，2位数字年，2位数字月，2位数字日功能标识字母或数字的组合。对于模块机卡分离版本，此项空缺，以符号补齐20位；对于模块机卡合一版本，用NUS标识，不足20位的，以符号补齐；对于CDG测试版本，用CDG标识，不足20位的，以符号补齐例如：A0VV1.00_050530AIVV1.00_050407NUS3.40 手机PC侧软件版本命名手机PC侧软件版本的命名规则如下所示：产品标识VX.YY_YYMMDDPC版本号和时间之间以下划线分隔。具体含义见表3。表3 手机PC侧软件版本命名规则描述描述项名称描述项说明产品标识最大八位字母或数字的组合，不足八位的，和版本号之间留有一位空格。对于特定某款手机的PC侧软件，用该产品标识表示，如“C100V”,“C8058V”等。对于适合所有手机的PC侧软件用“MOBILEV”表示VV代表版本号的起始位主版本X一位数字表示，初始值为1，表示软件的主版本号次版本YY两位数字表示，初始值为00，表示软件的次版本号时间YYMMDD六位数字表示，2位数字年，2位数字月，2位数字日功能标识字母或数字的组合，PC大写，代表PC侧软件例如：C8058VV1.00_050530PCMOBILEVV1.00_050530PC 3.50 模块PC侧软件版本命名模块PC侧软件版本的命名规则如下所示：产品标识VX.YY_YYMMDDPC版本号和时间之间以下划线分隔。具体含义见表4。表4 模块PC侧软件版本命名规则描述描述项名称描述项说明产品标识最大八位字母或数字的组合，不足八位的，和版本号之间留有一位空格。对于特定某款模块的PC侧软件，第一位大写英文字母表示该模块硬件标识，后续位是升级保留代码，如“A0V”,“AIV”等。对于适合所有模块的PC侧软件用“MODULEV”表示VV代表版本号的起始位主版本X一位数字表示，初始值为1，表示软件的主版本号次版本YY两位数字表示，初始值为00，表示软件的次版本号时间YYMMDD六位数字表示，2位数字年，2位数字月，2位数字日功能标识字母或数字的组合，PC大写，代表PC侧软件例如：A0VV1.00_050530PCMODULEVV1.00_050530PC3.60 手机生产支持软件版本命名手机生产支持软件版本的命名规则如下所示：产品标识VX.YY_YYMMDD功能标识版本号和时间之间以下划线分隔。具体含义见表5。表5 手机生产支持软件版本命名规则描述描述项名称描述项说明产品标识最大八位字母或数字的组合，不足八位的，和版本号之间留有一位空格。对于特定某款手机的生产支持软件，用该产品标识表示，如“C100V”,“C8058V”等。对于适合所有手机的生产支持软件用“MOBILEV”表示VV代表版本号的起始位主版本X一位数字表示，初始值为1，表示软件的主版本号次版本YY两位数字表示，初始值为00，表示软件的次版本号时间YYMMDD六位数字表示，2位数字年，2位数字月，2位数字日功能标识字母或数字的组合主要的功能标识见表6。表6 生产支持软件功能标识表功能标识功能描述ACT激活软件BP打印软件CAL校准软件FT终测软件DB写数据库软件DON下载软件DONM多窗体下载软件ESN写ESN号软件FUN功能测试软件IME写IMEI号软件LCK绑定软件UB解绑定软件UM解锁软件REP维修软件SN写板号软件SOW烧号软件STR装箱打印软件TST生产支持软件包LCDLCD测试软件BOTBOOT软件WT耦合测试软件BT板测软件RFP射频补丁软件对于不能用以上功能标识指定的软件，在软件提交时由开发人员和版本管理员共同讨论确定。例如：C8058VV1.00_050530LCDMOBILEVV1.00_050530UM3.70 模块生产支持软件版本命名模块生产支持软件版本的命名规则如下所示：产品标识VX.YY_YYMMDD功能标识版本号和时间之间以下划线分隔。具体含义见表7。表7 模块生产支持软件版本命名规则描述描述项名称描述项说明产品标识最大八位字母或数字的组合,不足八位的，和版本号之间留有一位空格。对于特定某款模块的生产支持软件，第一位大写英文字母表示该模块硬件标识，后续位是升级保留代码，如“A0V”,“AIV”等。对于适合所有模块的生产支持软件用“MODULEV”表示VV代表版本号的起始位主版本X一位数字表示，初始值为1，表示软件的主版本号次版本YY两位数字表示，初始值为00，表示软件的次版本号时间YYMMDD六位数字表示，2位数字年，2位数字月，2位数字日功能标识字母或数字的组合主要的功能标识见表6。例如：A0VV1.00_050530DONMODULEVV1.00_050530DON3.80 公用于所有手机和模块的软件版本命名公用于所有手机和模块的软件版本命名规则如下所示：产品标识VX.YY_YYMMDD功能标识版本号和时间之间以下划线分隔。具体含义见表8。表8 公用于所有手机和模块的软件版本命名规则描述描述项名称描述项说明产品标识用“HUNTEL”表示，和版本号之间留有一位空格VV代表版本号的起始位主版本X一位数字表示，初始值为1，表示软件的主版本号次版本YY两位数字表示，初始值为00，表示软件的次版本号时间YYMMDD六位数字表示，2位数字年，2位数字月，2位数字日功能标识字母或数字的组合主要的功能标识见表6。例如：HUNTELVV1.00_050530BOT3.90 无线上网卡相关软件版本命名无线上网卡相关软件版本命名规则如下所示：产品标识VX.YY_YYMMDD功能标识版本号和时间之间以下划线分隔。具体含义见表9。表9 无线上网卡相关软件版本命名规则描述描述项名称描述项说明产品标识用“PCMCIA”表示，和版本号之间留有一位空格VV代表版本号的起始位主版本X一位数字表示，初始值为1，表示软件的主版本号次版本YY两位数字表示，初始值为00，表示软件的次版本号时间YYMMDD六位数字表示，2位数字年，2位数字月，2位数字日功能标识字母或数字的组合，用于区分无线上网卡相关软件主要的功能标识见表10。表10 无线上网卡相关软件功能标识表功能标识功能描述DON下载软件UITUI TEST软件MAN管理器软件(精佑内部使用)MAN_HK用于虹康的管理器软件对于不能用以上功能标识指定的软件，在软件提交时由开发人员和版本管理员共同讨论确定。例如：PCMCIAVV3.04_050530MAN3.100 无线上网卡驱动软件版本命名无线上网卡驱动软件版本命名规则如下所示：产品标识VX.YY_YYMMDD功能标识版本号和时间之间以下划线分隔。具体含义见表11表11 无线上网卡驱动软件版本命名规则描述描述项名称描述项说明产品标识串口和PCMCIA接口的转换芯片的型号，不足八位的，和版本号之间留有一位空格。现在用的转换芯片型号为CF950，用 “CF950V”表示VV代表版本号的起始位主版本X一位数字表示，初始值为1，表示软件的主版本号次版本YY两位数字表示，初始值为00，表示软件的次版本号时间YYMMDD六位数字表示，2位数字年，2位数字月，2位数字日功能标识字母或数字的组合，这里用DRV代表驱动软件例如：CF950VV3.04_050530DRV3.110 正式版本号的升级规则软件的正式版本号升级，应该能体现出版本继承性关系，根据软件改动的大小，进行正式版本号升级。3.11.1 软件版本升级规则1) 研发阶段主版本X的值为1，小批量生产阶段主版本X升级为22) 研发阶段软件的初始正式版本号为1.00；3) 从研发阶段进入小批量生产阶段，版本从研发阶段的1.YY升级为2.01；4) 小批量生产阶段，版本从2.01开始升级；5) 研发阶段每次版本升级，版本号和日期均升级(主板本X为1，次版本YY和时间YYMMDD均升级)；6) 小批量生产阶段，遇某一版本外发，接下来的版本版本号和日期均升级(主板本X为2，次版本YY和时间YYMMDD均升级)，如果没有外发，则只变动日期，版本号不升级（X.YY与上一版本一致，时间YYMMDD升级）；7) 研发阶段所有软件升级正式版本号需连续，小批量生产阶段所有软件升级正式版本号连续（有外发）或不变（无外发）。备注：项目从研发阶段进入小批量生产阶段，项目经理应及时通知软件部版本负责人和技术部；版本外发，项目经理应提前通知技术部，技术部或项目经理应及时通知软件部版本负责人。3.11.2 主版本号升级主版本号X的升级发生在改型或进行功能重大变更，或者项目阶段发生变化时。这种升级需要经过项目调整申请评审，并有相应的改型或变更设计与之对应。3.11.3 次版本号升级次版本号YY的升级由某版本的各种修补来决定。版本每修补一次，就由00到99向前升级一个版本。3.120 版本的电子文件命名规则1) 电子文件名同软件版本命名；2) 文件的后缀根据实际需要取用，具体如下：l elf TRACE32下载文件l bin 串口下载文件l hex 生产烧录文件l exe 生产支持软件的安装程序文件等l dll 烧号软件的动态链接库文件l zip 生产支持软件的压缩包文件l sys 2k以后的驱动文件l vxd 2k以前的驱动文件l inf 生产厂家定义的设备配置文件l cat 生产厂家定义的目录文件3) 同一生产支持软件版本包含两个及以上文件必须以压缩包方式提交；4) 相同后缀名的文件如果用途不同，必须在文件名中注明。4 软件版本发布流程1) 软件项目组长填写*软件版本说明(电子档,类似于以前的版本说明),写明这个版本的更改项和测试项；2) 交与项目经理审核(项目经理需要把握版本发布进度)；3) 项目经理同意（或不同意）发布版本；4) 项目经理同意，软件项目组长制作版本；5) 软件项目组自测人员自测；6) 自测通过，请告知版本管理员，版本管理员审核（文件齐全,命名规范）,相关人员填写版本说明表；7) 版本管理员文件归档,在故障库中添加版本号,通知测试项目组长测试；8) 测试项目组长提交*软件版本测试报告(电子档)，并说明是否放行(标准：产品故障分类标准和版本放行管理规定)；9) 版本管理员依照标准审核,相关人员填写版本说明表；10) 版本管理员测试报告归档，并登记该版本可(或不可)对外发布。软件版本发布流程框图：5 禁止条例1) 禁止生产线使用服务器上正式发布版本以外的版本；2) 禁止软件部、测试部、直接将版本发给生产线使用；3) 禁止软件部直接将部门内编译版本发给测试部进行测试，禁止测试部直接从软件部取用版本进行测试；4) 禁止审批中上一审批未通过，跳跃至下一审批。6 管理条例1) 技术部负责监督软件版本管理的实施；2) 有审核权的人员不在岗时，应事先指定授权人；3) 内部版本从申请版本提交到最终技术部归档，最长时间不得超过7天；4) 项目从研发阶段进入小批量生产阶段，项目经理应及时通知软件部版本负责人和技术部；5) 版本外发，项目经理应提前通知技术部，技术部或