7.1 使用junit-report生成报告
这个是参考网上的:http://www.xuebuyuan.com/2148574.html,经我个人验证是可行的方法,网上写的挺详细的,不过有些不太清楚明白的地方,鉴于网上说的有点迷茫,所以下面我再细化一下。
(1)下载junit-report包
这个包是我们生成报告的基础,所以先下载这个包,下载地址如下:https://github.com/jsankey/android-junit-report
(2)创建Robotium测试用例
创建好我们的Robotium测试用例,并且根据需要组织好测试用例。现在我们测试用例是针对众筹网的,只有一个登录测试用例,如图7.1.1所示:
图7.1.1准备好测试用例
(3)添加junit-report包到工程中
将刚刚下载的android-junit-report-1.5.8.jar包,添加到项目中。通过右击项目—>”Build path”à”Configure build path…”,在打开的对话框中“Libraries”à”Add External JARs…”,将包附加进来。
如图7.1.2所示:
图7.1.2 添加junit-report包
同时,选择“Order and Export”选项卡,将刚刚添加进来的包选择,单击“OK”按钮,完成包的添加。
(4)修改AndroidManifest.xml文件
修改AndroidManifest.xml文件如下,使用JUnitReportTestRunner运行测试用例。
将下面两句:
android:targetPackage="com.subject.zhongchou" />
修改成:
android:targetPackage="com.subject.zhongchou" />
(5)修改Run Configurations配置
当我们修改了xml文件后,还需要修改一下Run Configurations配置。右击项目,选择“Run as”à“Run Configurations…”,在打开的窗口中左侧的“Andriod JUnit Test”下选择要设置的项目,如“AllTests”。然后在右侧选择“Run all tests in the selected project or package”,单击“Instrumention runner”后面的下拉框,就可以看到我们在Xml文件中填写的“com.zutubi.android.junitreport.JUnitReportTestRunner”,然后单击“run”按钮,则测试用例就会在我们的测试机上运行起来。如图7.1.3所示:
图7.1.3 配置RunConfiguration
(6)查看测试报告
经过上面的配置,通过JUnitReportTestRunner运行测试用例后,会在手机上/data/data/com.subject.zhongchou/files下生成测试报告文件junit-report.xml。如果你用的是其他的App,则com.subject.zhongchou会不同,找到你自己的App名称即可。如图7.1.4所示:
图7.1.4 在手机上生成测试报告
注:用junit-report在手机上生成报告是有一个前提的,你的手机必须已经Root,并且给/data/data文件夹设置了777权限。否则我们无法将测试报告写到系统数据文件夹下,也没有办法查看文件。
(7)取出测试报告
测试用例是在手机上运行的,所以产生的测试也在手机中。虽然我们可以直接用手机查看报告,可是还是不如在电脑上查看的方便。现在我们在测试工程中创建文件夹“test-output”,使用下面的命令将测试报告拉取到这个文件夹中:
C:adb pull /data/data/com.subject.zhongchou/files/junit-report.xmlD: obotiumautotesthongChouDemo est-output
然后在打开测试报告文件,内容如下:
(8)总结
这个junit-report是官方提供的包,使用起来比较方便。但是测试机必须先root。测试报告是Xml格式的,不方便阅读,网上说在jenkins中任务构建完成后即可使用Publish JUnit test result report插件分析得出单元测试报告。由于时间问题,我还没有尝试一下jenkins能否分析,不过后面我们会有自己的办法分析xml报告。
7.2使用testuntils生成报告
Testunitils和junit-report类似,也是借助于第三方的包,产生测试报告的,除了产生的测试报告文件名为TEST-all.xml外,使用步骤和产生报告的路径也完全一样。怎么说这也是另一种方法,多学习一点儿也没有坏处的同,下面我们讲解一下这个方法。
(1)下载testuntils包
当然在使用第三方的包之前,要下载对应的包。Testuntils包的下载地址是:http://code.google.com/p/nbandroid-utils/
(2)创建Robotium测试用例
创建好我们的Robotium测试用例,并且根据需要组织好测试用例。同样我们使用上面创建的测试用例文件,结构如图7.1.1所示。
(3)添加Testuntils包到工程
将刚刚下载的testutils.jar包,添加到项目中。通过右击项目—>”Build path”à”Configure build path…”,在打开的对话框中“Libraries”à”Add External JARs…”,将包附加进来。
如图7.2.1所示:
图7.2.1 添加testutils包
同时,选择“Order and Export”选项卡,将刚刚添加进来的包选择,单击“OK”按钮,完成包的添加。
(4)修改AndroidManifest.xml配置
修改AndroidManifest.xml文件如下,使用testutils运行测试用例。
将下面两句:
android:targetPackage="com.subject.zhongchou" />
修改成:
android:targetPackage="com.subject.zhongchou" />
(5)修改Run Configurations配置
当我们修改了xml文件后,还需要修改一下Run Configurations配置。右击项目,选择“Run as”à“Run Configurations…”,在打开的窗口中左侧的“Andriod JUnit Test”下选择要设置的项目,如“AllTests”。然后在右侧选择“Run all tests in the selected project or package”,单击“Instrumention runner”后面的下拉框,就可以看到我们在Xml文件中填写的“com.neenbedankt.android.test.InstrumentationTestRunner”,然后单击“run”按钮,则测试用例就会在我们的测试机上运行起来。如图7.2.2所示:
图7.2.2 配置RunConfiguration
(6)查看测试报告
经过上面的配置,通过InstrumentationTestRunner运行测试用例后,会在手机上/data/data/com.subject.zhongchou/files下生成测试报告文件TEST-all.xml。如果你用的是其他的App,则com.subject.zhongchou会不同,找到你自己的App名称即可。如图7.2.3所示:
图7.2.3 在手机上生成测试报告
注:和junit-report一样,用Testuntils在手机上生成报告是有一个前提的,你的手机必须已经Root,并且给/data/data文件夹设置了777权限。否则我们无法将测试报告写到系统数据文件夹下,也没有办法查看文件。
(7)取出测试报告
测试用例是在手机上运行的,所以产生的测试也在手机中。虽然我们可以直接用手机查看报告,可是还是不如在电脑上查看的方便。现在我们在测试工程中创建文件夹“test-output”,使用下面的命令将测试报告拉取到这个文件夹中:
C:adb pull /data/data/com.subject.zhongchou/files/TEST-all.xmlD: obotiumautotesthongChouDemo est-output
然后在打开测试报告文件,内容如下:
(8)总结
Testuntils和Junit-report是完全一样的两个第三方包,只是生成的报告文件名不同,使用方法等都类似,它们之间的区别我没有深入去研究,不过使用这两个包都可以生成手机测试报告。
7.3 重写InstrumentationTestRunner类生成报告
由于Junit-report和testuntils生成的报告都是在系统目录/data/data下面,如果手机没有Root,是没有权限生成报告的。所以我在网上看到了另一种方法,重写InstrumentationTestRunner类把报告生成到手机卡上,参考博客(http://blog.csdn.net/hunterno4/article/details/14485663)。下面我们也讲述一下这种方法:
(1)编写测试用例
在我们执行测试用例之前,已经完成了测试用例工程和具体测试用例的编写,此时我们有公用的函数类和具体的测试用例文件,上面已经介绍过结构了,此处不再累述。
(2)编写InstrumentationTestRunner类
由于我们要重写InstrumentationTestRunner类,所以在我们的测试工程公共类中,如:/src/com/zhongchou/CommonFunctions路径下创建类文件InstrumentationTestRunner.java,内容如下:
import java.io.File;
import java.io.FileWriter;
import java.io.IOException;
import java.io.Writer;
import org.xmlpull.v1.XmlPullParserFactory;
import org.xmlpull.v1.XmlSerializer;
import android.content.Context;
import android.os.Bundle;
import android.os.Environment;
publicclass InstrumentationTestRunnerextends android.test.InstrumentationTestRunner {
private Writer mWriter;
private XmlSerializer mTestSuiteSerializer;
privatelongmTestStarted;
privatestaticfinal String JUNIT_XML_FILE = "TEST-all.xml";
@Override
publicvoidonStart() {
try{
FilefileRobo = new File(getTestResultDir(getTargetContext()));
if(!fileRobo.exists()){
fileRobo.mkdir();
}
if(isSDCardAvaliable()){
FileresultFile = new File(getTestResultDir(getTargetContext()),JUNIT_XML_FILE);
startJUnitOutput(new FileWriter(resultFile));
}else{
startJUnitOutput(new FileWriter(new File(getTargetContext().getFilesDir(), JUNIT_XML_FILE)));
}
}
catch(IOException e){
thrownewRuntimeException(e);
}
super.onStart();
}
void startJUnitOutput(Writer writer) {
try {
mWriter = writer;
mTestSuiteSerializer = newSerializer(mWriter);
mTestSuiteSerializer.startDocument(null, null);
mTestSuiteSerializer.startTag(null, "testsuites");
mTestSuiteSerializer.startTag(null, "testsuite");
} catch (Exception e) {
thrownewRuntimeException(e);
}
}
privatebooleanisSDCardAvaliable(){
return Environment.getExternalStorageState()
.equals(Environment.MEDIA_MOUNTED);
}
private String getTestResultDir(Context context){
StringpackageName = "/" + "robotium";
Stringfilepath = context.getCacheDir().getPath() + packageName;
if(android.os.Build.VERSION.SDK_INT < 8){
if(isSDCardAvaliable()){
filepath= Environment.getExternalStorageDirectory().getAbsolutePath()+packageName;
}
}else{
if(isSDCardAvaliable()){
filepath= Environment.getExternalStorageDirectory().getAbsolutePath()+packageName;
}
}
return filepath;
}
private XmlSerializer newSerializer(Writer writer) {
try {
XmlPullParserFactory pf =XmlPullParserFactory.newInstance();
XmlSerializer serializer =pf.newSerializer();
serializer.setOutput(writer);
return serializer;
} catch (Exception e) {
thrownewRuntimeException(e);
}
}
@Override
publicvoidsendStatus(int resultCode, Bundle results) {
super.sendStatus(resultCode, results);
switch (resultCode) {
caseREPORT_VALUE_RESULT_ERROR:
caseREPORT_VALUE_RESULT_FAILURE:
caseREPORT_VALUE_RESULT_OK:
try {
recordTestResult(resultCode,results);
} catch (IOException e) {
thrownewRuntimeException(e);
}
break;
caseREPORT_VALUE_RESULT_START:
recordTestStart(results);
default:
break;
}
}
void recordTestStart(Bundle results) {
mTestStarted = System.currentTimeMillis();
}
void recordTestResult(int resultCode, Bundle results) throws IOException {
float time = (System.currentTimeMillis() - mTestStarted) / 1000.0f;
String className = results.getString(REPORT_KEY_NAME_CLASS);
String testMethod = results.getString(REPORT_KEY_NAME_TEST);
String stack = results.getString(REPORT_KEY_STACK);
int current = results.getInt(REPORT_KEY_NUM_CURRENT);
int total = results.getInt(REPORT_KEY_NUM_TOTAL);
mTestSuiteSerializer.startTag(null, "testcase");
mTestSuiteSerializer.attribute(null, "classname",className);
mTestSuiteSerializer.attribute(null, "name",testMethod);
if (resultCode != REPORT_VALUE_RESULT_OK) {
mTestSuiteSerializer.startTag(null, "failure");
if (stack != null) {
String reason = stack.substring(0,stack.indexOf(' '));
String message = "";
int index = reason.indexOf(':');
if (index > -1) {
message =reason.substring(index+1);
reason =reason.substring(0, index);
}
mTestSuiteSerializer.attribute(null, "message",message);
mTestSuiteSerializer.attribute(null, "type",reason);
mTestSuiteSerializer.text(stack);
}
mTestSuiteSerializer.endTag(null, "failure");
} else {
mTestSuiteSerializer.attribute(null, "time",String.format("%.3f", time));
}
mTestSuiteSerializer.endTag(null, "testcase");
if (current == total) {
mTestSuiteSerializer.startTag(null, "system-out");
mTestSuiteSerializer.endTag(null, "system-out");
mTestSuiteSerializer.startTag(null, "system-err");
mTestSuiteSerializer.endTag(null, "system-err");
mTestSuiteSerializer.endTag(null, "testsuite");
mTestSuiteSerializer.flush();
}
}
@Override
publicvoidfinish(int resultCode, Bundle results) {
endTestSuites();
super.finish(resultCode, results);
}
void endTestSuites() {
try {
mTestSuiteSerializer.endTag(null, "testsuites");
mTestSuiteSerializer.endDocument();
mTestSuiteSerializer.flush();
mWriter.flush();
mWriter.close();
} catch (IOException e) {
thrownewRuntimeException(e);
}
}
}
代码是网上提供的,并且有相应的注释,在此就不讲解代码了。
(3)修改AndroidManifest.xml配置
修改AndroidManifest.xml文件如下,使用InstrumentationTestRunner运行测试用例。
将下面两句:
android:targetPackage="com.subject.zhongchou" />
修改成:
android:targetPackage="com.subject.zhongchou" />
(4)修改Run Configurations配置
当我们修改了xml文件后,还需要修改一下Run Configurations配置。右击项目,选择“Run as”à“Run Configurations…”,在打开的窗口中左侧的“Andriod JUnit Test”下选择要设置的项目,如“AllTests”。然后在右侧选择“Run all tests in the selected project or package”,单击“Instrumention runner”后面的下拉框,就可以看到我们在Xml文件中填写的“com.zhongchou.CommonFunctions.InstrumentationTestRunner”,然后单击“run”按钮,则测试用例就会在我们的测试机上运行起来。如图7.3.1所示:
图7.3.1 配置RunConfiguration
(5)查看测试报告
经过上面的配置,通过我们重写后的InstrumentationTestRunner运行测试用例,会在手机上/sdcard/robotuim/下生成测试报告文件TEST-all.xml。如图7.3.2所示:
图7.3.2 在手机上生成测试报告
注:和前面的两种方法不同,此方法生成的测试报告在手机卡上,所以不需要Root手机,以设置权限等操作。
(6)取出测试报告
测试用例是在手机上运行的,所以产生的测试也在手机中。虽然我们可以直接用手机查看报告,可是还是不如在电脑上查看的方便。现在我们在测试工程中创建文件夹“test-output”,使用下面的命令将测试报告拉取到这个文件夹中:
C:adbpull /sdcard/robotium/TEST-all.xml D: obotiumautotesthongChouDemo est-output
然后在打开测试报告文件,内容如下:
(7)总结
经过重写InstrumentationTestRunner后,我们可以定义测试报告保存的位置,不需要对手机进行root和对系统文件进行权限设置。相对来说限制条件少了一些儿,当然有现成的代码,我们也不需要修改什么,如果你的编码能力还可以,可以根据自己的需要,重写上面的类。