软件版本规范简要说明(pdf 8页).pdf

研二软件版本规范说明 文件标识 当前版本 V0 2 0 作 者 张芳舵 饶远远 文件状态 草稿文件 正式文件 更改正式文件 创建日期 2010 年 7 月 19 日 I II 历 史 版 本 版本 状态 作者 参与者起止日期 备注 V0 1 0 草稿文件 张芳舵 软件部 2010 7 16 至 2010 7 17 张芳舵起草 V0 2 0 正式文件 饶远远 软件部 2010 7 17 至 2010 7 19 饶远远修改草稿文件 吕君已校查 戎讯研二软件版本规范说明文件 一 软件工程结构说明 软件工程结构 以展讯平台为例 如图 1 1 所示 MS Code Sub 6101 L509 NL01 GH01 Y04 Y03 Y02 GH02 L507 Macro Definition xls 图 1 1 展讯平台 Code 结构 1 MS Code 作为平台的 Base 根据不同的项目需求而进行不断的修改和完 善 每修改完一个功能或者 bug 后 上传至服务器 SVN 版本号自动加 1 2 对于项目客户特制化的需求 但与 MS Code 中的配置相冲突 就把修改 的配置项放置入 Sub 中 需要编译该项目时 只需要执行 Sub 中 copy bat 即可 将当前 Base 中的配置替换成 Sub 中客户特制化配置 3 在 Sub 文件夹中 首先是项目目录文件夹 如 L507 然后是对应的 客户名 硬件版本号文件夹 即 NL01 表示能量客户 硬件版本号 01 版 然 后是 Y01 Y02 等文件夹等 表示对应的能量客户不同的需求而设定的命名 Y01 下级就是定制化的一些文件 资源等等 4 Macro Definition xls 用于记录软件人员自定义宏的解释 主要包括了宏定 义名 宏定义功能 作者 加入时间等信息 1 戎讯研二软件版本规范说明文件 二 软件发布流程说明 V0 Xx 版本 MS Code 当前最新 V0 Xx 版本 归档 此为 V1 0 版本 Sub 当前最新 MS Code 当前最新 客户提出要求 或发现严 重问题 在 Sub 中更新 MS Code 继续更新 更新 更新 更新 测试结束 达到归档要求 MS Code 测试无问题 归 档 此为 V1 1 版 此bug在当前MS Code中存 在 在 MS Code 也更新一下 更新 更改版本号 其 它不做任何修改 寿命基本终止 特殊情况更新 V1 0 版 MS Code 继续更新 当前最新 Sub 图 1 2 软件版本发布流程 1 在项目研发的过程中 需要发布测试版本 测试版本使用最新的 MS Code 与最新的 Sub 相结合编译出 V0 Xx 如 V0 1 最后一位的如果是 0 可以忽略 版本提供给测试人员测试使用 软件人员将继续在 MS Code 中进行 bug 修改或 功能修改 在研发的过程中 软件开发人员会继续发布后续版本 当 MS Code 改动不大时 版本号在原基础上小写x处增加 当添加的新的功能 或对MS Code 改动较大时 版本号在原基础上大写 X 处增加 当测试人员测试结束 同意发 布正式版本时 在最后一次给测试人员的版本基础上修改版本号 使用归档版本 号 重新编译生成正式版本 V1 0 版本 2 归档之后 此项目的 sub 文件在一般情况下将不再更新 寿命基本终止 当客户对已归档软件版本提出修改要求 或在归档版本上发现严重 bug 时 使用 归档版本 如 V1 0 版 相对应的 MS Code 将修改文件放入 Sub 中 再编译 2 戎讯研二软件版本规范说明文件 生成相应的正式版本 版本号在原基础了进行加 0 1 如归档软件版本号为 V1 0 修改后版本号改为 V1 1 依次类推 如果此类修改或该 bug 在当前最新的 MS Code 上也存在需求 则在 MS Code 中也需要进行相应的更新 注意 在项目未终结 即 Sub 未与 MS Code 切断联系时 存在某种特殊情 况 需要将修改即在 MS Code 中提交也需要在 Sub 中提交 如 在 xx c 文件中存在某个变量直接使用数字赋值 这将不符合 CODE 规 范原则 需要将该数字使用宏替换 新曾宏定义将在 xx h 文件中 如果该 xx h 文件在 Sub 中存在 于是对该 xx h 文件的修改需要在 Sub 中进行提交 但其他 工程需要使用 MS Code 中的 xx h 文件 于是对 xx h 的修改也需要在 MS Code 中的 xx h 文件中进行 并提交至服务器 3 戎讯研二软件版本规范说明文件 三 发布软件版本步骤及注意事项 以展讯为例 1 先将 MS Code 文件夹 Revert 然后 update 到最新 2 记录最新的 SVN 版本号 3 修改对应项目 Sub 里的 version 的版本号 4 执行对应项目 Sub 里的 copy bat 命令 5 根据需要修改 MS Code 中的工程 mk 文件 是编译 Release 版本还是编 译 Debug 版本 设置工程 mk 文件中 RELEASE INFO 参数为 TRUE or FALSE 6 编译工程 生成 bin 文件 7 根据要求打包生成 pac 文件 将 pac 文件与 nvitem p3 文件夹压缩成压 缩包 压缩包与 pac 文件命名相一致 8 测试打包的文件 pac 能否 download 9 download 后测试手机能否正常开机 bug 是否修改过了 10 查看手机上的版本号 以及 version 里的版本号 与自己要发布的版本 号是否一致 11 上传压缩包文件以及 img 文件到服务器 12 发邮件通知其他相关人员软件版本的存放地址 13 提交 Sub 里的 xx version c 文件 并在提交记录中注明之前记录的 SVN 版本号 注意 Release 版本是发布给工厂生产 客户升级使用的 工厂生产是不带校准的 客户升级是必须带校准的 Debug 版本是发布给测试使用的 当修改了 NV 需要完全擦出 flash 时使用 不带校准的版本 并且要提示测试人员在 download 后要校准后再测试 一般情 况使用带校准的版本 4 戎讯研二软件版本规范说明文件 四 软件版本的命名规则 软件版本分为 Demo 版本 试产版本和量产版本 其中 Demo 版本是给客户 演示使用 能够实现基本的开屏 看到主菜单即可 目的是让客户初步认识一下 该项目是否可行 试产版本主要是针对硬件的 能够实现自动检测 量产版本 即归档化的版本 是给客户量产使用的版本 展讯平台分为 Release 版本和 Debug 版本 Release 版本又包括 Factory 版本 和 Upgrade 版本 Factory 版本是工厂生产使用版本 不带 Calibration Upgrade 版本是发布给客户升级使用版本 带有 Calibration MTK 平台只需发布一个 Release 版本 3 1 发布测试版本使用版本号命名规则 项目名 客户名 硬件版本号 特征 版本号 生成日期 L507 NL01 Y01 V0 1 20100726 生成日期 版本号 特征 Feature 客户名 硬件版本号 项目名 图 3 1 测试版本版本号命名 3 2 发布正式版本使用版本号命名规则 项目名 客户名 语言数 硬件版本号 特征 版本号 生成日期 L509 XDS F03 H02 Y0