一.ANT下载
1.http://ant.apache.org/bindownload.cgi
二.ANT配置环境变量
1.新建系统变量ANT_HOME:输入ant安装的路径
2.在path变量中添加:%ANT_HOME%\bin
3.将Jmeter\extras文件夹内的ant-jmeter-1.1.1.jar复制到ant\lib文件夹内
3.1.这样ant运行时才能找到org.programmerplanet.ant.taskdefs.jmeter.JMeterTask这个类,才触发Jmeter脚本
三.修改Jmeter中的配置文件
1.将jemter文件夹内bin目录下的jmeter.properties中修改为:jmeter.save.saveservice.output_format=xml,并去掉前面的#号
五.Jmeter文件夹内新建demo文件夹并新建build.xml文件和配置文件内容
1.build.xml文件内容:在文件内,需要执行的脚本路径下面必须加这句
<property name="jmeter.save.saveservice.output_format" value="xml"/>
1.1.如果不加上这句,生成的.jtl文件是文本文件,而不是xml文件,使用xsl去转换.jtl文件时就会报错
<?xml version="1.0" encoding="utf8"?>
<project name="ant-jmeter-test" default="run" basedir=".">
<!-- QQ邮箱smtp-->
<!--property name="mail_host" value="smtp.qq.com"/>
<property name="mail_port" value="465"/>
<!填写发件人的邮箱地址>
<!property name="username" value="https://mail.qq.com/cgi-bin/frame_html?sid=uy9hXz1EPpK_XEQZ;r=d408c71f6a152f16d16a8d0a144fa1e6"/>
<! 如果使用QQ需要先在QQ邮箱设置里开启smtp服务,会获得一个授权码,此处填写那个授权码-->
<!--property name="password" value="ieaipwkjijhmbjjd"/>
<!填写发件人的邮箱地址-->
<!--property name="mail_from" value="413950612@qq.com"/>
<!填写接收邮件人的邮箱地址-->
<!--property name="mail_to" value="413950612@qq.com"/>
<!填写邮件主题-->
<!--property name="mailsubject" value="接口测试报告"/>
<!填写邮件正文内容-->
<!--property name="message" value="接口测试报告分析说明"/-->
<tstamp>
<format property="reporttime" pattern="yyyyMMddhhmm" />
<!--format property="date" pattern="yyyy/MM/dd kk:mm:ss"/-->
<!--kk是24小时制,KK是12小时制-->
</tstamp>
<!--需要改成自己本地的 Jmeter 目录-->
<property name="jmeter.home" value="D:\Jmeter\apache-jmeter-3.0" />
<property name="report.title" value="接口测试自动化报告"/>
<property name="ComputerName" value="DESKTOP-PV3IKSG"/>
<!-- jmeter生成jtl格式的结果报告的路径-->
<!--property name="jmeter.result.jtl.dir" value="D:\Jmeter\apache-jmeter-3.0\demo\report\jtl" /-->
<!-- jenkins生成jtl格式的结果报告的路径-->
<property name="jmeter.result.jtl.dir" value="D:\Jenkins\workspace\Jmeter接口测试\jtl" />
<!-- jmeter生成html格式的结果报告的路径-->
<!--property name="jmeter.result.html.dir" value="D:\Jmeter\apache-jmeter-3.0\demo\report\html" /-->
<!-- jenkins生成html格式的结果报告的路径-->
<property name="jmeter.result.html.dir" value="D:\Jenkins\workspace\Jmeter接口测试\html" />
<!-- 生成的报告的前缀:ReportName是报告名字,reporttime是时间戳-->
<property name="ReportName" value="DetailsReport" />
<!--property name="jmeter.result.jtlName" value="${jmeter.result.jtl.dir}/${ReportName}${reporttime}.jtl" />
<property name="jmeter.result.htmlName" value="${jmeter.result.html.dir}/${ReportName}${reporttime}.html" /-->
<property name="jmeter.result.jtlName" value="${jmeter.result.jtl.dir}/${ReportName}.jtl" />
<property name="jmeter.result.htmlName" value="${jmeter.result.html.dir}/${ReportName}.html" />
<!--jtl的value值是D:\Jenkins\jmxReport\jtl\TestReport+yyyyMMddhhmm.jtl-->
<!--html的value值是D:\Jenkins\jmxReport\html\TestReport+yyyyMMddhhmm.html-->
<!-- 生成的详细报告的前缀:ReportName是报告名字,reporttime是时间戳-->
<property name="ReportName2" value="SummaryReport" />
<!--property name="jmeter.result.jtlName" value="${jmeter.result.jtl.dir}/${ReportName}${reporttime}.jtl" />
<property name="jmeter.result.htmlName2" value="${jmeter.result.html.dir}/${ReportName2}${reporttime}.html" /-->
<property name="jmeter.result.jtlName" value="${jmeter.result.jtl.dir}/${ReportName2}.jtl" />
<property name="jmeter.result.htmlName2" value="${jmeter.result.html.dir}/${ReportName2}.html" />
<!--项目初始化设置-->
<target name="init" description="init" >
<!--删除jtl文件夹下生成的所有文件及文件夹包括空目录,但不删除根目录-->
<delete verbose="true" includeemptydirs="true" >
<fileset dir="${jmeter.result.jtl.dir}" >
<include name="**/*" />
</fileset>
</delete>
<!--删除html文件夹下生成的所有文件及文件夹包括空目录,但不删除根目录-->
<delete>
<fileset dir="${jmeter.result.html.dir}">
<include name="**/*"/>
</fileset>
</delete>
<!--<delete dir="${classes.home}"/>
<mkdir dir="${classes.home}"/>-->
</target>
<!--jenkins构建里面的Invoke Ant中的targets-->
<target name="run">
<antcall target="test" />
<antcall target="report" />
<!--antcall target="sendEmail"/-->
</target>
<!-- 执行接口测试 -->
<target name="test">
<taskdef name="jmeter" classname="org.programmerplanet.ant.taskdefs.jmeter.JMeterTask" />
<jmeter jmeterhome="${jmeter.home}" resultlog="${jmeter.result.jtlName}">
<!-- 声明要运行的脚本"*.jmx"指包含此目录下的所有jmeter脚本-->
<testplans dir="D:\Jmeter\apache-jmeter-3.0\demo" includes="获取上海天气.jmx" />
<!-- 不加上下面这一句,生成的.jtl文件是文本文件不是xml文件,使用xsl去转换.jtl文件时就会报错 -->
<property name="jmeter.save.saveservice.output_format" value="xml"/>
</jmeter>
<!--下面是在增加的一行与上面一致的但是文件夹不一样的,就执行多个目录的jmx脚本-->
<!--jmeter jmeterhome="${jmeter.home}" resultlog="${jmeter.result.jtlName}">
<!声明要运行的脚本"*.jmx"指包含此目录下的所有jmeter脚本>
<!testplans dir="D:\Jmeter\apache-jmeter-3.0\demo2" includes="*.jmx" />
<property name="jmeter.save.saveservice.output_format" value="xml"/>
<!/jmeter-->
</target>
<!-- html报告中时间显示为NAN,原因是ant中缺失了两个lib库 xalan-2.7.2.jar和serializer-2.7.2.jar ,将这两个库拷贝到ant的lib目录下,或者在这里增加如下代码均可解决-->
<path id="xslt.classpath">
<fileset dir="${jmeter.home}/lib" includes="xalan*.jar"/>
<fileset dir="${jmeter.home}/lib" includes="serializer*.jar"/>
</path>
<!-- html报告中Date report这里的时间没有正确显示出来,原因是未设定report.datestamp 属性值-->
<target name="report">
<tstamp>
<format property="report.datestamp" pattern="yyyy-MM-dd HH:mm:ss" />
</tstamp>
<!-- 注释的也是一种生成报告的方式与下面的一样,只是一个是xsl,一个是21.xsl-->
<!-- <xslt in="${jmeter.result.jtlName}" out="${jmeter.result.htmlName}" style="${jmeter.home}/extras/jmeter.results.shanhe.me.xsl" /> -->
<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="dateReport" expression="${report.datestamp}"/>
<param name="titleReport" expression="${mailsubject}${time}"/>
<param name="showData" expression="${show-data}"/>
<param name="titleReport" expression="${report.title}"/>
</xslt>
<!--用于生成第二种详细的测试报告-->
<xslt
classpathref="xslt.classpath"
force="true"
in="${jmeter.result.jtlName}"
out="${jmeter.result.htmlName2}"
style="${jmeter.home}/extras/jmeter.results.shanhe.me.xsl" >
<param name="dateReport" expression="${report.datestamp}"/>
<param name="showData" expression="${show-data}"/>
<param name="titleReport" expression="${detailreport.title}"/>
<param name="titleReport" expression="${mailsubject}${time}"/>
</xslt>
<!--因为上面生成报告的时候,不会将相关的图片也一起拷贝至目标目录,所以,需要手动拷贝 -->
<copy todir="${jmeter.result.html.dir}">
<fileset dir="${jmeter.home}/extras">
<include name="collapse.png" />
<include name="expand.png" />
</fileset>
</copy>
<!--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>
<path id="lib_classpath">
<fileset dir="${basedir}/">
<include name="mail*.jar" />
<include name="activation*.jar" />
<include name="commons-email*.jar" />
<include name="ant-contrib*.jar" />
</fileset>
</path>
<!-- 发送邮件 -->
<!--target name="sendEmail">
<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>
六.ANT运行集成测试
1.命令窗口cmd进入脚本目录:D:\Jmeter\apache-jmeter-3.0\demo后输入ant
2.运行时如果遇到报错的情况:the jmeter type doesn't support nested text data
2.1.因为build.xml文件中存在编码不同的字符
2.2.解决办法:打开build.xml文件保存为与当前系统一致的编码,一般为ANSI或者utf-8这两种
七.生成测试报告
1.测试报告路径:D:\Jmeter\demo\report\html文件夹
2.生成的测试报告有问题
2.1.Date report的时间没有显示出来
2.2.Summary的字段MinTime和MaxTime显示的是NaN,没有显示正确的时间
3.解决问题:Date report的时间没有显示出来
3.1.把jmeter\lib文件夹内xalan.jar和serializer.jar文件复制到ant的lib文件夹内
3.2.在Jmeter\extras文件夹内或者在Jmeter\demo文件夹内的build.xml文件内容新增下面内容
3.2.1.它的作用就是把生成的.jtl数据文件转换为.html格式的报告
4.查看Jmeter\extras文件夹内是否有【jmeter-results-detail-report_21.xsl】样式模板,测试报告是根据其样式来生成的
5.打开jmeter-results-detail-report_21.xsl文件内容
5.1.在其中定义三个参数和在Jmeter\extras文件夹内或者在Jmeter\demo文件夹内的build.xml文件中一样
6.解决问题:Summary的字段Min Time和Max Time显示的是NaN,没有显示正确的时间
6.1.把第1个问题的代码复制到Jmeter\demo文件夹内的build.xml文件,可以一并解决这两个问题
6.2.但是解决第二个问题的关键是在代码里的加上如下两行
6.3.此时两个问题都解决,最终修改后的Jmeter\demo文件夹内的build.xml文件
6.3.1.其中标黄是解决两个问题时候添加的代码
<?xml version="1.0" encoding="UTF-8"?>
<project name="ant-jmeter-test" default="run" basedir=".">
<tstamp>
<format property="time" pattern="yyyyMMddhhmm" />
</tstamp>
<!-- 需要改成自己本地的 Jmeter 目录-->
<property name="jmeter.home" value="D:\Jmeter\apache-jmeter-3.0" />
<!-- jmeter生成jtl格式的结果报告的路径-->
<property name="jmeter.result.jtl.dir" value="D:\Jmeter\apache-jmeter-3.0\demo\report\jtl" />
<!-- jmeter生成html格式的结果报告的路径-->
<property name="jmeter.result.html.dir" value="D:\Jmeter\apache-jmeter-3.0\demo\report\html" />
<!-- 生成的报告的前缀-->
<property name="ReportName" value="TestReport" />
<property name="jmeter.result.jtlName" value="${jmeter.result.jtl.dir}/${ReportName}${time}.jtl" />
<property name="jmeter.result.htmlName" value="${jmeter.result.html.dir}/${ReportName}${time}.html" />
<target name="run">
<antcall target="test" />
<antcall target="report" />
</target>
<target name="test">
<taskdef name="jmeter" classname="org.programmerplanet.ant.taskdefs.jmeter.JMeterTask" />
<jmeter jmeterhome="${jmeter.home}" resultlog="${jmeter.result.jtlName}">
<!-- 声明要运行的脚本。"*.jmx"指包含此目录下的所有jmeter脚本-->
<testplans dir="D:\Jmeter\apache-jmeter-3.0\demo" includes="abc.jmx" />
<property name="jmeter.save.saveservice.output_format" value="xml"/>
</jmeter>
</target>
<path id="xslt.classpath">
<fileset dir="${jmeter.home}/lib" includes="xalan*.jar"/>
<fileset dir="${jmeter.home}/lib" includes="serializer*.jar"/>
</path>
<target name="report">
<!-- <xslt in="${jmeter.result.jtlName}" out="${jmeter.result.htmlName}" style="${jmeter.home}/extras/jmeter.results.shanhe.me.xsl" /> -->
<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="dateReport" expression="${report.datestamp}"/>
</xslt>
<!-- 因为上面生成报告的时候,不会将相关的图片也一起拷贝至目标目录,所以,需要手动拷贝 -->
<copy todir="${jmeter.result.html.dir}">
<fileset dir="${jmeter.home}/extras">
<include name="collapse.png" />
<include name="expand.png" />
</fileset>
</copy>
</target>
</project>
八. 测试报告优化
1.下载优化模板jmeter.results.shanhe.me.xsl,并拷贝到jmeter\extras文件夹中
2.在jmeter\bin文件夹内找到文件jmeter.properties
2.1.设置需要输出的内容为true,并去掉前面的注释符号#,这里全部设置成true
3.设置Jmeter\demo文件夹内的build.xml文件内容为优化后的模板:【jmeter.results.shanhe.me.xsl】
九.发送邮件:由于Ant目前的版本不支持javamail
1.因此发送邮件只能使用Jenkins自带的发送邮件插件来发送报告
2.Jmeter\demo文件夹内的build.xml文件内容是包括发送邮件的配置
3.但是ant发送邮件需要依赖4个包,分别是:activation.jar和mail.jar,commons-email-1.2.jar,javax.mail.jar,放在ant\lib文件夹内