Android自动化测试-从入门到入门（2）Testing APIs

向右看齐 2022-02-16 08:50 314阅读 0赞

根据该系列文章的第一篇：[Hello Testing][]，大家已经对整个自动化测试运行流程有了一个基本的了解，接下来我们该集中精力关注具体的脚本实现了！在具体实现之前，我们先来了解一下Android提供的对于自动化测试的一些支持。

### AndroidJUnitRunner ###

根据Android[官网][Link 1]的说法，

> The AndroidJUnitRunner class is a JUnit test runner that lets you run JUnit 3 or JUnit 4-style test classes on Android devices, including those using the Espresso and UI Automator testing frameworks. The test runner handles loading your test package and the app under test to a device, running your tests, and reporting test results. This class replaces the InstrumentationTestRunner class, which only supports JUnit 3 tests.

`AndroidJUnitRunner`是一个可以用来运行`JUnit 3`和`JUnit 4`样式的测试类的Test Runner，并且同时支持`Espresso`和`UI Automator`。这是对于之前的`InstrumentationTestRunner`的一个升级，如果你去查看[Gradle][]文档中对于Testing配置的说明，会发现推荐的Test Runner为`InstrumentationTestRunner`。`InstrumentationTestRunner`只支持`JUnit 3`样式的测试用例，而我们在写Android测试用例时应该尽可能使用`JUnit 4`样式来实现。

相对于`Junit 3`， `JUnit 4`有如下改进：

*  测试类不需要再继承`junit.framework.TestCase`类；
 *  测试方法名不再需要以`test`开头；
 *  可以使用类似`@Test`, `@Before`, `@After`等注解来管理自己的测试方法；
 *  增加了一些`Assert`方法；
 *  支持对`assert`方法的`static`导入。

下面来看一个例子。如下的代码段采用了`JUnit 4`风格进行编写，并且调用了`Espresso`的API来进行了一些测试：

@RunWith(AndroidJUnit4.class)
    @LargeTest
    public class MainActivityInstrumentationTest {
    
        @Rule
        public ActivityTestRule mActivityRule = new ActivityTestRule<>(
                MainActivity.class);
    
        @Test
        public void sayHello(){
            onView(withText("Say hello!")).perform(click());
            onView(withId(R.id.textView)).check(matches(withText("Hello, World!")));
        }
    }

从以上代码可以看到，`JUnit 4`支持使用如下注解来管理整个测试用例：

*  `@Before`: 标识在运行测试方法之前运行的代码。可以支持同一个Class中有多个`@Before`，但是这些方法的执行顺序是随机的。该注解替代了`JUnit 3`中的`setUp()`方法。
 *  `@After`: 标识在运行测试方法结束之后运行的代码。可以在其中做一些释放资源的操作。该注解替代了`JUnit 3`中的`tearDown()`方法。
 *  `@Test`: 标识一个测试方法。一个测试类中可以有多个测试方法，每个测试方法需要用一个`@Test`注解来标识。
 *  `@Rule`: 简单来说，是为各个测试方法提供一些支持。具体来说，比如我需要测试一个Activity，那么我可以在`@Rule`注解下面采用一个`ActivityTestRule`，该类提供了对相应Activity的功能测试的支持。该类可以在`@Before`和`@Test`标识的方法执行之前确保将Activity运行起来，并且在所有`@Test`和`@After`方法执行结束之后将Activity杀死。在整个测试期间，每个测试方法都可以直接对相应Activity进行修改和访问。
 *  `@BeforeClass`: 为测试类标识一个static方法，在测试之前只执行一次。
 *  `@AfterClass`: 为测试类标识一个static方法，在所有测试方法结束之后只执行一次。
 *  `@Test(timeout=<milliseconds>)`: 为测试方法设定超时时间。

### Instrumentation ###

根据官方的说法，

> Android instrumentation is a set of control methods or hooks in the Android system. These hooks control an Android component independently of its normal lifecycle. They also control how Android loads applications.

`Android Instrumentation`提供了一些方法，可以用来独立地控制某个组件的生命周期。

一般来说，Android中组件的生命周期是由系统来控制的。比如，我们启动了一个Activity，那么Activity的生命周期方法会自动为我们调用，Android APIs并没有提供入口让我们直接去调用这些生命周期方法，但是使用`Instrumentation`就可以做到。

`Instrumentation`可以将要测试的APP以及其对应的test Package加载到同一个进程中。由于我们所要测试的组件和其测试用例都运行在同一进程，因此我们就可以在我们的测试用例中直接调用组件的方法，对组件做一系列访问和修改。

### Android Testing Support Library APIs ###

Android为自动化测试提供了如下的API供我们使用：

*  `AndroidJUnitRunner`: 以上已经提到；
 *  `Espresso`: 提供了UI测试的API；
 *  `UI Automator`: 提供了跨APP UI测试的API。

`Espresso`和`UI Automator`会在接下来的文章中详细说明。

### Assertion ###

在做测试的过程中，我们应该如何检查实际的结果符合我们的预期呢？

这里就要用到了`Assertion Classes`。`Assertion Classes`提供了一系列`assert`方法用来比对我们检测的数据和期望的数据是否一致，如果检测失败，则会抛出一个`AssertionException`异常。

比方说在[上一篇文章][Hello Testing]中贴出来的`AppStartActivityTest`代码中，有这么一行：

assertNotNull("AppStartActivity Content is Null", content);

这一行代码就是检查`content`的内容不为空。其中第一个参数指定了一个提示文案，第二个参数指定了需要测试的字符串。

为了简化我们的测试代码，在之后的测试中，我们还会使用到一个叫做`Hamcrest`的类库，用来简化我们的`Assertion`过程。这些都将会在接下来的文章中一一介绍。

### 附录 ###

[Android自动化测试-从入门到入门（1） Hello Testing!][Hello Testing]  
[Android自动化测试-从入门到入门（2） Testing APIs][Android_-_2_ Testing APIs]  
[Android自动化测试-从入门到入门（3） Espresso入门][Android_-_3_ Espresso]  
[Android自动化测试-从入门到入门（4） uiautomatorviewer][Android_-_4_ uiautomatorviewer]  
[Android自动化测试-从入门到入门（5） AdapterView的测试][Android_-_5_ AdapterView]  
[Android自动化测试-从入门到入门（6） 会玩的Espresso][Android_-_6_ _Espresso]  
[Android自动化测试-从入门到入门（7） UI Automator][Android_-_7_ UI Automator]

[Hello Testing]: http://segmentfault.com/a/1190000004338384
[Link 1]: http://developer.android.com/intl/zh-cn/tools/testing-support-library/index.html#AndroidJUnitRunner
[Gradle]: http://tools.android.com/tech-docs/new-build-system/user-guide#TOC-Testing
[Android_-_2_ Testing APIs]: http://segmentfault.com/a/1190000004342951
[Android_-_3_ Espresso]: http://segmentfault.com/a/1190000004355178
[Android_-_4_ uiautomatorviewer]: http://segmentfault.com/a/1190000004367222
[Android_-_5_ AdapterView]: http://segmentfault.com/a/1190000004392396
[Android_-_6_ _Espresso]: https://segmentfault.com/a/1190000004471733
[Android_-_7_ UI Automator]: https://segmentfault.com/a/1190000004619487