***(官方說明在這邊(https://docs.sonarqube.org/latest/setup/get-started-2-minutes/)***

# 安裝下載
1. 官方[下載位置](https://www.sonarqube.org/success-download-community-edition/)

2. 解壓縮在本機電腦上的任意位置

3. [下載Plugin](https://github.com/cnescatlab/sonar-cnes-report)(出report用的套件)，同樣解壓縮在電腦上的任意位置

這個是community版本的report工具
目前GIT上版本為 4.1.2 對應到 SonarQube版本 8.9.9(long-term supported)

要以這個套件可支援的版本下載Sonar才有用，不然最後不能產報表就GG摟
若無法對應到相對應版本的，就只能用cmd指令去執行plugin


4. [下載JDK](https://jdk.java.net/archive/)版本(11版以後皆可)
***可於windows OS中設定系統變數，([連結](https://www.java.com/zh-TW/download/help/path_zh-tw.html))***

# 執行
1. 進入 SonarQube解壓縮的資料夾內，點選 bin\windows-x86-64\StartSonar.bat
***需要自行設定java path或是設定windows系統變數***

2. 執行後，可透過http://localhost:9000/projects 預設帳密(admin/admin)進入GUI

# 設定掃描專案
1. 點選 manual 後 輸入專案名稱
2. 選擇locally開始建立專案

3. 設定專案token，後續在執行或是plugin時會用到

4. 依據專案類型選擇對應的套件(以.net專案為範例)

5. 下載對應的.net套件

6. 一樣把它解壓縮到你想要的路徑 ，***<font color="red">這次路徑一定要記好</font>***

7. 將掃描工具加入系統的環境路徑

8. 把 .netframe的 building 軟體加入系統環境中

跟 上一步驟一模一樣，差別在於要把最後輸入的那個視窗中 再加入一筆 
C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\MSBuild\15.0\Bin


9. 透過Admin權限開啟CMD

10. 將CMD路徑移至，SonarQube的專案路徑

11. 回到 http://localhost:9000 的畫面，按照他說的指令輸入進 cmd

12. 等待執行時間結束後，GUI畫面會變成完成狀態

# 產製Report

若Plugin與主程式版本有對應到可在下方位置找到功能

## 透過cmd方式執行plugin
1. 進入到plugin的資料夾內

2. 製作一個bat檔案，內容如下

#要將 -t 後方替換成專案對應的token ， -p 替換成專案名稱
D:\Code\JAVA\JDK\jdk-17.0.2\bin\java -jar .\sonar-cnes-report-4.2.0.jar -t 43962cebae9cdf441db2b41e32b591d5c88ced6c -p "FDIS-1016-2" -r ./template.docx


3. 直接點兩下bat檔案即可執行，也可透過cmd去執行該bat檔案