- 当开发负责人提交测试申请时;
- 开发过程中进行测试,修改好一个或多个bug,需要测试工程师验证时。
从测试分支到发布分支的迁移,由配置库管理员操作。迁移的时机有:
1.当开发组提交上线申请时。
对于每个项目从测试分支到发布分支的迁移,配置库管理员要建立分支迁移日志,并详细记录。
4.5.3. 版本升级
软件系统迁移到发布分支后,生成新的版本。
每个系统新的版本不仅以分支形式存在于配置库中,并且要以独立压缩包形式备份。
版本的命名规则为,version N1.N2.N3[.N4][_][T/R5]_YYYYMMDD - N1是系统编 。当项目整体重新设计时,N1加1,基数为1
- N2是模块编 。当模块重新设计时,N2加1,基数为0
- N3是功能编 。当项目增加某一功能,或某一功能需要修改时,N3加1,基数为0
- N4是BUG编 。当项目的BUG被修复时,N4加1,基数为0
- T/R5中的T/R分别对应Test/Release。当项目发布时为R,当项目提交测试时为T,T/R5数值基数为0,以发布/测试提交顺序递增加1 。
- YYYYMMDD代表生成版本的实际年月日,如:20160202
4.5.4. 版本基线定义
公司首次采用版本管理规范时,可以采取下列方法定义一个基线版本。
获取各项目最新的源程序、配置文件和文档,形成发布分支、测试分支和开发分支。
对每个项目的提测和发布分支都生成一个版本基线,如:Version1.0.0_R1_20160202。
4.6. 第五章 版本提交准则
4.6.1. 提交之前先更新
更新的原则是要随时更新,随时提交。当完成了一个小功能,能够通过编译并且自己测试之后,谨慎地提交。
如果在修改的期间其他同事也更改了同一个文件,那么update更新时会自动进行合并,如果修改的是同一行或者二者修改差异过大,那么合并时会产生冲突。这种情况就需要同之前的开发人员联系,两人一起协商解决合并冲突。解决合并冲突之后,还需要两人一起测试,以保证解决冲突之后,各自的程序不会受到影响。
在更新时注意所更新文件的列表,如果提交过程中产生了更新,则需要重新编译并且再次完成单元测试,再进行提交。这样既能了解别人修改了哪些文件,同时也能避免合并错误导致代码有错。
4.6.2. 保持原子提交
为确保在需要时可以随时回溯代码版本,每次提交的代码只能包含实现一个独立、完整功能所必需的代码,不能夹带提交其他与此功能不相关的代码。为尽早提交,也可以将此独立、完整功能分解为若干小细节功能,分别开发并提交所必需的代码,但必须确保多次提交的功能代码组合在一起,完全实现此独立、完整功能。
仅提交自己修改的部分,最好不要一下子将整个项目提交。
每完成一个独立、完整的功能后,最好尽早提交,以免后续更改时出现bug,无法恢复到正常代码。
每次提交的间歇尽可能地短,以几个小时的开发工作为宜。我们提倡多提交,也就能多为代码添加上保险。为做到尽早提交,在开发功能模块的时候,先将功能分解成一个个独立的、不可再分割的小细节功能,分别完成。每完成一个并通过单元测试,就提交一次。在修改bug的时候,每修改掉一个bug并且确认修改了这个bug,也就提交一次。
4.6.3. 不要提交本地自动生成的文件
一般配置管理员都会将项目中一些自动生成的文件或者与本地配置环境有关的文件屏蔽提交(例如Eclipse中的.classpath文件等,Visual Studio中的.suo文件,Debug,Release,Obj等编译文件夹及其下文件,以及其他的一些自动生成,同编译代码无关的文件)。如果项目中没有进行这方面的配置来强行禁止提交这样的文件,请自觉不要提交这样的文件,如果不小心签入了,需要从配置库中删除,以免其他同事在更新后就可能与本地的环境冲突从而影响大家的工作。
4.6.4. 不要提交不能通过编译的代码
代码在提交之前,首先要确认自己能够在本地编译通过,并且代码在提交前已经通过自己的单元测试。
如果在代码中使用了第三方类库,要把相应类库文件统一存储在代码相应目录中并提交,以免项目组成员中有些成员可能没有安装相应的第三方类库,从而在更新代码后引起代码运行错误。
4.6.5. 不要提交自己不明白的代码
代码在提交之后即被项目成员所分享。如果提交了不明白的代码,自己看不懂,别人也看不懂,如果在以后出现了问题将会成为项目质量的隐患。因此在引入任何第三方代码之前,确保对这个代码有一个很清晰的了解(必要时应有对应文档说明)。
4.6.6. 并行开发(同一模块)前沟通
如果开发小组采用并行开发模式开发同一模块功能,在开发前,需要对协作开发进行合理的工作计划与任务分配,让小组成员相互间了解对方的工作计划与工作内容。这样能尽可能的减少在开发过程中可能出现的冲突,提高开发效率。同时也能够在和成员的交流中发现自己之前设计的不足,完善自己的设计。
4.6.7. 对提交更新的信息采用明晰的标注
如果提交空的标注或者不确切的标注将会让项目组中其他的成员不了解此次签入动作的背景情况(如新增/修改签入的原因是什么增/修改什么内容,项目经理无法通过提交的标注信息,清晰的掌握开发工作进度细节进度。没有清晰标注,甚至会对回溯代码版本造成影响。所以,在提交工作时,要填写明晰的标注,能够概要的描述所提交文件的信息,让项目组其他成员在看到标注后不用详细看代码就能了解你所做的修改。统一的标注格式为:
签入动作+””+”#” +标识ID+”;”+签入内容+[“;”]+[签入原因]
签入动作:
+:表示增加了功能(新增功能)
*:表示对某些功能进行了更改(修改功能)
-:表示删除了文件,或者对某些功能进行了裁剪,删除,屏蔽(删除功能)
^:表示修正bug(修复功能缺陷)
!:优化功能代码的执行性能(代码性能优化)
标识ID:
ID值是从项目开发计划中的WBS任务分解表中获取,对应具体功能编 。
签入内容:
对新增/修改/删除 的内容进行简单描述
签入原因:
对修改/删除 的原因进行简单描述
示例:
声明:本站部分文章及图片源自用户投稿,如本站任何资料有侵权请您尽早请联系jinwei@zod.com.cn进行处理,非常感谢!