SnoarQube8.1版本安装及相关使用说明

SnoarQube基本介绍

SonarQube是管理代码质量一个开放平台，可以快速的定位代码中潜在的或者明显的错误，下面将会介绍一下这个工具的安装、配置以及使用。涉及SnoarQube，SonarScanner，ECLIPSE。
1.官网下载地址：
https://www.sonarqube.org/downloads/
2.8.1版本百度云下载地址：
https://pan.baidu.com/s/1MNdyMxFMl4DaPtG4n7KqYg
提取码：zkkd

1.SnoarQube基本安装及配置

1.1前置条件

1.JAVA环境 Snoar 8.1版本要求JDK版本在11以上。
2.数据库环境配置。SnoarQube在7.9版本之后，放弃对mysql的支持（详情看官方说明），数据库选择ORACLE，SQLSERVE，PostgreSQL。创建数据库之后，配置对应的用户即可。

1.2安装及基本配置

1.下载解压之后，首先要配置环境变量：
添加系统变量：SONAR_HOME [例：D:\sonarqube\sonarqube-8.1.0.31237]
环境变量path添加：%SONAR_HOME%\bin。
2.这次针对ORACLE数据库来说明。数据库创建用户-xxxxx，记录用户名及密码。打开SnoarQube路径下/conf/sonar.properties 配置数据库信息:内容如下

sonar.jdbc.username=sonarqube #用户名
sonar.jdbc.password=sonarqube #密码
sonar.jdbc.url=jdbc:oracle:thin:@127.0.0.1:1521/database #地址及实例名
sonar.sorceEncoding=utf-8 #编码方式
sonar.web.host=0.0.0.0 
sonar.web.context=
sonar.web.port=9000 #用来访问时的地址

这边有几个注意点，
1.使用oracle数据库时，不会自动下载对应的数据库jar包，需要自行下载，然后放到…/extensions/jdbc-driver/oracle 路径下，之前有测试过，旧版本的ojdbc.jar无法使用。可以使用以下jar包：
oracle 提取码：gfng
2.创建数据库时，要注意编码，务必选择UTF-8模式。否则后面启动时会报编码错误，导致无法连接数据库。
3.如果之前有用旧版本的SnoarQube连接过数据库，推荐重建一个数据库进行连接。本人有试过，去连接会报错，启动失败。删除相关的表也无效。创建另外一个用户也无效。附上oracle安装包
oracle安装包提取码:t669.

1.3启动及相关报错说明

1.启动.选择…\bin\windows-x86-64\StartSonar.bat进行启动。启动如果失败，在
…\logs\sonar.log 中可以看到相关的日志。启动成功界面：
启动之后可以访问对应的地址： http://ip:端口号/ 可以看到以下界面（针对8.1版本）：
2.部分报错日志说明：
日志1：

WrapperSimpleApp: Encountered an error running main: 
java.nio.file.FileSystemException: 另一个程序正在使用此文件，进程无法访问。

第一次启动正常，关闭之后，第二次再启动下报错。
处理方式：由于启动之后再关闭，不会自动关闭进程，所以需要手动关闭java进程。关闭之后即可正常启动。
日志2：

 WrapperSimpleApp: 
 Encountered an error running main: java.lang.IllegalStateException:
 SonarQube requires Java 11 to run
 java.lang.IllegalStateException: SonarQube requires Java 11 to run

原因：这个即为之前提到java版本问题。8.1版本需要的JDK版本为11.两种处理方式：
1.安装jdk11，修改环境变量JAVA_HOME的路径。
2.安装jdk11，在配置文件…\conf\wrapper.conf 中添加
wrapper.java.command=.jdk路径/bin/java

1.4中文插件下载

两种方式：
1.登陆官网进行下载。
2.登陆启动后的到扩展中进行下载。

END

SonarScanner基本介绍

代码扫描工具，配合SonarQube使用，扫描代码之后生成报告。
1.官网下载地址：
https://docs.sonarqube.org/latest/analysis/scan/sonarscanner/
2.4.2版本百度云下载地址：
链接：https://pan.baidu.com/s/1bVSZ3yB8Hm3NcUiaBIQZ7g
提取码：yado

1.SonarScanner基本安装及配置

1.下载并解压到目标文件夹
2.配置环境变量 path中添加路径 …\bin ，
3.在cmd检查安装是否成功 sonar-scanner version

4.在文件中添加配置…\conf\sonar-scanner.properties

sonar.host.url=http://localhost:9000//SonarQube地址
sonar.sourceEncoding=GBK //代码编码方式
sonar.jdbc.url=jdbc:oracle:thin:@127.0.0.1:1521/database //数据库地址及服务名
sonar.jdbc.username=sonarqube //数据库用户名
sonar.jdbc.password=sonarqube //数据库地址
sonar.login=admin   //SonarQube用户名
sonar.password=admin  //SonarQube密码

2.1.scanner针对java项目的使用方法

1.在java项目的根目录下创建sonar-project.properties文件。

sonar.projectKey=eemr_svc //在SnoarQube中的key
sonar.projectName=eemr_svc  //显示的项目名称
sonar.projectVersion=1.0 
sonar.sources=src //java代码位置
sonar.projectBaseDir=.
sonar.java.binaries=bin //class文件位置
sonar.language=java //
sonar.sourceEncoding=GBK //编码方式

2.控制台进入根目录下 执行 sonar-scanner -e 效果如下：

执行成功之后，可以登陆SonarQube页面查看分析的结果。

3.1.eclipse关联SonarQube使用方式

1.eclipse 下载插件SonarLint
待续…