Jmeter+Ant+Jenkins接口自动化框架
最近应公司要求，搭建一套接口自动化环境。看到通知邮件，没有多想就确定了Jmeter路线。可能有些人会
说，为啥不用python，相对而言高大上一些。因为公司内部现在项目有用到Jmeter，正好可以结合利用，适合自
己才是最好的嘛。整体思路是Jmeter可以做压力测试，也可以做接口测试；Ant是基于Java的构建工具，完成脚
本执行收集结果并生成报告；Jenkins也是基于Java开发的持续集成工具。
JDK安装
下载安装包，解压到安装目录，本次用的是jdk1.8版本。
下载地址：//www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html
设置环境变量
JAVA_HOME:D:\jdk\jdk1.8.0_20_64 Path:%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin CLASSPATH:.;%JAVA_HOME%lib;%JAVA_HOME%lib\tools.jar（注意最前面的.）
安装结果验证
在命令行窗口输入 java -version 然后回车，出现对应的jdk版本即为安装成功。
Jmeter安装
下载安装包，解压到自己电脑的安装目录，鉴于之前有人说找不到老版本下载地址，借此贴出来。
最新版本下载：//jmeter.apache.org/download_jmeter.cgi
历史版本下载：//archive.apache.org/dist/jmeter/binaries/
设置环境变量
JMETER_HOME:D:\apache-jmeter-3.1 CLASSPATH:%JMETER_HOME%\lib\ext\ApacheJMeter_core.jar;%JMETER_HOME%\lib\jorphan.jar; Path:%JMETER_HOME%\bin
安装结果验证
在命令行窗口输入 jmeter -v 然后回车，出现对应的版本即为安装成功，我这里用的是自己安装的命令行工具。
Ant安装
下载安装包，解压到安装目录。本次使用的是1.10.8版本，大家可以根据需要选择。
下载地址：//ant.apache.org/bindownload.cgi
设置环境变量
ANT_HOME:D:\apache-ant-1.10.8 CLASSPATH:%ANT_HOME%\lib; PATH:%ANT_HOME%\bin;
安装结果验证
在命令行窗口输入 ant -v 然后回车，出现对应安装版本即为成功。
本地调试使用ant构建运行jmeter脚本
配置运行文件
将jmeter>>>extras目录下的 ant-jmeter-1.1.1.jar 文件拷贝到ant安装目录下的lib文件夹中，这样Ant运行
时才能找到”org.programmerplanet.ant.taskdefs.jmeter.JMeterTask“这个类，从而成功触发JMeter脚本。
配置报告输出格式
jmeter默认保存的是csv格式的文件，我们要将其改为xml格式。在jmeter的bin目录下找到jmeter.properties并
编辑，这里建议大家用vsCode或者Notepad打开。
配置编译文件
在ant的安装目录下，新建build.xml文件，然后修改文件内容。注意：在jmeter的extras目录下也有个
build.xml文件，不要修改成这个文件。ant目录下这个文件是需要你自己新建并修改的。下面给出一份
推荐build内容供参考，主要修改里面的jmeter版本、指定报告路径以及运行脚本路径。
<?xml version="1.0" encoding="UTF-8"?> <project name="ant-jmeter-test" default="run" basedir="."> <tstamp> <format property="time" pattern="yyyyMMddhhmm" /> </tstamp> <property name="basedirectory" value="D:\Jmeter\apache-jmeter-5.2.1\extras" /> <!-- 需要改成自己本地的 Jmeter 目录--> <property name="jmeter.home" value="D:\Jmeter\apache-jmeter-5.2.1" /> <!-- jmeter生成jtl格式的结果报告的路径--> <property name="jmeter.result.jtl.dir" value="D:\autotest\result\jtl" /> <!-- jmeter生成html格式的结果报告的路径--> <property name="jmeter.result.html.dir" value="D:\autotest\result\html" /> <!-- Name of test (without .jmx) --> <property name="test" value="Test"/> <!-- 生成的报告的前缀--> <property name="ReportName" value="TestReport" /> <!--property name="jmeter.result.jtlName" value="${jmeter.result.jtl.dir}/${time}.jtl" /> <property name="jmeter.result.htmlName" value="${jmeter.result.html.dir}/${time}.html" /--> <property name="jmeter.result.jtlName" value="${jmeter.result.jtl.dir}/${time}.jtl"/> <property name="jmeter.result.htmlName" value="${jmeter.result.html.dir}/DetailReport${time}.html"/> <property name="jmeter.result.htmlName2" value="${jmeter.result.html.dir}/SummaryReport${time}.html"/> <path id="xslt.classpath"> <fileset dir="${jmeter.home}/lib" includes="xalan*.jar"/> <fileset dir="${jmeter.home}/lib" includes="serializer*.jar"/> </path> <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:\autotest\script" includes="*.jmx" /> </jmeter> </target> <target name="report"> <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.shanhe.me.xsl"> <param name="reportDate" expression="${report.datestamp}"/> </xslt> <xslt classpathref="xslt.classpath" force="true" in="${jmeter.result.jtlName}" out="${jmeter.result.htmlName2}" style="${jmeter.home}/extras/jmeter-results-detail-report_21.xsl"> <param name="showData" expression="${show-data}"/> <param name="titleReport" expression="${ReportName}${time}"/> <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>
执行测试并查看结果
在build.xml所在目录(我这里就是ant的安装目录)打开命令行窗口，输入 ant 然后回车，执行成功
会出现如下所示内容。
打开build.xml文件中指定的结果存放路径，查看是否生成了html和jtl文件。
优化测试报告
由于jmeter原始的测试报告信息不太符合项目需要，我对报告模板做了简单修改，大家可以根据
实际情况再次调整。
下载地址：//pan.baidu.com/s/1TwCe9cPgxmr55NUN4zWeKA
提取码：g8wc
下载完成，将文件放入jmeter extras目录下，打开build.xml文件，设置文件路径。
打开jmeter.properties文件，设置测试报告的输出内容，将需要的结果置为true并去掉#。
配置Jenkins构建持续集成
下载安装Jenkins，本文不做详细介绍，大家可自行百度。
下载地址：//jenkins.io/zh/download/，安装完成配置环境变量 JENKINS_HOME:D:\Jenkins
Jenkins服务默认端口为8080，如果出现端口冲突，可在Jenkins安装目录jenkins.xml文件中修改。
配置JDK和Ant环境
在浏览器中输入：//127.0.0.1:8585，进入Jenkins主页，配置用户名、密码和插件。根据项目需要，我这里
需要安装HTML Publisher Plugin和Ant Plugin。在Manage Jenkins>>>Manage Plugin中搜索这两个插件并安装，
然后在Manage Jenkins>>>Global Tool Configuration中配置JDK和Ant的工作路径。
配置工作项目
在Jenkins主页点击New Item，输入项目名称，选择Freestyle project，点击ok会进入到项目配置页面。因
为我已经建好了项目，这里会提示项目名称已存在，项目名称建议大家用英文。
进入到项目配置页面，我们目前需要修改一些配置。Discard old builds(丢弃旧的构建)：为了避免多余
的构建日志、临时文件占磁盘空间，需要定期的清除过期文件。我这里配置保留5天内的构建文件，保
持最大构建个数不限。
Build Triggers(构建触发器)用来设置定时任务，其语法是由“* * * * *”构成，中间空格隔开。
第一颗*表示分钟，取值0~59
第二颗*表示小时，取值0~23
第三颗*表示一个月的第几天，取值1~31
第四颗*表示第几月，取值1~12
第五颗*表示一周中的第几天，取值0~7，其中0和7代表的都是周日
Build模块需要增加Invoke Ant，其中Ant Version的值要与上面在Jenkins中设置名称一致；Build File
填写我们新建的build.xml文件所在的路径。
Post-build Actions(构建后操作)目前先配置一下报告存放路径，此路径要与build.xml文件中报告存放
路径一致，否则无法在Jenkins中查看测试报告，Report title默认不做更改。
写在最后的话
至此，一套简单的接口自动化框架搭起来了，期间也踩了很多坑。由于技术能力有限，这个框架
扩展功能还在研究中，有实用的功能后续再做补充。
