Statcvs的安装部署及实施方案简述.docVIP

Statcvs的安装部署及实施方案简述 概念简介 该系统利用开源软件statcvs对cvs产生的日志文件进行分析整合，形成web网页方式。相关管理人员通过系统自带浏览器可以方便的进行查看，功能点重在统计开发者的工作量，对项目的度量能起到辅助作用。 优势： 与cvs系统配合较好。 能快速便捷的分析出cvs产生的日志信息，有利于及时查看配置项变化情况。 通过对cvs日志信息的进一步分析，可以直观的反映出开发者的工作状况。 资源开源，便于改进与交流 缺陷： 内容局限于cvs提供的日志信息。 日志信息源于cvs服务端中每个配置项的“,v”文件，主要内容包括：每个文件的配置库路径、文件名称、该文件的每个版本信息记录（包括提交人账号、提交时间、提交时输入的注释、提交的代码行数及修改的行数等） 代码行的统计条件较为苛刻，只能统计出文本格式文件的代码行数，将空格、空行、注释等信息视为正常代码行，不能准确体现开发者的真实工作量。 统计信息的期间为：自文件提交入配置库开始至统计的最后时间。统计信息累计叠加。不能自动展现某人任意一个期间段的统计情况。不能以项目或产品为对象进行项目版本差异比较。 安装部署简介 简述： 该系统有三部分组成：前台框架页面展现层、statcvs生成的统计页面以及cvs后台产生的日志信息。前台的静态页面框架保持不变，不断更新的是框架统计信息主页，该主页信息链接于后台statcvs产生的统计网页信息。统计的网页信息则由分析cvs生成的日志信息而来。 功能： 按一定周期自动更新出每个配置库的代码量变化信息，并以网页形式进行浏览，便于简便快捷的获取统计资料。 思路： 取得最新需要统计的cvs配置库配置项资源——生成log信息——通过statcvs将信息分析并生成页面——将页面发布于前台网站 安装部署： 按照以上思路，可以有两种安装部署方式能够实现目前功能。 通过cruisecontrol控制方式实现 操作系统linux、Windows均可，目前多媒体实验室代码统计系统为linux系统。 安装部署cruisecontrol，配置相关文件实现控制每个项目的配置库更新间隔及更新目录，通过配置相关文件实现日志的生成及分析页面的产生，并将之发布于前台展现页面。 需要注意的问题： 我们用的是statcvs0.4.0，故需要配置的环境变量为jre1.4.2以上版本。 优点：由cc控制，运行较稳定，利于推广扩展，便于迁移部署。 缺点：需要在配置库中添加相应脚本文件，调用及部署较繁琐，不利于无开发经验者上手。 通过脚本方式实现 通过脚本命令也可以实现所需功能 主要命令语句： Cvs update –p –d –c更新路径 （前提是需要checkout出相应路径） Cvs log xxx.log java -jar statcvs.jar -output-dir 输出目录名称 xxx.log 日志文件路径 将输出页面位置直接指向发布位置，并将起始脚本文件置于计划任务中，这样就可以实现周期性操作了。 优点：灵活简便，便于入手 缺点：只适用于该系统，不利于扩展，对操作系统依赖性强 有兴趣的朋友可修改根据本思路修改相关脚本代码，使其更加灵活可靠，易于移植！ Statcvs实施方案简介 根据statcvs的优缺点，初步草拟代码统计系统实施方案，思路如下： 利用statcvs的优势，前台可用web展现方式实现，更便于及时浏览。 后台通过cc实现持续集成过程，或者通过脚本语句完成后台统计页面自动生成并发布。 通过规范开发人员的日常操作，来提高代码统计的正确率，规范主要包括以下内容： 首次建立新文件时，应尽量添加成文本格式，一般除了office 系列产生的文件必须为二进制格式，jar包及一些链接库文件类型必须转化为二进制，以及一些特殊类型的文件需要转化为二进制格式进行提交外，其它文件均可转换为文本格式进行提交。可以利用TortoiseCVS-1.8.18自动添加内容，将新文件批量上传。 编码规范对应统计系统地要求，做出相应调整（该项包括提交文件时的注释信息规范化、编码中的注释及空行规范化等，可与开发人员共同讨论后，决定实施方法，尽量不给开发人员制造更多工作量，保证效率优先原则） 对于已经提交到配置库的中的二进制格式文件，将体现工作量的文件确认后，实行转化格式工作，可通过以下方法进行： 通过cvs自带命令完成，格式如下： cvs admin –ko filename 转换后需要验证，文件是否正确，是否有空行产生。