1.Android JUnit Runner(使用AndroidStudio)

Posted

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了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 |
current

指定用户运行,如果不指定则使用当前用户运行
–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命令传入将覆盖清单指定参数

以上是关于1.Android JUnit Runner(使用AndroidStudio)的主要内容,如果未能解决你的问题,请参考以下文章

Junit 的 @RunWith():Runner,即Junit的运行器

将 JUnit Hooks 与 Cucumber CLI Runner 一起使用

java.lang.NoClassDefFoundError: org/junit/runner/manipulation/Filter

在 IDEA 中使用 JUnit Runner 时找不到 Spring Profile

junit源码之Runner

idea com.intellij.junit4.JUnit4TestRunnerUtil$5 overrides final method getRunner.()Lorg/junit/runner