接口自动化-步骤、遇到的问题及解决方法(jmeter、ant、cmd)
一、 安装包准备
JDK:jdk1.8.0_91
Ant:apache-ant-1.10.1
Jmeter:apache-jmeter-3.0(还需要下载jmeter的两个插件JMeterPlugins-Extras-1.4.0和JMeterPlugins-Standard-1.4.0)
Jenkins:jenkins-1.651.1
二、 安装JDK
安装时,一直点下一步就可以,也可以选择自己想安装的目录进行安装。
1、配置JAVA_HOME变量:
桌面右键计算机=>属性=>高级系统设置=>环境变量=>系统变量=>新建
变量名为JAVA_HOME 变量值填写jdk安装路径,如果安装多个jdk版本,在此处写哪个路径就可直接变更jdk版本
2、系统变量=>Path,双击打开编辑
在变量值最后输入 %JAVA_HOME%\bin;%JAVA_HOME%\jre\bin;
注意,所有变量值之间都必须有英文分号;隔开
3、系统变量=>新建CLASSPATH变量,若有则直接编辑
变量值:.;%JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar
注意:最前面有一个英文句号“.”。
4、打开命令行,输入java-version,会打印出当前JDK的版本号
三、 安装Jmeter
1、 直接解压Jmeter压缩包,就算安装成功了
2、Jmeter插件的安装。
解压JMeterPlugins-Extras-1.4.0.zip、JMeterPlugins-Standard-1.4.0.zip,将两个文件夹lib\ext目录下的所有文件拷贝到apache-jmeter-3.2\lib\ext目录下;
3、配置Jmeter环境变量
1)新建系统变量,变量名称:JMETER_HOME,变量值:E:\application20160314\apache-jmeter-3.2(Jmeter本地安装路径)
2)在系统变量中Path中添加%JMETER_HOME%\bin
3)打开命令行,输入jmeter-v,打印出jmeter版本号表示安装成功(若是命令行不支持,则使用别的工具,如Xshell)
四、 安装Ant
1、直接解压apache-ant-1.10.1-bin.zip到想要的目录,就算安装成功了
2、 配置Ant环境变量
- 新建系统变量:ANT_HOME,变量值为Ant的本地安装路径,如我的:E:\application20160314\apache-ant-1.10.1
- 在系统变量Path后添加%ANT_HOME%\bin
3)打开命令行,输入ant-version,打印出ant版本号表示配置成功(若是命令行不支持,则使用别的工具,如Xshell)
3、 本地调试使用ant构建运行Jmeter,并且生成jtl、html格式报告
3.1 jmeter默认保存的是.csv格式文件,因此需要把默认的进行修改,找到bin/jmeter.properties文件,修改jmeter.save.saveservice.output_format=xml,需要把前面的注释符去掉
3.2 将apache-jmeter-3.2\extras\ant-jmeter-1.1.1.jar拷贝到apache-ant-1.10.1\lib目录下
3.3 在Xshell或命令行,先进入\apache-jmeter-3.2\extras目录,运行ant.bat-file build.xml -Dtest=Test, 查看\apache-jmeter-2.13\extras目录下是否出现Test.jtl、Test.html文件,若有,则构建成功。
注意:
到这里出问题了,一直构建失败,提示jtl文件不存在(xxx.Jtl does not exist),尝试了很多方法,都不行,最后到网上找了一个范例,把build.xml文件整个给改了,然后终于成功了,步骤如下:
1)在本地创建一个存放report的目录;
2)把build.xml和样式文件jmeter-results-detail-report_21.xsl(这个需要自己上网找正确的,不然样式会错)都放入该目录下;
3)自己本地有专门存放脚本的目录,每次要运行哪个目录的脚本,需要去修改build.xml文件脚本文件目录;
4)修改build.xml,代码如下;
5)命令行或者别的工具,进入自己创建的report目录后(由于是自己创建了一个报告生成文件夹的路径,修改了build.xml和jmeter.results.shanhe.me.xsl,所以路径要定位到:E:\application20160314\apache-jmeter-3.2\exportResult才能生效),这里有个小技巧:按住Shift+鼠标右键,可以选择在当前目录打开cmd。
执行ant.bat -file build.xml -Dtest=脚本文件名(Jmeter保存的*.jmx文件名,不需要后缀),发现就能在这个目录生成jtl和html文件了。
附上我的build.xml代码,注意第一行必须顶格,不然会报错:
<?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="E:\application20160314\apache-jmeter-3.2\exportResult" />
<!-- 本地存放脚本的路径-->
<property name="scriptdirectory" value="E:\application20160314\apache-jmeter-3.2\bin" />
<!-- 需要改成自己本地的 Jmeter 目录-->
<property name="jmeter.home" value="E:\application20160314\apache-jmeter-3.2" />
<!-- jmeter生成jtl格式的结果报告的路径-->
<property name="jmeter.result.jtl.dir" value="${basedirectory}" />
<!-- jmeter生成html格式的结果报告的路径-->
<property name="jmeter.result.html.dir" value="${basedirectory}" />
<!-- 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}/${test}${time}.jtl" />
<property name="jmeter.result.htmlName" value="${jmeter.result.html.dir}/${test}${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="${scriptdirectory}" includes="${test}.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="${basedirectory}/jmeter.results.shanhe.me.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>
上面代码中,同一个测试脚本生成的报告名一样,假如想每次报告名都不一样,可以把报告名后缀前加上${time}
五、配置测试报告样式
之前配置的样式,报告中只有错误多少,没有错误的详细信息,因此把样式进行优化
1、下载样式文件jmeter.results.shanhe.me.xsl ,并把该文件放入正确目录下,我这里是放到我创建的report目录下
2、修改jmeter.properties文件如下部分,我这里基本上都修改成true,这样执行完脚本后就会保存这些结果到.jtl文件里面
jmeter.save.saveservice.data_type=true
jmeter.save.saveservice.label=true
jmeter.save.saveservice.response_code=true
# response_data is not currently supported for CSV output
jmeter.save.saveservice.response_data=true
# Save ResponseData for failed samples
jmeter.save.saveservice.response_data.on_error=false
jmeter.save.saveservice.response_message=true
jmeter.save.saveservice.successful=true
jmeter.save.saveservice.thread_name=true
jmeter.save.saveservice.time=true
jmeter.save.saveservice.subresults=true
jmeter.save.saveservice.assertions=true
jmeter.save.saveservice.latency=true
jmeter.save.saveservice.connect_time=true
jmeter.save.saveservice.samplerData=true
jmeter.save.saveservice.responseHeaders=true
jmeter.save.saveservice.requestHeaders=true
jmeter.save.saveservice.encoding=false
jmeter.save.saveservice.bytes=true
jmeter.save.saveservice.url=true
jmeter.save.saveservice.filename=true
jmeter.save.saveservice.hostname=true
jmeter.save.saveservice.thread_counts=true
jmeter.save.saveservice.sample_count=true
jmeter.save.saveservice.idle_time=true