代碼統(tǒng)計系統(tǒng)使用手冊

代碼統(tǒng)計系統(tǒng)使用說明

簡介：該系統(tǒng)利用開源軟件statcvs對cvs產生的日志文件進行分析整合，形成web網頁方式。相關管理人員通過系統(tǒng)自帶瀏覽器可以方便的進行查看。

優(yōu)勢：

1、 與cvs系統(tǒng)配合較好。

2、 能快速便捷的分析出cvs產生的日志信息，有利于及時查看配置項變化情況。

3、 通過對cvs日志信息的進一步分析，可以直觀的反映出開發(fā)者的工作狀況。

4、 資源開源，便于改進與交流

缺陷：

1、 內容局限于cvs提供的日志信息。

日志信息源于cvs服務端中每個配置項的“,v”文件，主要內容包括：每個文件的配置庫路徑、文件名稱、該文件的每個版本信息記錄（包括提交人賬號、提交時間、提交時輸入的注釋、提交的代碼行數(shù)及修改的行數(shù)等）

2、 代碼行的統(tǒng)計條件較為苛刻，只能統(tǒng)計出文本格式文件的代碼行數(shù)，將空格、空行、注釋等信息視為正常代碼行，不能準確體現(xiàn)開發(fā)者的真實工作量。

3、 統(tǒng)計信息的期間為：自配置庫提交入文件開始至統(tǒng)計的最后時間。統(tǒng)計信息累計疊加。

也可以展現(xiàn)某人任意一個期間段的統(tǒng)計情況。

代碼統(tǒng)計系統(tǒng)安裝部署簡介

簡述：該系統(tǒng)分成： statcvs生成的統(tǒng)計頁面以及cvs后臺產生的日志信息。統(tǒng)計的網頁信息則由分析cvs生成的日志信息而來。

功能：按一定周期自動更新出每個配置庫的代碼量變化信息，并以網頁形式進行瀏覽，便于簡便快捷的獲取統(tǒng)計資料。

思路：

取得最新需要統(tǒng)計的cvs配置庫配置項資源——>生成log信息——>通過statcvs將信息分析并生成頁面

安裝部署：

IP:10.1.56.228 是為startcvs環(huán)境專用。

OS: L4U4-64

內存：2048M

硬盤：30G

JDK版本：jdk 1.6.0_22

Statcvs版本：0.7.0

statcvs.jar 文件在/opt/statcvs/ 目錄下

需要注意的問題：

我們用的是statcvs0.7.0，故需要配置的環(huán)境變量為jdk1.4.2以上版本。

由于statcvs所需的JDK對操作系統(tǒng)的內存有限制：

1、32位操作系統(tǒng)下,jdk調用的內存一般限制在1.5G-2G。32位XP系統(tǒng)下,jdk調用的內存不超過1400M。

2、 如果jdk調用的內存超過1500M,，則轉換到服務器IP地址為10.1.56.228的64位操作系統(tǒng)上進行。64位操作系統(tǒng)對jdk調用內存無限制。

主要命令語句：

cvs update -p -d -c更新路徑 （前提是需要checkout出相應路徑）

cvs log -d '2002-01-01<2002-12-31' > xxx.log 生成從2002-01-01到2002-12-31之間的日志文件

java -jar statcvs.jar -output-dir [path save HTML results] [log file path] [path to chekout cvs module]

例：

$java -jar /opt/statcvs/statcvs.jar -output-dir /home/zhangjianzhi/test1 /home/zhangjianzhi/test/cvs.log ./

java -jar -mx800m statcvs.jar -output-dir [path save HTML results] [log file path] [path to chekout cvs module]

例：

$java -jar -mx800m /opt/statcvs/statcvs.jar -output-dir /home/zhangjianzhi/test1 ./cvs.log ./

查看代碼統(tǒng)計的輸出信息

在輸出的目錄文件中找到index.html，即代碼統(tǒng)計的主頁信息：包括最后統(tǒng)計時間、統(tǒng)計區(qū)間、文件總數(shù)、代碼行總數(shù)及開發(fā)人員總數(shù)，以及下列綜述信息。

主頁還包括以下視圖：Developers、Commit Logs、Lines of Code、File Statistics、Directory Sizes、Repo Heatmap、LOC and Churn、 Cloud Commit。這些視圖是從不同角度展現(xiàn)統(tǒng)計信息，每個視圖內容基本為信息重組，便于瀏覽者針對不同角度進行查看。

下面我們分別介紹一下，各個統(tǒng)計信息的詳細信息：

1、 Developers

如下圖所示：

該視圖以開發(fā)者為焦點，主頁體現(xiàn)了從項目從入庫時至統(tǒng)計時間止的一個完整代碼提交量的概況。分別點擊每個開發(fā)者，進入下一個頁面，則詳細展現(xiàn)了每位開發(fā)人員的工作量情況。頁面如下圖：

生成的日提交情況圖及周提交情況圖均為截至統(tǒng)計日的最近一次提交量及最近一周情況。橫軸為時間，縱軸為代碼行數(shù)量。

2、 Commit Logs

如下圖所示：

該視圖以月為單位，展現(xiàn)每個月開發(fā)者對文件提交的詳細信息，但未有代碼行的累計統(tǒng)計。

左側是月份選擇，可根據(jù)實際需要，直接選擇查看該月情況。

3、 Lines of Code

如下圖所示：

該視圖反映了代碼量提交的整體情況，橫軸為日期，縱軸為代碼行數(shù)量。

4、 File Statistics

如下圖所示：

該視圖展現(xiàn)以文件為焦點，分析了提交情況。橫軸為日期，縱軸為文件數(shù)量。展現(xiàn)了文件提交隨日期的增加變化。

5、 Directory Sizes

如下圖所示：

該視圖展現(xiàn)了以目錄為焦點，分析了每個目錄下文件的代碼行變化情況。其中圖表的橫軸為日期，縱軸為目錄的代碼行數(shù)，體現(xiàn)了不同目錄隨著時間的變化代碼行數(shù)也隨之變化。

6、 Repo Heatmap

瀏覽該視圖需要安裝jre-6u7-windows-i586-p-iftw.exe進行支持。該視圖以地圖的方式進行瀏覽，可以方便的展示最近一個月的提交情況。綠色為文件增加行數(shù)，紅色為減少行數(shù)。鼠標移動過去即可看到詳細信息情況。

7、 LOC and Churn

如下圖所示：

該視圖宏觀展現(xiàn)了代碼行與代碼行變動隨著時間變化的趨勢，該圖表，橫軸為日期，左縱軸為代碼行，右縱軸為變動行數(shù)。

8、 Cloud Commit