注意:本文都是window系統(tǒng)實踐的
一、下載并搭建ant環(huán)境(使用Ant前提條件,系統(tǒng)中已經(jīng)安裝JDK)
1、下載 ant:進入官網(wǎng),選擇 Download 下的 Binary Distributions ,然后選擇對應(yīng)版本(1.10.2 .zip archive 對應(yīng)jdk8,1.9.10 .zip archive 對應(yīng)jdk7)下載,然后直接解壓
2、配置Ant環(huán)境變量:右鍵計算機屬性 --> 高級系統(tǒng)設(shè)置 --> 系統(tǒng)屬性 --> 高級 --> 環(huán)境變量 --> 添加如下的系統(tǒng)變量:
變量名:【ANT_HOME】,變量值:【D:\Program Files\ant\apache-ant-1.9.0】(也就是ANT的安裝路徑,寫自己實際的安裝路徑就行,得是絕對路徑)
變量名:【PATH】,變量值:【 ;%ANT_HOME%bin;】
可以參考這篇博客
二、整理jar包
1、在 jmeter 的 .\JMeter\apache-jmeter-3.2\Extras 目錄下找到 ant-jmeter-1.1.1.jar 文件,將它復制到 ant 的 \lib 目錄下
2、在網(wǎng)站上下載commons-email.jar包,然后放在 ant 的 \lib 目錄下
3、在網(wǎng)站上下載activation-1.1.1.jar包,然后放在 ant 的 \lib 目錄下
4、在網(wǎng)站上下載javax.mail.jar包,然后放在 ant 的 \lib 目錄下
三、修改 jmeter 的配置文件
打開 jmeter 的 bin 目錄,找到 jmeter 的配置文件(jmeter.properties),做如下修改:把輸出的默認存儲模式改為xml,也就是把 jmeter.save.saveservices .output_format = csv 改為 jmeter.save.saveservices .output_format = xml
四、編寫 build.xml文件:
腳本流程:執(zhí)行測試腳本 ——> 生成測試報告(xml)——> 自動發(fā)送郵件
在 .\JMeter\apache-jmeter-3.2\extras 這個目錄下有 build.xml 文件,但是需要我們進行調(diào)整,才能定制信息
<?xml version="1.0" encoding="UTF8"?>
<project name="ant-jmeter" default="all" basedir=".">
<property name="jmeterPath" value="D:/Soft/JMeter/apache-jmeter-3.2"/>
<property name="mail_host" value="smtp.qq.com"/>
<property name="mail_port" value="465"/>
<property name="username" value="填寫發(fā)件人的郵箱地址"/>
<property name="password" value="如果使用QQ需要先在QQ郵箱設(shè)置里開啟smtp服務(wù),會獲得一個授權(quán)碼,此處填寫那個授權(quán)碼"/>
<property name="mail_from" value="填寫發(fā)件人的郵箱地址"/>
<property name="mail_to" value="填寫接收郵件人的郵箱地址"/>
<property name="mailsubject" value="填寫郵件主題"/>
<property name="message" value="填寫郵件正文內(nèi)容"/>
<tstamp><format property="time" pattern="yyyyMMddhhmm" /></tstamp>
<!-- jmeter環(huán)境配置 -->
<property name="jmeter.home" value="${jmeterPath}"/>
<!-- jtl測試結(jié)果存放路徑 -->
<property name="jmeter.result.jtl.dir" value="D:/interfaceTestSuite/TestReport/jtl"/>
<!-- html測試結(jié)果存放路徑 -->
<property name="jmeter.result.html.dir" value="D:/interfaceTestSuite/TestReport/html"/>
<property name="htmlReportNameSummary" value="TestReport"/>
<property name="jmeter.result.jtlName" value="${jmeter.result.jtl.dir}/${htmlReportNameSummary}${time}.jtl"/>
<property name="jmeter.result.htmlName" value="${jmeter.result.html.dir}/${htmlReportNameSummary}${time}.html"/>
<target name="all">
<antcall target="test"/>
<antcall target="report"/>
<antcall target="sendEmail"/>
</target>
<!-- 執(zhí)行接口測試 -->
<target name="test">
<echo>執(zhí)行接口自動化測試用例</echo>
<taskdef name="jmeter" classname="org.programmerplanet.ant.taskdefs.jmeter.JMeterTask" />
<jmeter jmeterhome="${jmeter.home}" resultlog="${jmeter.result.jtlName}">
<testplans dir="D:/interfaceTestSuite/Scripts" includes="填寫運行的腳本,"*.jmx"指運行此目錄下的所有jmeter腳本" />
<property name="jmeter.save.saveservice.output_format" value="xml" />
</jmeter>
</target>
<!-- 解決報告中NAN字段顯示問題-->
<path id="xslt.classpath">
<fileset dir="${jmeter.home}/lib" includes="xalan-2.7.2.jar" />
<fileset dir="${jmeter.home}/lib" includes="serializer-2.7.2.jar" />
</path>
<target name="report">
<echo>生成接口自動化測試報告</echo>
<tstamp> <format property="report.datestamp" pattern="yyyy/MM/dd HH:mm" /></tstamp>
<xslt classpathref="xslt.classpath" force="true"
in="${jmeter.result.jtlName}" out="${jmeter.result.htmlName}"
style = "${jmeter.home}/extras/jmeter-results-detail-report_21.xsl" >
<param name="titleReport" expression="${mailsubject}${time}"/>
<param name="dateReport" expression="${report.datestamp}"/>
</xslt>
<!-- 因為上面生成報告的時候,不會將相關(guān)的圖片也一起拷貝至目標目錄,所以,需要手動拷貝 -->
<copy file="${jmeter.home}/extras/expand.png" tofile="${jmeter.result.html.dir}/expand.png" />
<copy file="${jmeter.home}/extras/collapse.png" tofile="${jmeter.result.html.dir}/collapse.png" />
</target>
<target name="sendEmail">
<echo>發(fā)送測試報告</echo>
<mail mailhost="${mail_host}"
ssl="true"
user="${username}"
password="${password}"
mailport="${mail_port}"
subject="${mailsubject}"
messagemimetype="text/html"
tolist="${mail_to}" >
<from address="${mail_from}" />
<attachments>
<fileset dir="${jmeter.result.html.dir}">
<include name="${htmlReportNameSummary}${time}.html" />
<include name="collapse.png" />
<include name="expand.png" />
</fileset>
</attachments>
<message>
${message}
</message>
</mail>
</target>
</project>
五、執(zhí)行
cmd 中(就是在命令終端里)進入build.xml存放的路徑,然后輸入ant回車執(zhí)行即可,完成之后可以在build.xml中設(shè)置的路徑中找到html格式的測試報告
六、問題解決
以下列舉的是實操過程中,筆者遇到過的部分問題,如果有遇到其他怪異的問題,可以在評論區(qū)留言一起交流一下
1、運行報錯:fileset doesn't support the nested "includes" element
2、發(fā)送郵件報錯:java.lang.ClassNotFoundException: javax.mail.internet.MimeMessage
報這個錯可能就是因為缺少第二步里面的一些jar包
3、html測試報告左上角顯示“dateReport:date not defined”
4、郵件老是報錯: Failed to send email: Unknown SMTP host: {mail_host}
百度了老半天,也沒找到為什么,又是ping,又是tracert的,都沒有問題,最后發(fā)現(xiàn),是我少寫了一個“$”符,導致取不到配置信息:七、如何把ant+jmeter與jenkins結(jié)合起來
有兩種方法:
方法一:
構(gòu)建項目后,在構(gòu)建步驟里選擇execute Windows batch ..:然后在此處填寫cmd里實際使用的命令即可
構(gòu)建后操作選擇publish html reports:目錄記得用/。Index page處使用正則表達式:*.html(獲取所有html文件)
然后執(zhí)行即可
方法二:
構(gòu)建項目后,在構(gòu)建步驟里選擇invoke ant——>ant version:default,build file:存放build.xml文件的路徑
然后執(zhí)行即可
八、在jenkins里如何查看性能測試報告
在構(gòu)建后步驟里選擇publish performance test result report:數(shù)據(jù)路徑用正則表示:*/.jtl(如果寫具體的路徑,可能會報拒絕訪問的錯誤)