程序代码版本管理规范

1、- -DocumentNo.:Rev.ModifyDate:Page:-1-of-8-SoftwareApprovedby:Checkedby:Preparedby:- -WorkingInstructionDocumentNo.:Rev.ModifyDate:Page:-2-of-8-RevisionListWorkingInstruction- -DocumentNo.:Rev.ModifyDate:Page:-3-of-8-目录TOC o 1-5 h z一、目的-4-二、适用范围-4-三、版本定义规范-4- HYPERLINK l bookmark6 四、版本代码设计规范-4-五、版本进

2、阶规范-5- HYPERLINK l bookmark10 六、软件备份要求规范-5- HYPERLINK l bookmark12 七、软件版本发布规范-5-八、软件发布流程规范-7- HYPERLINK l bookmark14 九、量产中软件管理规范-8-DocumentNo.:Rev.ModifyDate:Page:-4-of-8-、目的1.1本规范规定了公司软件发布及版本管理规范，为工程师发布软件提供版本管理标准和流程。1.2提高本公司软件版本的可识别性，为工程，生产，售后服务提供便利性。二、适用范围本规范适用于研发部软件人员发布软件、程序时制定版本参考。本规范中所涉及软件为泛指一切

3、以计算机代码形式存在的软件，包括以下（但不限于）几类：Windows软件、程序Linux软件、程序3、经过裁剪后Linux内核4、单片机，DSP,ARM固件代码及烧录FW5、FPGA代码及烧录FW本公司自己开发的驱动程序第三方提供的驱动程序8、第三方提供的烧录FW三、版本定义规范3.1本规范规定：除第三方提供的软件以外，本公司开发的软件正式版本号采用如下格式，三位版本编码格式，即x.xx,由三位数字和一位小数点组成。第一版正式版即1.00；在1.00正式版之前研发内部测试和验证版本以0.xx.xx表示。选用哪种版本号格式由软件自身情况决定；同一软件版本号格式不得随意更改,一旦选用三位或五位版本

4、编码格式，在没有必要和充分的理由的前提下不能对版本号格式进行变更。第三方公司提供的软件继续沿用第三方公司的版本号编码格式。四、版本代码设计规范为便于检查和查看软件版本，固件、软件版本通过工具可以被查看，因此在软件代码设计阶段，WorkingInstruction- -DocumentNo.:Rev.ModifyDate:Page:-5-of-8-对版本查看应实现如下要求：固件：量产后烧录的F/W版本可通过以下两种方式之一进行查看可以通过LCD显示。(2)可用通过串口或其他通信接口通过电脑上位机软件(命令方式)获取上位机程序或软件版本可以通过以下方式之一进行查看(1)显示在标题栏、状态栏，或界面

5、中；(2)通过“关于”或“About”菜单查看；(3)通过命令行查看。例：xxxxh或xxxxver；五、版本进阶规范正式版版本迭代更新。软件为修正bug,完善功能，增加功能的情况下，需要对软件版本进行更新和升级，本规范规定如下：三位版本编码格式正式版本迭代升级可进行两部分变更，小数位之前或小数位之后。例：1.00版本可以升级为1.01,也可以升级为2.00；较大的软件变动建议升级小数位之前数字，较小的软件修正和变动建议升级小数位之后的数字。测试版和试用版版本迭代更新。产品量产后若需要修改部分功能或针对客户进行定制的F/W和Program在测试验证阶段均采用5位数字和2个小数点构成，且只能修改

6、最后两位数字版本号，如：1.01.00-1.01.01,1.01.02。只有当测试版本经过测试和验证，或客户认可后，才能发表正式版，进阶前3位数字。例：1.01.02的测试版解决了某些bug或增加功能，并经过测试验证解决了实际的问题，则将1.01.02测试版重新编译，变更测试版本变更为正式版格式。如1.01.021.02.00。六、软件备份要求规范软件代码变更后均要将变更更新至服务器Git版本库进行管理，未备份至Git版本库的软件版本不允许发布。具体备份步骤参考研发部Git版本库服务器使用指南。七、软件版本发布规范正式版FW,软件需要经过工程测试部门验证后在进行发布。测试版软件发布由工程师根据

7、实际情况而定。WorkingInstruction- -DocumentNo.:Rev.ModifyDate:Page:-6-of-8-正式版软件发布时要除软件本身外，需要附更新说明releasenotes。Releasenotes采用追加方式记录，即保留之前的更新日志。且采用倒序方式，最新版本更新日志在最前端。测试版更新一样要记录入更新日志文件。Releasenotes格式如下：当前版本：1.01日期：XX-XX-XXAuthor：更新原因及内容：(1)XXXXX(2)XXXXX(分隔线)前一版本：1.00.08(T测试版)日期：XX-XX-XXAuthor：更新原因及内容：(1)XXXXX

8、(2)XXXXX软件工程师代码编写、修改测试工程师测试验证验证通过?No反馈给软件工程师更新AYes客户验证(Option)验证通过?YesDocumentNo.:Rev.ModifyDate:Page:-7-of-8-DocumentNo.:Rev.ModifyDate:Page:-8-of-8-九、量产中软件管理规范9.1已发布的软件程序，安装包，Bin,Hex等文件需要在FTP中进行备份。备份管理工作由工程部负责。9.2生产部生产带有软件下载的PCBA或成品时，F/W(bin,hex)文件下载后须在相应芯片上贴上“机种、版本”标签。9.3当软件版本有更新时，软件工程师和研发主管根据更新内容评估，对