SonarQube介绍及部署

编写人:罗旭成

编写时间:2014-5-28

 

SonarQube简介

SonarQube是一个用于代码质量管理的开源平台(Java开发),用于管理源代码的质量,可以从七个维度检测代码质量,通过插件形式,可以支持包括Java,C#,C/C++,PHP,PL/SQL,Cobol,Web,XML,JavaScrip,Groovy等等二十几种编程语言的代码质量管理与检测。

SonarQube能带来什么?

1.糟糕的复杂度分布

文件、类、方法等,如果复杂度过高将难以改变,这会使得开发人员难以理解它们,且如果没有自动化的单元测试,对于程序中的任何组件的改变都将可能导致需要全面的回归测试。

2.重复

显然程序中包含大量复制粘贴的代码是质量低下的, SonarQube可以展示源码中重复严重程度。

 

3.缺乏单元测试

SonarQube可以很方便地统计并展示单元测试覆盖率。

4.没有代码标准

     SonarQube可以通过PMD,CheckStyle,Findbugs等等代码规则检测工具规范代码编写。

5.没有足够的或者过多的注释

    没有注释将使代码可读性变差,特别是当不可避免地出现人员变动时,程序的可读性将大幅下降,而过多的注释又会使得开发人员将精力过多地花费在阅读注释上,亦违背初衷。

6.潜在的bug

     SonarQube可以通过PMD,CheckStyle,Findbugs等等代码规则检测工具检测出潜在的Bug。

7.糟糕的设计(原文Spaghetti Design,意大利面式设计)

    通过SonarQube可以找出循环,展示包与包、类与类之间的相互依赖关系,可以检测自定义的架构规则,通过SonarQube可以管理第三方的Jar包,可以利用LCOM4检测单个任务规则的应用情况,检测耦合。

 

SonarQube部署说明

(以C#源码为例)

第一步:安装SonarQube

1. 准备好JAVA环境(Java6.0)。

2. 准备好MySQL环境(可用默认的数据库derby,配置文件全部不用做修改)。

3. 下载最新的SonarQube,(下载网址为:http://www.sonarqube.org/)解压到目录C:\app\sonarqube-4.3(当前为最新版)。

4. 修改配置文件C:\app\ sonarqube-4.3\conf\sonar.properties:

复制代码

#数据库用户名

sonar.jdbc.username=root

#数据库密码

sonar.jdbc.password=root

#数据库地址

sonar.jdbc.url:jdbc:mysql://localhost:3306/sonar?useUnicode=true&characterEncoding=utf8&rewriteBatchedStatements=true

#数据库驱动

sonar.jdbc.driverClassName:com.mysql.jdbc.Driver

 

#数据库相关配置

sonar.jdbc.maxActive=20

sonar.jdbc.maxIdle=5

sonar.jdbc.minIdle=2

sonar.jdbc.maxWait=5000

sonar.jdbc.minEvictableIdleTimeMillis=600000

sonar.jdbc.timeBetweenEvictionRunsMillis=30000

复制代码

5. 执行C:\app\sonar-3.6\bin\windows-x86-64\StartSonar.bat(操作系统为windows xp),启动自带的JETTY服务器。打开http://localhost:9000,如果显示SonarQube主页,则SonarQube安装成功.

安装成功后的效果:

6. 安装中文插件和其它语言插件:将插件JAR包放到目录C:\app\ sonarqube-4.3\extensions\plugins,重启服务即安装成功。

    

7. 数据库会自动创建表结构(MySQL):

注:默认的配置可以不作修改,直接可连接上,连的默认数据库为derby。

第二步:安装SONAR-RUNNER

1. 下载sonar-runner,解压到目录C:\app\sonar-runner-2.4

2. 修改配置文件C:\app\sonar-runner-2.4\conf\sonar-runner.properties:

复制代码

#sonar访问地址

sonar.host.url=http://localhost:9000

#连接数据库地址

sonar.jdbc.url=jdbc:mysql://localhost:3306/sonar?useUnicode=true&characterEncoding=utf8

#数据库的用户名

sonar.jdbc.username=root

#数据库的密码

sonar.jdbc.password=root

#sonar的字符集

sonar.sourceEncoding=zh_CN

#sonar的登录用户

sonar.login=admin

#sonar的登录密码

sonar.password=admin

复制代码

3. 添加系统环境变量:SONAR_RUNNER_HOME 值为 C:\app\sonar-runner-2.4。

4. 修改环境变量Path,在变量值末尾添加:“;%SONAR_RUNNER_HOME%\bin”。

5. 命令行里执行 sonar-runner -h 如果显示如下内容,则安装成功。

复制代码

C:\app\sonar-runner-2.4

INFO:

INFO: usage: sonar-runner [options]

INFO:

INFO: Options:

INFO:  -D,--define <arg>     Define property

INFO:  -e,--errors           Produce execution error messages

INFO:  -h,--help             Display help information

INFO:  -v,--version          Display version information

INFO:  -X,--debug            Produce execution debug output

复制代码

第三步:分析代码

1. 拷贝代码到C:\app\project

代码目录结构如图:

2. 添加C:\app\project\sonar-project.properties 内容如下 :

复制代码

#项目主键 需要唯一

sonar.projectKey=DataCollectionSolution

#项目版本

sonar.projectVersion=1.0

#项目名称

sonar.projectName=C# Project

 

#sonar的语言

sonar.language=cs

sonar.dotnet.key.generation.strategy=safe

sonar.sourceEncoding=UTF-8

 

#项目访问目录

sonar.sources=C:\\app\\project\\

sonar.fxcop.mode=skip

sonar.gendarme.mode=skip

sonar.gallio.mode=skip

sonar.ndeps.mode=skip

sonar.stylecop.mode=skip

复制代码

3 命令行里执行 cd C:\app\project 到项目根目录。

然后执行命令:sonar-runner,控制台会打印分析过程。当出现SUCCESS时,则分析成功。

复制代码

INFO: --------------------

INFO: EXECUTION SUCCESS

INFO: --------------------

Total time: 2:37.891s

Final Memory: 14M/449M

INFO: --------------------

复制代码

刷新网站,显示如下:

完成以上操作及配置成功。

 

 

官网:http://www.sonarqube.org/

示例:http://nemo.sonarsource.org/

文档&插件:http://docs.codehaus.org/

Posted in 介绍及安装说明.