katalon系列十一：Katalon Studio在Jenkins持續集成

以下在WIN10上運行正常。
安裝准備：
一、安裝Katalon Studio
二、安裝Jenkins
三、獲取Katalon命令行運行命令：點擊工具欄的‘Build CMD’按鈕，選擇測試集以及其他選項；選好后點‘Generate Command’即可生成命令，注意生成的命令要去掉-noExit和-consoleLog，以便CI日志可以直接顯示在作業視圖上。我這里生成的例子：
katalon -runMode=console -projectPath="E:\work\code\katalon\research\research.prj" -reportFolder="Reports" -reportFileName="report" -retry=0 -testSuitePath="Test Suites/crf" -executionProfile="default" -browserType="Chrome"

 

配置Jenkins：
一、進入Jenkins點擊左上角的‘新建任務’，輸入任務名稱，選擇第一個‘構建一個自由風格的軟件項目’，點確定。

二、
1.構建環境中選中‘Delete workspace before build starts’，官方解釋原因為防止長久運行后毀壞項目文件夾；

2.構建中選擇‘執行Windows批處理命令’

輸入命令：
d:
cd D:\Program Files\Katalon_Studio_Windows_64-5.8.6
katalon -runMode=console -projectPath="E:\work\code\katalon\research\research.prj" -reportFolder="Reports" -reportFileName="report" -retry=0 -testSuitePath="Test Suites/crf" -executionProfile="default" -browserType="Chrome"
copy "E:\work\code\katalon\research\Reports\JUnit_Report.xml" "D:\Program Files (x86)\Jenkins\workspace\katalon\JUnit_Report.xml" /y

copy "D:\szh\katalon\research\Reports\report.html" "D:\Program Files (x86)\Jenkins\workspace\katalon-prdb\report.html" /y

第一行切換到d盤
第二行切換到Katalon安裝目錄
第三行為准備工作時准備的命令行語句
第四、五行是我集成了JUnit報告插件、HTML報告插件，但因為Jenkins運行后並沒有在當前任務空間生成運行報告，所以我手動把報告復制過來（下面會講到集成JUnit、HTML報告，如果你不需要的話第四、五行可以刪掉）

3.集成JUnit報告插件（首先你的Jenkins已經安裝了JUnit報告插件）
在‘構建后操作’中選擇‘Publish JUnit test result report’
‘測試報告（XML）’一欄輸入報告的路徑，你可以先按官方的推薦寫成這樣子：Reports\crf\*\JUnit_Report.xml；其中crf為測試集的名字。但是因為我運行后Jenkins的workspace並沒有生成報告，所以在上面第四行命令的時候，我將報告復制到了任務根目錄。

運行效果：

 

exit 0表示運行成功，其他情況：
0: the execution passed with no failed or error test case.
1: the execution has failed test cases.
2: the execution has error test cases.
3: the execution has failed test cases and error test cases.
4: the execution cannot start because of invalid arguments.

 

 

4.集成HTML

在Jenkins-系統管理-插件管理-可選插件，搜索 HTML Publisher plugin，並安裝。

之后在項目的設置中進行如下設置

再構建項目后，就有HTML報告了，其實這個報告就是Katalon項目中Report目錄下的html文件，只不過可以直接在Jenkins打開了，方便一點。不過我用Chrome瀏覽器打開有問題，用IE瀏覽器就OK。

 

 

后記——Jenkins日志亂碼：
Katalon用例中的備注，我是用的中文，在Jenkins日志中，全顯示成了亂碼，這是因為用例中的編碼是UTF-8，而WINDOWS上的Jenkins是GBK。你可以在Jenkins頂級目錄點系統管理--系統屬性，‘file.encoding’一欄看到Jenkins的編碼。

 

解決方法就是在Windows添加一個環境變量，名稱為：JAVA_TOOL_OPTIONS；值為：-Dfile.encoding=UTF-8

 

如果設置完重啟電腦后依然沒生效，試試升級一下JDK，或重新安裝，我的版本是jdk1.8.0_191

官方文檔：https://docs.katalon.com/katalon-studio/docs/jenkins-integration.html#publish-junit-reports

 

---------------------------------------------------------------------------------

關注微信公眾號即可在手機上查閱，並可接收更多測試分享~