1.Android JUnit Runner(使用AndroidStudio)
一、Android JUnit Runner介绍
1.Android JUnit Runner
1)是一个测试运行器,用于运行Junit3和Junit4的Android测试包
2)替换Instrumentation Test Runner(一个比较旧的测试运行器)
3)支持Instrumentation Test Runner所有特性,但又进行了扩展
4)保持了所有Instrumentation Test Runner的命令格式
2.继承关系
java.lang.Object
android.app.Instrumentation
android.support.test.runner.MonitoringInstrumentation
android.support.test.runner.AndroidJUnitRunner
二、Instrument测试命令
1.命令格式:
am instrument [-r] [-e <NAME> <VALUE>] [-p <FILE>] [-w] [--user <USER_ID>|CURRENT] [--no-window-animation] [--abi <ABI>] <COMPONENT> //COMPONENT:包名/运行Runner
- 运行所有测试用例命令的例子:
adb shell am instrument
-w com.testDemo.test/android.support.test.runner.AndroidJUnitRunner
2.测试命令
参数 |
说明 |
-r |
打印原始结果(如果不加测试结果信息会很少) 使用[-e perf true]生成原始输出性能度量 |
-e |
设置参数
为测试运行器常见的形式是: [-e [,…]] |
将profiling数据写入到文件中
注:需要先建立一个trace文件 |
|
-w |
等待测试完成(这是一个必需参数) |
–user |
|
指定用户运行,如果不指定则使用当前用户运行 |
–no-window-animation | 关掉窗口动画(相当于开场动画)再运行 |
–abi |
通过所选的ABI启动进程,选择支持的CPU架构
可以使用(adb shell getprop |
3.实例(使用Android Studio):
1)在github中搜索android-testing选中googlesamples/android-testing点进去,然后下载.zip压缩包
2)下载完成后进行解压,所有的依赖都在android-testing-master\ui\espresso\BasicSampleBundled\libs路径下
3)file–new–new project(等待工程创建完成)–app–java–[packageName右键]–new–java class
注:点开java后会有两个选项,上面的一个是apk代码,下面是测试代码,我们写测试用例一般都写在测试代码包内
4)复制android-testing-master\ui\espresso\BasicSampleBundled\libs目录下除android-support-v4.jar以外的全部文件到创建的工程的libs文件夹中
5)选中copy进去的所有文件右键—add as library—在弹出的提示窗口中选择app—OK
6)增加完成后可以切换到Android视图,在Gradle Scripts/build.gradle(Module:app)中进行查看,并且注释掉第一行*(注释的那一行表示它会把libs下面所有的jar包编译进去,因为我们已经手动把它添加进去了所以就不需要了),代码显示如下:
dependencies { //compile fileTree(include: ['*.jar'], dir: 'libs') testCompile 'junit:junit:4.12' compile 'com.android.support:appcompat-v7:23.1.1' compile 'com.android.support:design:23.1.1' compile files('C:/Users/xuzhonghui/AndroidStudioProjects/RunnerDemo/libs/espresso-contrib-2.2-release-no-dep.jar') compile files('C:/Users/xuzhonghui/AndroidStudioProjects/RunnerDemo/libs/espresso-core-2.2-release-no-dep.jar') compile files('C:/Users/xuzhonghui/AndroidStudioProjects/RunnerDemo/libs/espresso-idling-resource-2.2-release-no-dep.jar') compile files('C:/Users/xuzhonghui/AndroidStudioProjects/RunnerDemo/libs/espresso-intents-2.2-release-no-dep.jar') compile files('C:/Users/xuzhonghui/AndroidStudioProjects/RunnerDemo/libs/espresso-web-2.2-release-no-dep.jar') compile files('C:/Users/xuzhonghui/AndroidStudioProjects/RunnerDemo/libs/exposed-instrumentation-api-publish-0.3-release-no-dep.jar') compile files('C:/Users/xuzhonghui/AndroidStudioProjects/RunnerDemo/libs/guava-18.0.jar') compile files('C:/Users/xuzhonghui/AndroidStudioProjects/RunnerDemo/libs/hamcrest-core-1.3.jar') compile files('C:/Users/xuzhonghui/AndroidStudioProjects/RunnerDemo/libs/hamcrest-integration-1.3.jar') compile files('C:/Users/xuzhonghui/AndroidStudioProjects/RunnerDemo/libs/hamcrest-library-1.3.jar') compile files('C:/Users/xuzhonghui/AndroidStudioProjects/RunnerDemo/libs/javawriter-2.1.1.jar') compile files('C:/Users/xuzhonghui/AndroidStudioProjects/RunnerDemo/libs/javax.annotation-api-1.2.jar') compile files('C:/Users/xuzhonghui/AndroidStudioProjects/RunnerDemo/libs/javax.inject-1.jar') compile files('C:/Users/xuzhonghui/AndroidStudioProjects/RunnerDemo/libs/jsr305-2.0.1.jar') compile files('C:/Users/xuzhonghui/AndroidStudioProjects/RunnerDemo/libs/junit-4.12.jar') compile files('C:/Users/xuzhonghui/AndroidStudioProjects/RunnerDemo/libs/rules-0.3-release-no-dep.jar') compile files('C:/Users/xuzhonghui/AndroidStudioProjects/RunnerDemo/libs/runner-0.3-release-no-dep.jar') compile files('C:/Users/xuzhonghui/AndroidStudioProjects/RunnerDemo/libs/uiautomator-v18-2.1.1-release-no-dep.jar') }
5)点击导航栏Run—Edit Configurations…—点击弹出界面左上角的+号—Android Tests,配置参考下图
-
截图说明:
a.name可以自行设置
b.Target选项请根据实际情况设置,我这边是拿模拟器进行调试的
6)在Gradle Scripts/build.gradle(Module:app)文件的defalutConfig中增加调试器,增加后的代码显示如下:
android { compileSdkVersion 23 buildToolsVersion "23.0.2" defaultConfig { applicationId "com.example.xuzhonghui.runnerdemo" minSdkVersion 15 targetSdkVersion 23 versionCode 1 versionName "1.0" //引号中的内容为刚刚创建的运行器 testInstrumentationRunner"android.support.test.runner.AndroidJUnitRunner" } buildTypes { release { minifyEnabled false proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' } } }
7)至此,基本的配置完成了,然后在刚刚创建的类中写测试代码了,代码如下:
package com.example.xuzhonghui.runnerdemo; import android.app.Instrumentation; import android.support.test.InstrumentationRegistry; import android.support.test.runner.AndroidJUnit4; import android.support.test.uiautomator.UiDevice; import org.junit.Before; import org.junit.Test; import org.junit.runner.RunWith; //下面一行一定要的,就是指定哪个运行器运行 @RunWith(AndroidJUnit4.class) //测试用例 public class RunnerTest { //初始化设备 UiDevice device; @Before public void setip{ device=UiDevice.getInstance(InstrumentationRegistry.getInstrumentation()) } //用例1 @Test public void test1(){ device.pressMenu(); } //用例2 @Test public void test2(){ device.pressBack(); } //用例3 @Test public void test3(){ device.pressMenu(); } //用例4 @Test public void test4(){ device.pressBack(); } }
8)代码写好后需要重新配置一下运行器,配置图如下:
-
配置说明:
a.在Test中选中测试类,然后将刚刚写好测试代码的那个类添加进去,也就是标红的位置了
b.show device chooser Dialog表示弹出一个选择目标设备的对话框
9)然后运行即可
- 注意事项:
我第一次按照上述步骤运行的时候就出现了问题,具体原理暂时还没搞清楚,以后明白了补上,问题和解决方案请参考这里:http://blog.csdn.net/qq_26967883/article/details/50477071的第一条:Excution faild for task ‘:app:transformResourcesWithMergeJavaResForDebug’
4.Instrument命令简单使用
#列出手机中所有已安装的包,界面中可以看到刚刚使用Android Studio安装的包 adb shell pm list instrumentation #该命令中不打印详细日志,-e后面的参数是刚刚Android Studio中创建用例的<packageName>.<className> adb shell am instrument -w -e class com.example.xuzhonghui.runnerdemo.RunnerTest com.example.xuzhonghui.runnerdemo.test/android.support.test.runner.AndroidJUnitRunner #跟上一条命令相比,只是多了一个<-r>参数,是让他输出详细的运行日志,相当于eclipes调试uiautomator的时候输出的日志 adb shell am instrument -w -r -e class com.example.xuzhonghui.runnerdemo.RunnerTest com.example.xuzhonghui.runnerdemo.test/android.support.test.runner.AndroidJUnitRunner #跟上一条相比多了一个-p+file的参数,目的是为了将运行日志保存到.trace文件中。使用该命令要先在adb shell 模式下在设备中使用命令"touch runner.trace"创建一个自定义名称的.trace文件 adb shell am instrument -w -r -p /data/local/tmp/runner.trace -e class com.example.xuzhonghui.runnerdemo.RunnerTest com.example.xuzhonghui.runnerdemo.test/android.support.test.runner.AndroidJUnitRunner
三、Android JUnit Runner过滤与例子
1.过滤器
过滤参数 |
说明 |
-e testFile | 运行文件中指定的用例 |
-e package | 运行这个包中的所有用例 |
-e size [small|medium|large] | 运行注释Small/MediumTest/largeTest的用例 |
-e annotation | 运行指定注释的用例 |
-e notAnnotation | 运行不包含指定注释的用例 |
-e numShards | 将用例分割成不同的切片 |
-e shardIndex | 运行指定切片id的用例 |
2.例子
3.实例
1)首先修改一下上面使用Android Studio创建的用例代码,多加几个测试方法,我这里加了10个,都是按键信息,加完后记得先跑一次,把包push到手机中
#列出手机中所有已安装的包找到com.example.xuzhonghui.runnerdemo.test/android.support.test.runner.AndroidJUnitRunner就是我们使用Android创建并安装到手机中的包 adb shell pm list instrumentation #运行全部用例,没有日志信息 C:\Users\xuzhonghui>adb shell am instrument -w com.example.xuzhonghui.runnerdemo.test/android.support.test.runner.AndroidJUnitRunner #运行全部用例,有日志信息 C:\Users\xuzhonghui>adb shell am instrument -w -r com.example.xuzhonghui.runnerdemo.test/android.support.test.runner.AndroidJUnitRunner #运行指定类的用例(指定类=包名.类名) C:\Users\xuzhonghui>adb shell am instrument -w -r -r class com.example.xuzhonghui.runnerdemo.RunnerTest com.example.xuzhonghui.runnerdemo.test/android.support.test.runner.AndroidJUnitRunner #运行指定类中的某一条用例(在指定类后面加一个"#用例名") C:\Users\xuzhonghui>adb shell am instrument -w -r -r class com.example.xuzhonghui.runnerdemo.RunnerTest#test3 com.example.xuzhonghui.runnerdemo.test/android.support.test.runner.AndroidJUnitRunner #运行多个类的用例,运行前先在之前先在Android Studio中多创建一个类并复制几条用例进去方便(这里只演示两个类,多个类同理,加个逗号即可) C:\Users\xuzhonghui>adb shell am instrument -w -r -r class com.example.xuzhonghui.runnerdemo.RunnerTest,com.example.xuzhonghui.runnerdemo.RunnerTest2 com.example.xuzhonghui.runnerdemo.test/android.support.test.runner.AndroidJUnitRunner
创建一个.txt文档,文档内容如下图,然后使用命令”adb push F:\testFile.txt /data/local/tmp”将文档push到手机中
#运行刚刚.txt文件中指定的用例 adb shell am instrument -w -r -e testFile /data/local/tmp/testFile.txt com.example.xuzhonghui.runnerdemo.test/android.support.test.runner.AndroidJUnitRunner #运行com.example.xuzhonghui.runnerdemo包里的所有用例 adb shell am instrument -w -r -e package com.example.xuzhonghui.runnerdemo com.example.xuzhonghui.runnerdemo.test/android.support.test.runner.AndroidJUnitRunner
修改一下之前在Android Studio中创建的用例,增加几个注释,结果如下图(记得修改完后先在手机上运行一下):
#运行刚刚注释为small的用例 adb shell am instrument -w -r -e size small com.example.xuzhonghui.runnerdemo.test/android.support.test.runner.AndroidJUnitRunner #运行刚刚注释为medium的用例 adb shell am instrument -w -r -e size medium com.example.xuzhonghui.runnerdemo.test/android.support.test.runner.AndroidJUnitRunner #运行刚刚注释为large的用例 adb shell am instrument -w -r -e size large com.example.xuzhonghui.runnerdemo.test/android.support.test.runner.AndroidJUnitRunner
修改AndroidStudio中的用例,上一步中的smallText注释的Import找到注释方法的编写,然后根据这个自己来编写注释方法,编写好的方法如下图:
编写好后,按照上一步的方式将注释加入到用例中,修改好用例后记得先运行一次
#运行指定自定义注释SmokeAnnotation的用例(这里需要注意的是annotation后面的跟的是自己编写的注释的<包名>.<类名>) adb shell am instrument -w -r -e annotation com.example.xuzhonghui.runnerdemo.SmokeAnnotation com.example.xuzhonghui.runnerdemo.test/android.support.test.runner.AndroidJUnitRunner #运行除指定自定义注释SmokeAnnotation的所有其他用例 adb shell am instrument -w -r -e notAnnotation com.example.xuzhonghui.runnerdemo.SmokeAnnotation com.example.xuzhonghui.runnerdemo.test/android.support.test.runner.AndroidJUnitRunner
四、Android JUnit Runner参数
主要是用在白盒测试上的,而不是UiAutomator,有兴趣可以深入研究下
参数 | 说明 |
-e log true | 只在日志模式下运行
这个选项将加载和遍历所有测试的类和方法,但会绕过实际测试执行。用于快速获取信息要执行的测试的仪器命令 |
-e coverage true | 生成代码覆盖率
这需要一个EMMA的构建。默认情况下,代码覆盖率结果文件将被保存在/data//coverage.ec文件,除非有coverageFile标志 |
-e coverageFile | 指定代码覆盖率文件保存路径
-e coverageFile /sdcard/myFile.ec |
-e listener | 指定一个或多个RunListeners观察测试运行
-e listener com.foo.Listener,com.foo.Listener2 |
-e timeout_mse | 设置超时时间(单位:毫秒)将被应用到每一个测试
-e timeout_mec 5000 |
-e disableAnlytics true | 禁用谷歌分析 |
- 参数还可以在AndroidMainfest文件中进行指定
如何使用监听器:
实际使用过程中,只需在AndroidManifect清单文件中加入上面代码即可,实际使用参考下图
- 参数通过shell命令传入将覆盖清单指定参数
- 本文为博主学习笔记,未经博主允许不得转载
- 本文仅供交流学习,请勿用于非法途径
- 本文仅是个人意见,如有想法,欢迎交流