6.出包流程与规范

版本号控制与出包规范版本号控制与出包规范版本信息* A代表新增，M代表修改，D代表删除。版本号发布日期提交人审阅人A.M.D更新位置更新摘要V1.02014-05-22李健进A拟初稿V1.12014-07-29李健进M调整出包步骤，新增前言，调整部分语句的可读性目录1.前言31.1.基线释义31.2.基线的特征31.3.基线的优点与作用32.基线命名标准42.1.名词解释42.2.基线命名格式与范例42.2.1.基线格式42.2.2.包版本号格式52.2.3.基线范例53.出包规范53.1.出包步骤53.2.出包细则64.场景范例64.1.基线号阅读说明64.2.测试出包64.3.升级核心出包74.4.重大改动出包74.5.产品发布出包71. 前言1.1. 基线释义基线（Baseline）是软件文档或源码的一个稳定版本，它是进一步开发的基础。所以当基线形成后，项目负责人需要通知相关人员基线已经形成，并且哪儿可以找到这基线的版本，这个过程可被认为内部的发布。至于对外的正式发布，更是应当从基线了的版本中发布。基线是项目储存库中每个工件版本在特定时期的一个“快照”。建立一个初始基线后，以后每次对其进行的变更都将记录为一个差值，可以通过差值找出两条支线之间修改的代码。1.2. 基线的特征基线的主要特点为重现性和报告。l 重现性是指及时返回并重新生成软件系统给定发布版的能力，或者是在项目中的早些时候重新生成开发环境的能力。可帮助测试与开发人员对问题进行重现与回溯； l 报告来源于一个基线内容同另一个基线内容的比较。基线间的比较有助于调试、找出基线间的差值与生成发布说明。1.3. 基线的优点与作用l 基线为开发工件提供了一个定点和快照；l 新项目可以从基线提供的定点之中建立。作为一个单独分支，新项目将与随后对原始项目（在主要分支上）所进行的变更进行隔离；l 当认为更新不稳定或不可信时，基线为团队提供一种取消变更的方法；l 可以利用基线重新建立基于某个特定发布版本的工作区，可用于快速修复某个版本的bug，应急解决该版本的重要问题；l 可用于重现某个特定版本的bug，方便开发与测试人员快速重现与定位问题。2. 基线命名标准2.1. 名词解释l 核心包版本号：核心包中META-INFversion.xml定义的版本号；l 项目名称：合同上对应的项目名称的英文简写，如珠江地产项目，则命名为ZJDC。新版OA产品中统一使用exoa命名；l 打基线：操作步骤为全选CVS中的项目，执行Tag As Version，输入基线号后点确定即可。l 发布版本号：若本包通过测试，正式对外发布时，则本版本号加1，同时重大变更版本号与出包流水号清零；l 重大变更版本号：若本包有重大改动，经项目组同意，此版本号加1，同时出包流水号清零；l 包流水号：每次出包时此流水号加1。2.2. 基线命名格式与范例2.2.1. 基线格式项目英文名称(日期) _ 包版本号 _ 核心包版本号 exoa(20140515) _ V00_00_015 _ V01_03_010其中包版本号格式参照2.2.2包版本号格式中的描述，日期为出包日期。2.2.2. 包版本号格式包版本号描述当前包的状态（不包括核心包状态），此号为基线号的中间段组成部分。V发布版本号_重大变更版本号_ 包流水号V00_ 00_0152.2.3. 基线范例exoa(20140510)_V00_00_015-V01_03_0103. 出包规范3.1. 出包步骤1. 项目负责人通知项目组准备出包，同时给出出包时间点，如半小时后出包；2. 开发人员收到出包通知后，尽快将完成的代码进行提交，同时记录readme，半成品代码禁止提交。有疑惑则与项目组负责人沟通；3. 到时间后，通知项目组暂停使用cvs，项目负责人开始checkout代码；4. Checkout完成后，clean工作区与rebuild一次，确保工作区中无错误提示。若时间允许，尽量在本机工作区试运行，确保包可以正常部署；5. 根据基线命名标准构造新基线号，将新的版本号记录至readme中，并打好全局基线；6. 右键工程，选择导出ear包，其中ear包的命名方式为【基线号.ear】，如：exoa(20140515)_V00_00_015-V01_03_010.ear。3.2. 出包细则l 只要是对外（指开发组以外，如测试组、现场出包）提供代码，无论是出整包还是只取某个文件，必须要打好整体基线；l 对外出包的出口应该控制在一个人手上，该角色需要控制出包频率与定制基线；l 基线号一旦生成，不允许对本基线的任何文件作出修改。若有重要的修改，请打下一条基线；l 每次提交CVS前尽量使用findbug等代码检测工具遍历一次代码，提高代码质量。4. 场景范例本节主要描述在已有版本号的情况下，针对不同的情况，基线号的变更方式。以上一个版本号为exoa(20140510)_V00_00_015-V01_03_010，当前日期为20140515为例，在以下常见场景中如何对基线号进行命名。4.1. 基线号阅读说明对比当前基线与上一个版本的基线号，结合以下场景范例，即可大致判断出：包的变动规模、包的性质（发布包还是测试包）、核心包情况等情况。4.2. 测试出包常规性测试出包，包流水号加1。基线号更变为：exoa(20140515)_V00_00_016-V01_03_0104.3. 升级核心出包常规性给测试组出包，同时进行核心包升级，包流水号加1，同时后面的核心包版本号更新。基线号更变为：exoa(20140515)_V00_00_016-V01_03_0114.4. 重大改动出包若包有重大改动，如大规模样式变动，大规模核心改动，大规模技术架构变动等情况（如整包支持SAAS模式等），经过项目组讨论通过，则重大变更版本号加1，同时重置包流水号。基线号更变为：exoa(20140515)_V00_01_000-V01_03_010