- 1、本文档共8页,可阅读全部内容。
- 2、原创力文档(book118)网站文档一经付费(服务费),不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
- 3、本站所有内容均由合作方或网友上传,本站不对文档的完整性、权威性及其观点立场正确性做任何保证或承诺!文档内容仅供研究参考,付费前请自行鉴别。如您付费,意味着您自己接受本站规则且自行承担风险,本站不退款、不进行额外附加服务;查看《如何避免下载的几个坑》。如果您已付费下载过本站文档,您可以点击 这里二次下载。
- 4、如文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“版权申诉”(推荐),也可以打举报电话:400-050-0827(电话支持时间:9:00-18:30)。
查看更多
程序代码版本管理的规范
软件版本管理规范
Approved by: Checked by: Prepared by: Software
Revision List
Date Description Revision Owner
目录
一、目的 - 4 -
二、适用范围 - 4 -
三、版本定义规范 - 4 -
四、版本代码设计规范 - 4 -
五、版本进阶规范 - 5 -
六、软件备份要求规范 - 5 -
七、软件版本发布规范 - 5 -
八、软件发布流程规范 - 7 -
九、量产中软件管理规范 - 8 -
一
二
本规范适用于研发部软件人员发布软件程序
本规范中所涉及软件为泛指一切以计算机代码形式存在的软件包括以下(但不限于)几类
Windows 软件
Linux 软件程序
内核单片机
FPGA 代码及烧录FW
本公司自己开发的驱动程序
第三方提供的驱动程序
第三方提供的烧录
3.1本规范规定
3.1.1 三位版本编码格式,即x.xx, 由三位数字和一位小数点组成
第一版正式版即1.00;
在xx 表示。
3.2 选用哪种版本号格式由软件自身情况决定同一软件版本号格式不得随意更改3.3 第三方公司提供的软件继续沿用第三方公司的版本号编码格式。
四、版本代码设计规范
为便于检查和查看软件版本,固件、软件版本通过工具可以被查看,因此在软件代码设计阶段,对版本查看应实现如下要求:
4.1固件
4.2上位机程序或软件版本可以通过以下方式之一进行查看
(1) 显示在标题栏、状态栏,或界面中;
(2) 通过“关于…”或 “About…”菜单查看;
(3) 通过命令行查看。例: xxxx –h 或 xxxx –ver;
五、版本进阶规范
5.1正式版版本迭代更新软件为修正bug完善功能增加功能的情况下需要对软件版本进行更新和升级
5.1.1三位版本编码格式
正式版本迭代升级
例:1.00 版本可以升级为 1.01,也可以升级为2.00;
较大的软件变动建议升级小数位之前5.2 测试版和试用版版本迭代更新。
产品量产后若需要修改部分功能或针对客户进行定制的F/W和Program在测试验证阶段均采用5位数字和2个小数点构成, 且只能修改最后两位数字版本号,如:1.01.00-?1.01.01,1.01.02。 只有当测试版本经过测试和验证,或客户认可后,才能发表正式版,进阶前3位数字。例: 1.01.02的测试版解决了某些bug或增加功能,并经过测试验证解决了实际的问题,则将1.01.02测试版重新编译,变更测试版本变更为正式版格式。如 1.01.02--1.02.00。
六、软件备份要求规范
软件代码变更后均要将变更更新至服务器
具体备份步骤参考
7.1正式版FW,软件需要经过工程测试部门验证后在进行发布。测试版软件发布由工程师根据实际情况而定
7.2正式版
Release notes 采用追加方式记录,即保留之前的更新日志。且采用倒序方式,最新版本更新日志在最前端。测试版更新一样要记录入更新日志文件。
Release notes 格式如下:
当前版本:1.01
日期:xx-xx-xx
Author:
更新原因及内容:
(1)Xxxxx
(2)Xxxxx
(分隔线)
前一版本:1.00.08(T测试版)(1)Xxxxx
(2)Xxxxx
……………………
八、软件发布流程规范
九、量产中软件管理规范
9.1 已发布的软件程序,安装包,Bin,Hex等文件需要在
9.2 生产部生产带有软件下载的PCBA或成品时,F/W(bin,hex)文件下载后须在相应芯片上贴上“机种、版本”标签。
9.3当软件版本有更新时,软件工程师和研发主管根据更新内容评估,对在产品,产成品,及已出货产品中的软件是否更新,其他部门应根据ECN要求执行更新动作。
9.4对已更新软件版本的产品,需要更换正确的,与之对应的标签;已出货的产品视具体情况而定。
9.5 QA应对出货及入库产品的软件版本进行检查检查方法由工程部或研发部提供
Working Instruction Document No.: Rev. Modify Date: Page: - 2 - of -8-
- 2 -
文档评论(0)