AndroidJUnitRunner过滤器与参数使用

最新推荐文章于 2026-06-21 08:48:58 发布
原创 最新推荐文章于 2026-06-21 08:48:58 发布 · 5.2k 阅读 · 1 ·
本内容遵循CC 4.0 BY-SA版权协议
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
标签
#测试
本文详细介绍了AndroidJUnitRunner的使用，包括如何通过-e参数运行特定的测试用例、过滤器、注解、切片等。还提供了各种运行测试的示例，如按类、按方法、按包、按注解筛选，并提到了代码覆盖率生成、监听器配置以及通过AndroidManifest文件设置参数等实践操作。

1.  AndroidJUnitRunner介绍

AndroidJUnitRunner类是一个JUnit测试运行器,允许运行JUnit 3或JUnit 4测试类在Android设备上,包括那些使用Espresso和UI Automator框架。

2.  AndroidJUnitRunner过滤器及参数

-e testFile <filePath> : 运行文件中指定的用例。

-e package <packageName>: 运行这个包中的所有用例。

-e size [small |medium| large]: 运行注解为SmallTest/MediumTest/LargeTest的用例。

-e annotation <annotation>: 运行指定注解的用例。

-e notAnnotation <annotation>: 运行不包含指定注解的用例。

-e numShards <num>: 将用例分割成不同的切片。

-e shardIndex <id>: 运行指定切片的用例。

-e debug true : 可以在代码中设置断点，通过此参数进行调试测试脚本。

-e log true: 只在日志模式下运行，将加载和遍历所有的测试类和方法，但会绕过实际的测试执行，用于快速获取通过instrumentation命令执行测试的信息。

-e coverage true: 生成代码覆盖率文件,这需要是一个集成了EMMA或JaCoCo的构建。 默认情况下，代码覆盖率结果文件将被保存在/data/data//files/coverage.ec文件，另外也可以自定义覆盖率结果文件的路径，e.g  -e coverageFile /sdcard/myFile.ec。

-e listener <runlistener>: 指定一个或者多个运行监听器观察测试运行，可用于定制测试报告，e.g. -e listener com.foo.Listener,com.foo.Listener2.

-e timeout_msec <int> :设置超时时间，将被应用到每一个测试，e.g.-e timeout_msec 5000.

-e disableAnalytics true: 禁用谷歌分析, 主要是用于谷歌进行收集数据.


3. 帮助示例

3.1 运行所有的用例： adb shell am instrument -w com.android.foo/android.support.test.runner.AndroidJUnitRunner

3.2 运行一个类中的所有用例： adb shell am instrument -w -e class com.android.foo.FooTest com.android.foo/android.support.test.runner.AndroidJUnitRunner

3.3 运行单个测试用例： 

db shell am instrument -w -e class com.android.foo.FooTest#testFoo com.android.foo/android.support.test.runner.AndroidJUnitRunner

3.4 运行多个类的所有用例：

adb shell am instrument -w -e class com.android.foo.FooTest,com.android.foo.TooTest com.android.foo/android.support.test.runner.AndroidJUnitRunner

3.5 运行所有测试用例除了指定的类：

adb shell am instrument -w -e notClass com.android.foo.FooTest com.android.foo/android.support.test.runner.AndroidJUnitRunner

3.6 运行所有测试除了指定的用例： adb shell am instrument -w -e notClass com.android.foo.FooTest#testFoo com.android.foo/android.support.test.runner.AndroidJUnitRunner

3.7 运行文件中的所列的用例：

adb shell am instrument -w -e testFile /sdcard/tmp/testFile.txt com.android.foo/com.android.test.runner.AndroidJUnitRunner

文件制定的格式为：com.android.foo.FooClaseName#testMethodName

3.8  运行JAVA包中的所有测试用例： adb shell am instrument -w -e package com.android.foo.bar com.android.foo/android.support.test.runner.AndroidJUnitRunner

3.9 运行指定测试切片的用例：adb shell am instrument -w -e numShards 4 -e shardIndex 1 com.android.foo/android.support.test.runner.AndroidJUnitRunner

3.10 运行指定注解的测试用例：adb shell am instrument -w -e annotation com.android.foo.MyAnnotation com.android.foo/android.support.test.runner.AndroidJUnitRunner。如果使用多个选项，则运行的用例为两者的交集，比如：“-e size large -e annotation com.android.foo.MyAnnotation”，将只运行同时含LargeTest和MyAnnotation注解的用例。

3.11 运行没有指定注解的用例：adb shell am instrument -w -e notAnnotation com.android.foo.MyAnnotation com.android.foo/android.support.test.runner.AndroidJUnitRunner，指定多个注解，用“,”隔开，e.g. adb shell am instrument -w -e notAnnotation com.android.foo.MyAnnotation,com.android.foo.AnotherAnnotation com.android.foo/android.support.test.runner.AndroidJUnitRunner

3.12 以上所有参数也可以通过<meta-data>标签配置在AndroidManifest文件，比如 <meta-data android:name="listener" android:value="com.foo.Listener"/>，通过shell命令传入的参数将覆盖AndroidManifest文件中配置的参数。

4. 工程实践

4.1 通过测试切片，运行测试：

测试用例：

@RunWith(AndroidJUnit4.class)
public class TestClass01 {
    public UiDevice mDevice;
    public Instrumentation instrumentation;

    @Before
    public void setUp(){
        instrumentation = InstrumentationRegistry.getInstrumentation();
        mDevice = UiDevice.getInstance(instrumentation);
    }

    @Test
    public void testCase01() throws IOException {
        //test code
    }


    @Test
    public void testCase02(){
        //test code
    }


    @Test
    public void testCase03(){
        //test code
    }

    @Test
    public void testCase04(){
        //test code
    }

}

执行测试：

am instrument -w -r -e numShards 4 -e shardIndex 1  com.test.tommyxie.hellouiautomator.test/android.support.test.runner.AndroidJUnitRunner

执行结果：


遇到的坑：

1. 切片数需要能被用例数整除，否则切片不成功，如下：

am instrument -w -r -e numShards 3 -e shardIndex 1  com.test.tommyxie.hellouiautomator.test/android.support.test.runner.AndroidJUnitRunner

。 

2. 切片的索引为从0开始算起，比如切片为4份，指定运行的索引为4时，将会执行所有用例：

am instrument -w -r -e numShards 4 -e shardIndex 4  com.test.tommyxie.hellouiautomator.test/android.support.test.runner.AndroidJUnitRunner 


rds 4 -e shardIndex 4  com.test.tommyxie.hellouiautomator.test/android.support*
INSTRUMENTATION_STATUS: numtests=4
INSTRUMENTATION_STATUS: stream=
com.test.tommyxie.hellouiautomator.TestClass01:
INSTRUMENTATION_STATUS: id=AndroidJUnitRunner
INSTRUMENTATION_STATUS: test=testCase01
INSTRUMENTATION_STATUS: class=com.test.tommyxie.hellouiautomator.TestClass01
INSTRUMENTATION_STATUS: current=1
INSTRUMENTATION_STATUS_CODE: 1
INSTRUMENTATION_STATUS: numtests=4
INSTRUMENTATION_STATUS: stream=.
INSTRUMENTATION_STATUS: id=AndroidJUnitRunner
INSTRUMENTATION_STATUS: test=testCase01
INSTRUMENTATION_STATUS: class=com.test.tommyxie.hellouiautomator.TestClass01
INSTRUMENTATION_STATUS: current=1
INSTRUMENTATION_STATUS_CODE: 0
INSTRUMENTATION_STATUS: numtests=4
INSTRUMENTATION_STATUS: stream=
INSTRUMENTATION_STATUS: id=AndroidJUnitRunner
INSTRUMENTATION_STATUS: test=testCase02
INSTRUMENTATION_STATUS: class=com.test.tommyxie.hellouiautomator.TestClass01
INSTRUMENTATION_STATUS: current=2
INSTRUMENTATION_STATUS_CODE: 1
INSTRUMENTATION_STATUS: numtests=4
INSTRUMENTATION_STATUS: stream=.
INSTRUMENTATION_STATUS: id=AndroidJUnitRunner
INSTRUMENTATION_STATUS: test=testCase02
INSTRUMENTATION_STATUS: class=com.test.tommyxie.hellouiautomator.TestClass01
INSTRUMENTATION_STATUS: current=2
INSTRUMENTATION_STATUS_CODE: 0
INSTRUMENTATION_STATUS: numtests=4
INSTRUMENTATION_STATUS: stream=
INSTRUMENTATION_STATUS: id=AndroidJUnitRunner
INSTRUMENTATION_STATUS: test=testCase03
INSTRUMENTATION_STATUS: class=com.test.tommyxie.hellouiautomator.TestClass01
INSTRUMENTATION_STATUS: current=3
INSTRUMENTATION_STATUS_CODE: 1
INSTRUMENTATION_STATUS: numtests=4
INSTRUMENTATION_STATUS: stream=.
INSTRUMENTATION_STATUS: id=AndroidJUnitRunner
INSTRUMENTATION_STATUS: test=testCase03
INSTRUMENTATION_STATUS: class=com.test.tommyxie.hellouiautomator.TestClass01
INSTRUMENTATION_STATUS: current=3
INSTRUMENTATION_STATUS_CODE: 0
INSTRUMENTATION_STATUS: numtests=4
INSTRUMENTATION_STATUS: stream=
INSTRUMENTATION_STATUS: id=AndroidJUnitRunner
INSTRUMENTATION_STATUS: test=testCase04
INSTRUMENTATION_STATUS: class=com.test.tommyxie.hellouiautomator.TestClass01
INSTRUMENTATION_STATUS: current=4
INSTRUMENTATION_STATUS_CODE: 1
INSTRUMENTATION_STATUS: numtests=4
INSTRUMENTATION_STATUS: stream=.
INSTRUMENTATION_STATUS: id=AndroidJUnitRunner
INSTRUMENTATION_STATUS: test=testCase04
INSTRUMENTATION_STATUS: class=com.test.tommyxie.hellouiautomator.TestClass01
INSTRUMENTATION_STATUS: current=4
INSTRUMENTATION_STATUS_CODE: 0
INSTRUMENTATION_RESULT: stream=

Time: 0.131

OK (4 tests)

4.2 通过自定义注解，运行测试：

参照既有的注解的格式e.g.LargeTest注解，新建一个定义注解：

@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD, ElementType.TYPE})
public @interface CustomAnnotation {

}
测试用例引用自定义注解： 

@RunWith(AndroidJUnit4.class)
public class TestClass01 {
    public UiDevice mDevice;
    public Instrumentation instrumentation;

    @Before
    public void setUp(){
        instrumentation = InstrumentationRegistry.getInstrumentation();
        mDevice = UiDevice.getInstance(instrumentation);
    }

    @Test
    public void testCase01() throws IOException {
        //test code
    }


    @Test
    @CustomAnnotation
    public void testCase02(){
        //test code
    }


    @Test
    public void testCase03(){
        //test code
    }

    @Test
    public void testCase04(){
        //test code
    }

}

指定注解，运行测试： 

am instrument -w -r -e annotation com.test.tommyxie.hellouiautomator.CustomAnnotation  com.test.tommyxie.hellouiautomator.test/android.support.test.runner.AndroidJUnitRunner



4.3 通过AndroidManifest文件配置参数，运行测试，e.g.指定注解运行测试：

Manifest 文件配置

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
          package="com.test.tommyxie.hellouiautomator">

    <application android:allowBackup="true"
                 android:label="@string/app_name"
                 android:icon="@mipmap/ic_launcher"
                 android:theme="@style/AppTheme">

        <instrumentation
            android:name="com.android.support.test.runner.AndroidJUnitRunner"
            android:targetPackage="com.test.tommyxie.hellouiautomator">

            <meta-data
                android:name="annotation"
                android:value="com.test.tommyxie.hellouiautomator.CustomAnnotation" />

        </instrumentation>

    </application>

</manifest>

运行测试，发现未按配置好的参数，运行指定的用例，还是会执行全部的用例。（备注：根据官方的说明，在manifest文件中配置参数，可以实现同样的效果，但是确认了配置是正确的，翻阅了一些资料，目前暂未找到原因）
AndroidJunitRunnerSample:2015年10月17日的UnitTest项目
05-02
AndroidJUnitRunner示例 新的android测试运行程序为Android测试带来了Junit4支持。 该样本快速概述了一些新功能，例如测试注释，参数化测试和测试套件创建。 CalculatorTest.java包含用于计算器逻辑的JUnit4样式单元测试。 CalculatorAddParameterizedTest.java包含JUnit4样式测试，并使用@Parameters批注对具有不同值的单个测试进行参数化。 CalculatorInstrumentationTest.java使用JUnit4样式测试来测试CalculatorActivity的Ui OperationHintInstrumentationTest.java使用JUnit3样式测试来测试CalculatorActivity的Ui 该项目使用Gradle构建系统。 您不需要IDE即可构建和执行
Android 单元测试(四) 之AndroidJUnitRunner基础
孙朝阳的博客
05-02 1万+
AndroidJUnitRunner，Google官方的android单元测试框架之一，适用于 Android 且与 JUnit 4 兼容的测试运行器！测试运行器可以将测试软件包和要测试的应用加载到设备、运行测试并报告测试结果。 此测试运行器的主要功能包括： JUnit 支持 访问仪器信息 测试筛选 测试分片 要求 Android 2.2（API 级别 8）或更高版本。 JUnit 支...
Android测试中的JUnit4和JUnitRunner
2501_90323865的博客
03-15 97
在Android应用开发中，测试是确保应用质量和用户体验的重要环节。特别是对于新手开发者来说，选择正确的测试框架和运行器至关重要。和。
移动端-安卓-接口测试环境搭建
weixin_42233460的博客
09-25 1280
提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档 文章目录前言一、pandas是什么？二、使用步骤1.引入库2.读入数据总结 前言 提示：这里可以添加本文要记录的大概内容： 例如：随着人工智能的不断发展，机器学习这门技术也越来越重要，很多人都开启了学习机器学习，本文就介绍了机器学习的基础内容。 提示：以下是本篇文章正文内容，下面案例可供参考 一、pandas是什么？ 示例：pandas 是基于NumPy 的一种工具，该工具是为了解决数据分析任务而创建的。 二、使用步骤 1.引入库 代码
1.Android JUnit Runner（使用AndroidStudio）
weixin_30375247的博客
02-01 261
一、Android JUnit Runner介绍 1.Android JUnit Runner 1）是一个测试运行器，用于运行Junit3和Junit4的Android测试包 2）替换Instrumentation Test Runner（一个比较旧的测试运行器） 3）支持Instrumentation Test Runner所有特性，但又进行了扩展 4）保持了所有Instru...
Android自动化测试基础知识——JUnit4、 AndroidJunitRunner（支持安卓的Junit）、 Espresso
jackron2014的博客
01-21 1461
目录 配置 JUnit4 JUnit4基础方法注解 JUnit4常用断言 Hamcrest与assertThat 测试方法执行顺序 Espresso 依赖的类库 使用 Rules 创建的 JUnit4 测试实例： 使用 onView 查找视图 在视图上执行操作 检查一个视图是否满足断言 在AdapterView控制器（ListView,GridView, ...）中...
AndroidJUnitRunner常用命令
mqqzt的专栏
11-21 1482
Instrument命令命令格式：am instrument -w [-r] [-e <Name> <Value>] [-p <FILE>] [--user <USER_ID>|current] [-no-window-animation] [--abi <ABI>] COMPONENT COMPONENT：包名/运行Runner运行所有用例
am instrument 命令详解运行多个用例
weixin_30565199的博客
08-07 1859
1 Instrument是什么？ instrument为am命令的一个子命令。用于启动一个Instrumentation测试。首先连接手机或者模拟器，通过adb shell命令，进入shell层进行操作。 2 命令格式及参数解读（来自官网） 格式：instrument [options]component 目标component是表单test_package/runner_...
adb shell am instrument 命令详解
weixin_30457465的博客
05-24 828
官网关于该命令的详解：https://developer.android.com/studio/command-line/adb.html?hl=zh-cn 1 Instrument是什么？ instrument为am命令的一个子命令。用于启动一个Instrumentation测试。首先连接手机或者模拟器，通过adb shell命令，进入shell层进行操作。 2 命令格式及参数解读（来自官...
【转】adb shell am instrument 命令详解
dengdang7631的博客
09-26 396
本文转载来源http://www.cnblogs.com/insist8089/p/6897037.html 官网关于该命令的详解：https://developer.android.com/studio/command-line/adb.html?hl=zh-cn 1 Instrunent是什么？ instrument为am命令的一个子命令。用于启动一个Instrumentati...
Android Gradle DSL测试配置终极指南：testOptions与instrumentation测试的5个最佳实践
最新发布
gitblog_00772的博客
06-21 433
Android Gradle DSL测试配置是每个Android开发者必须掌握的核心技能！🚀 无论是单元测试还是instrumentation测试，合理的testOptions配置都能显著提升测试效率和质量。本文将深入解析Android Gradle DSL中的testOptions配置，分享instrumentation测试的最佳实践，帮助您构建健壮的Android应用测试体系。 ## 📊
Android Studio使用AndroidJUnitRunner进行单元测试
热门推荐
zhuhai__yizhi的专栏
08-10 1万+
目前google是推荐使用AndroidJUnitRunner来进行单元测试的。 如果想使用InstrumentationTestRunner推荐下面的一篇文章： http://blog.csdn.net/zhaokaiqiang1992/article/details/45332513 使用AndroidJUnitRunner进行测试的时候，需要做在build.gradle里面添加
androidJUnitRunner以及JUnit的学习以及使用
a470271804的博客
07-31 1906
学习一下Android的测试方法 主要学习了解androidJUnitRunner以及JUnit androidTest 和 Test 目录 每次创建一个module，我们都会发现在目录下有androidTest以及Test两个文件夹，androidTest和Test都是对程序的内部进行测试，而非其是否符合预期的功能要求，这些test代码均不会打包到最终的apk之中 androidTest：需要设备环境才能进行的测试 Test：不依赖设备环境，可以在PC上单独进行测试 JUnit JUnit是一套基.
android junit 参数化,AndroidJUnitRunner
weixin_42524750的博客
05-26 1173
AndroidJUnitRunner 类是一个 JUnit 测试运行程序，可让您在 Android 设备上运行 JUnit 3 或 JUnit 4 型测试类，包括使用 Espresso 和 UI Automator 测试框架的测试类。此测试运行程序负责将测试软件包和被测应用加载到设备上，运行测试并报告测试结果。此类将替换此测试运行程序支持几项常见的测试任务，包括以下各项：编写 JUnit 测试此测...
Android单元测试全解
to_perfect的博客
07-15 1万+
  自动化测试麻烦吗？说实在，麻烦！有一定的学习成本。但是，自动化测试能节省时间来打游戏！！
Android单元测试(一)：JUnit框架的使用
qq_27419187的博客
03-25 1477
JUnit框架的使用前言工程介绍JUnit介绍什么是JUnitJUnit引入JUnit注解JUnit断言JUnit使用基础用法参数化测试 前言 以前工作中，没有写过测试用例，每次功能做完之后，都是运行在手机上或是模拟器上，进行测试。最近看了一些公司的招聘信息，部分公司要求会单元测试，于是了解了一下android单元测试的资料，我去，单元测试用起来真是好处多多，得抓紧时间学习一下了。 工程介绍 新建...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值