软件版本规范说明

研二软件版本规范说明文件标识：当前版本：V0.2.0作者：张芳舵饶远远文件状态[]草稿文件[√]正式文件[]更改正式文件创建日期：2010年7月19日III历史版本版本/状态作者参与者起止日期备注V0.1.0草稿文件张芳舵软件部2010-7-16至2010-7-17张芳舵起草V0.2.0正式文件饶远远软件部2010-7-17至2010-7-19饶远远修改草稿文件吕君已校查戎讯研二软件版本规范说明文件一、软件工程结构说明软件工程结构（以展讯平台为例）：如图1.1所示MS_CodeSub6101L509NL01GH01Y04Y03Y02GH02L507MacroDefinition.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、MacroDefinition.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参数为TRUEorFALSE；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_Y03_V11_100708生成日期（六位表示）版本号特征(Feature)硬件号语言数（中英文不写）客户名项目名图3.2、正式版本版本号命名说明：F03代表具有除英文外的三国语言的多国语言版本（英语不算多国语言），中英文此项省略。5戎讯研二软件版本规范说明文件附录：软件部—技术文件命名规则_V1.16