Question

软件版本命名规范（嵌入式）

Answer 1

一、编写目的

规范软件版本的命名，统一软件版本定义，方便软件升级与维护，降低沟通成本，提高工作效率。

二、适用范围

此命名规则适用于程序文件（.bin文件，.img文件，.hex文件等）命名以及程序内部的版本号命名。

三、内容描述

1 、软件版本命名规则

命名规则中的不同字段以下划线“_”做分隔符，字段名称本身不允许含有下划线“_”符号。

1）  主应用程序完整 bin 程序或 hex 文件

此程序常用于文件系统和驱动程序没有变化，只需要升级应用程序的情况，如大量的售后升级维护。

PCB_Product_ Option1 Option2...Option_Version_Date_CPU .Suffix

字段说明

PCBPCB名称可取其功能名，如MB、KEY&LED、AUDIO、VIDEO；分别表示，主板、按键、灯板、音频、视频板等。此为可选字段，一般为单片机程序使用，如果没有该字段则留空。

Product 产品型号 以项目启动时产品经理发布的为准，如F9164-TD

Option1Option2...OptionN

标识标准/非标准版本，如Standard为自主等。

Version版本号Vxx.xx.xx，如V0.0.1，V1.0.0，V1.0.1，V1.1.1，V2.0.0

Date日期，年月日，如20200101

CPUCPU型号信息。此为可选字段，一般为单片机程序使用，如果没有该字段则留空。

Suffix文件后缀，如img，bin，hex，zip，rar，tar.gz等

表格1常规字段说明

示例：

F9164-TD-Standard_V1.0.0_20200101.bin

F9164-TD-Standard_V1.0.0_20200101_T.bin（特单）

2 ）主板版本

MB_Product-Option_Version_Date

示例：

MB_F9164-TD-Standard_V1.0.0_20200101

2 、软件版本号Version升级规则

1)、全新项目第一个正式发布的测试版本默认V1.0.0。

2)、从第二个正式测试版本开始，每次发布测试版本，必须升级软件版本号。

3)、相对上一版本的修改，

如果是少量bug修改，则升级最后一位版本号，如从V1.0.0改为V1.0.1；

如果涉及到功能增加、删减，或者协议小修改，或者数量众多的小修改，则升级中间一位版本号，如从V1.0.1改为 V1.1.1；

如果涉及到平台升级、协议增加、协议架构调整等重大修改，则升级第一位版本号，如从V1.1.1

改为 V2.0.0。

4)、发布给生产部的试产版本，如果和当前正在测试的版本有差异，同样需要在当前测试版本的基础上递增版本号。