软件开发操做规范SOP

 

软件开发操做规范SOP

 

版本	修订内容
v0.0.1	[20160620]完成草稿.

 

 

• 1.源码开发

使用到的工具,SVN,SourceInsight3.5,BeyondCompare.

 

• 2.善用工具

SourceInsight是很强大的代码编辑和阅读工具.可是标准版本是不支持UTF8字符编码的,中文是使用ANSI编码才显示正常的. 幸亏咱们有一些插件帮忙. 我建议使用这些插件,从而支持UTF8编码,可以在各类编辑器和编译平台完美显示. SourceInsight还有一些可自定义的宏,极大提升编码效率. 此外建议使用我提供的配置文件,主要是使用等宽字体以及关键字标注风格.

BeyondCompare是用于对比两个目录或者两个文件的,它还能对比两个压缩包(tar,tgz,zip,rar),两个文本(xml,txt,cpp等),两个word或excel文档,甚至于两个图片文件. 我建议修改其配置,

 

SecureCRT是用于远程会话的工具,一般telnet到设备上会用到它,它比windows自带的telnet客户端好处多多. 能记录日志文件,可以搜索文本,很方便的回滚和复制粘贴,等等.建议使用我提供的SecureCRT工具包,和标准版本相比改变了默认配置,可自动记录日志文件.

  

• 3.准备工做

1.将SVN服务器上源码导出(export)到PC上某个目录,做为编辑目录.

使用SourceInsight导入编辑目录中的源码文件.好比,E:\project\temp\default-hi3518.

2.在编译服务器或虚拟机上,建立一个同名的编译目录.

好比,Y:\project\temp\default-hi3518.

3.将SVN服务器上源码检出(checkout)到PC上某个目录,做为SVN操做目录.

好比, E:\svn\temp\default-hi3518.

 

 

• 4.修改源码的过程

1.经过SourceInsight查看和修改编辑目录的源码.

2.经过BeyondCompare将编辑目录的源码同步到编译目录. 此过程当中,能够确认BeyondCompare中差别点是本次修改和要验证的.

3.在编译目录,编译源码和验证.

 

下图显示了编辑目录和编译目录经过BeyondCompare的对比操做.

 

 

• 5.提交源码的过程

1.在SVN操做目录执行更新(update).

由于可能在我上次执行更新(update)后有其余人提交了修改,我必须更新这些修改,不然直接提交个人源码,可能会覆盖其余人的修改.

2.经过BeyondCompare将编译目录与SVN操做目录进行同步和合并.

此过程当中,查看BeyondCompare中的差别点,确认是本次将要提交的修改,要同步到SVN操做目录,或者是SVN操做目录中更新到的其余人的修改,要同步到个人编译目录中.

3.若是合入了其余人的修改,就须要在编译目录,再次编译源码和验证.验证完毕后,将编译目录的修改同步到编辑目录. 此过程当中,确认这些差别点都是其余人提交的修改.

4.在SVN操做目录执行提交(commit).[Notes1:提交前还有些事情要作,请看下文]

 

下图显示了编译目录和SVN操做目录经过BeyondCompare的对比操做.

 

 

• 6.DeWarning

程序要完成功能,还要干的漂亮.编译中出现的每一个warning都要找到并消除.虽然大部分warning都无害,但有些可能会致命,可能致使难以复现和查找的死机问题. 消除每个隐患,从消灭warning开始.

将要提交的修改,须要作dewarning处理,确保不会引入新的warning.

 

• 7.代码检视

在向SVN提交修改前,除了要作自测试和dewarning,还须要请其余同事帮助检查修改的代码.这称之为代码检视.

必须完成自测试以后,才能进行代码检视.

代码检视的目的,一是检查修改是否能解决现有问题,是否会引入新问题.二是检查所作的修改是否符合你们约定的代码规范. 代码提交以后,代码就是全部人的,”不合群”的代码不受欢迎.

 

代码检视以前,要准备好修改先后的两份代码,经过BeyondCompare展现出每一个修改点.而后邀请其余同事一块儿检查代码.

代码检视过程当中,应该让别人明白我这次修改的目的,个人实现思路,以及每一个修改点的意义.若是对源码注释不够,代码风格不符合约定标准,也会让人难以明白.

代码检视一般会作的,检查代码规范和注释,检查有没有资源泄漏(内存没释放,句柄没关闭等等),检查条件分支是否完整无遗漏,检查边界条件是否合适,是否有冗余的代码.其余各类挑剔.

 

作代码检视时若是被别人发现有明显缺陷,对程序员来讲多少有点丢脸,这是正常的. 若是没有这样的压力,可能就没有那种动力去作得完美. 若是我修改代码的时候,知道明天每行修改都会被别人围观,那今天我就尽可能作得完美点.不然,我也能够糊弄一下,程序能在实验室环境下测试过就无论代码会不会变质腐败. 若是摆好心态,把代码当成你们的做品,不让咱们的做品出现人为不慎致使的瑕疵. 检视代码就是一块儿围观,不由于检查到别人代码的缺陷而认为本身更高明,也不由于被别人检查到本身代码的缺陷而感受被嘲笑.

 

问题单处理