安装Sonar
作为一个代码分析平台,Sonar由以下三部分构成:
- 一个数据库:存放配置信息和分析结果信息;
- 一个WEB服务器:发布应用,在线浏览、配置分析;
- 一个客户端:执行源代码分析。
数据库安装
在环境要求部分,已经罗列了Sonar支持的数据库类型。
如果只是做一个测试或Demo,你可以使用Sonar附带的H2或Derby。它们不需要任何安装。
如果使用其他数据,仅仅需要创建一个数据库或表空间,提供Sonar增删改查的数据库权限的帐号。表和索引将在Sonar第一次运行时创建。
笔者推荐使用MySQL数据库,推荐使用数据库编码为UTF-8。
安装Sonar应用
下载Sonar发布包,解压到本地磁盘路径下。
http://www.sonarsource.org/downloads/
1、配置数据库
一般我们不使用Sonar自带的内建数据库,因此数据更改Sonar发布程序的数据源。
在Sonar解压包下,编辑conf/sonar.properties文件,可以指定新的特定数据。该文件中所有注释掉的数据库连接模板都是支持的。只需要去除注释,更改为自己的数据库连接即可。同时将默认的自带数据库的链接注释掉。
一般需要配置以下属性
sonar.jdbc.url: 数据库连接地址
sonar.jdbc.driver: 驱动类
sonar.jdbc.user: 数据库用户名
sonar.jdbc.password: 密码
如果使用Oracle数据库,将JDBCDriver包,放在/extensions/jdbc-driver/oracle/.下。其他数据库的驱动包已经放在默认的路径下。
2、启动Sonar Server
Sonar应用默认监听9000端口。通过http://localhost:9000访问
可以在 conf/sonar.properties文件更改:
sonar.web.host : 192.0.0.1
sonar.web.port: 80
sonar.web.context: /sonar
执行下面脚本可以启动Sonar应用:
在Linux/Mac OS: bin/<YOUR OS>/sonar.sh start
在Windows: bin/windows-x86-32/StartSonar.bat
对于其他平台,参考 Installing on AIX, HPUX or Solaris
启动Sonar应用,后就可以通过浏览器访问Sonar的浏览页面了。这是内容是空的。
3、高级属性
在上面的建议安装中,注意:这样使用的Sonar的内置Web服务器。你可以将Sonar发布在其他服务器,如Tomcat上。
你还可以在Windows和Linux配置Sonar服务;你还可以通过代理运行Sonar。后续专门的章节讲述这些高级特性。
安装客户端
除了数据库和Web应用外,Sonar还有很重要的一部分客户端程序。客户端程序用于对具体的程序工具进行分析,不同的语言,不要的项目构建类型可以使用不同的客户端程序。
Sonar提供很多类型的客户端,可以根据项目构建类型选择最佳方案:
Sonar Runner: 推荐默认客户端,如果你不知道选择哪个分析你的项目就是使用它把。.
Maven: 如果项目Maven构建则推荐使用对于的Maven插件包;
Ant Task:如果项目Ant构建则推荐;.
CI Engine: 持续集成,请参考相关文档,笔者暂时不做翻译。文档地址Hudson/Jenkins plugin或 Bamboo plugin 或AnthillPro plugin. 注意:即便没有对应的插件,其他CI引擎也可使用。
在对应的详细章节中,将重点讲述各类型客户端的使用。
文档下载http://wenku.baidu.com/view/088e5b1b6edb6f1aff001fc0.html