為.NetCore應用加上程式碼品質分析
以下已.NetCore為例，簡單架設、運行，並紀錄過程
基本安裝/使用
１．有兩種架設方式
- 自行下載、設定、執行（需要Java JDK 11以上）
- 從Docker
２．下載完成後，執行 StartSonar.bat
３．若遇到找不到java之類的錯誤，設定環境變數也沒用時，可以試著從這邊指定路徑
４．打開網址 http://localhost:9000/，應該可以就可以看到SonarQube的網站啟動了
５．新增一個Project，並且保存好key
６．選擇程式語言
７．在要執行的裝置上安裝tool
dotnet tool install --global dotnet-sonarscanner
８．接著回到要分析的專案上，先啟動分析
dotnet sonarscanner begin /key:<ProjectKey> /name:<ProjectName> /d:sonar.key=<Key> /d:sonar.host.url=<Url>
９．執行要做的事情
dotnet build
dotnet test
１０．結束分析，開始上傳結果到SonarQube
dotnet sonarscanner end
１１．回到SonarQube，可以看到報告都呈現在上面了
加上Test Code Coverage
１．這邊使用 Coverlet 來產生測試涵蓋率的結果，先在要執行分析的環境安裝
dotnet tool install --global coverlet.console
２．需要產生報告的專案也需要加上nuget package
dotnet add package coverlet.msbuild
３．接著與上面第７步驟雷同，不過我們調整下指令
- /d:sonar.cs.opencover.reportsPaths - 指定report的路徑，多個檔案可以用逗號分隔
dotnet sonarscanner begin /k:"<ProkectKey>" /d:"sonar.host.url=<SonarUrl>" /d:sonar.login=<SonarKey> /d:sonar.cs.opencover.reportsPaths="<Project>.Tests/opencover.xml,<Project>.Tests.E2E/opencover.xml" /d:sonar.scm.provider=git
４．以及執行測試的指令
dotnet test /p:CollectCoverage=true /p:CoverletOutputFormat=opencover /p:CoverletOutput="opencover.xml"
５．其餘部分皆相同，接著只要再執行 dotnet sonarscanner end，就能在SonarQube上看到測試涵蓋率了
簡單筆記一下過程，省的下次要再花時間找指令
和步驟
2020/0420 補充
可以更改為中文語系
