SonarQube介绍及部署

新风花雪月

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/