1.为了确保测试稳定性，使用前需要在开发者选项中关闭一下三个设置：
- 窗口动画缩放；
- 过度动画缩放；
- Animator 时长缩放；
2.如何使用：
- 添加必要的依赖：
// dependencies 下面
androidTestImplementation 'androidx.test.espresso:espresso-core:3.1.0'
androidTestImplementation 'androidx.test:runner:1.1.0'
androidTestImplementation 'androidx.test:rules:1.1.0'
// android 的 defaultConfig 下面
// 添加 Instrumentation Runner
testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
- test runner 由于需要确保每个新版本都正常工作，所以会收集并上传分析信息，这个可以通过 adb 指令来手动关闭；
- first test，需要创建在 src/androidTest/java/包名 下，如下：
@RunWith(AndroidJUnit4.class)
@LargeTest
public class ExampleInstrumentedTest {
// 通过这个来指定在哪个 Activity 下面查找
@Rule
public ActivityTestRule<MainActivity> activityTestRule = new ActivityTestRule<>(MainActivity.class);
@Test
public void useAppContext() {
// Context of the app under test.
Context appContext = ApplicationProvider.getApplicationContext();
assertEquals("com.jaaaelu.gzw.autotest", appContext.getPackageName());
}
@Test
public void matchesText() {
// 去匹配是否存在对应的文字
// 精确匹配否则失败
onView(withText("Hello")).check(matches(isDisplayed()));
}
}
- 运行方式有两种：
- 在 Android Studio 中，Run -> Edit Configurations 添加一个可运行的测试配置，然后运行即可，这里可以指定模块、测试范围等等；
- 也可以通过指令行的方式运行；
- 该框架阻止直接访问应用程序的 Activities 和 views of the application，因为要保持这些对象并在 UI 线程上对他们进行操作是测试片段的主要来源；
- 所以不会提供 getView() getCurrentActivity() 这样的方法；
- 不过可以通过 ViewAction 和 ViewAssertion 来安全操作那些 View；
3.主要组件介绍：
- Espresso，与 View 交互的入口，主要是 onView 和 onData；
- ViewMatchers，一个 Matcher<? super View> 的实例创建类，提供了各种 Matcher 的创建；
- 可以将一个或多个传递给 onView；
- 我们可以自定义，继承自 BaseMatcher 即可；
- ViewAction，负责在给定的 View 上执行交互；
- ViewAssertions，提供了常用的 ViewAssertion 实例；
- 不过大多数时候我们使用的是匹配断言，它使用 View 的匹配器来断言当前所选视图的状态；
- ViewInteraction，为开发人员提供主要接口，以便对 View 进行操作或断言，不过这个我们不直接操作 Espresso.onView 会返回这个对象；
实例：
@Test
public void clickFab() {
// 对 R.id.fab 执行点击事件
onView(withId(R.id.fab)).perform(click()).check(matches(isDisplayed()));
}
4.常用功能介绍：
- 寻找某个 View：
- 如果所需 View 具有唯一 id，那么直接使用 onView(withId(R.id.xxx)) 即可；
- 补充，onView() 大多数是采用的是 hamcrest matchers，该匹配器在当前视图层次结构中匹配一个且只能匹配一个视图；
- 如果一个 view hierarchy 中出现重复的 id 那么上面那个就不起作用了，需要使用另一种方式：
- onView(allOf(withId(R.id.view), withText("Hello"))); 也就是通过其他特征找到对应的 View；
- onView(allOf(withId(R.id.view), not(withText("Hello"))));
- 补充，建议良好的应用程序中的 View 应该包含描述性文本或具体内容描述，否则无法使用使用 withText() 或 withContentDescription()，这些方法可以帮你缩小匹配范围；
- 对 View 执行操作：
- 可以执行一个或多个操作，比如常见的点击事件，onView(withId(R.id.fab)).perform(click())；
- 多个操作点击了输入 Test 进去，onView(withId(R.id.et_input)).perform(typeText("Test"), click());
- 如果在 ScrollView 中还可以通过 scrollTo() 操作先滑动到对应位置，不过如果已经显示在页面上，就不起作用了；
- 可以同一个对一个无效的 id 进行操作，从而查看视图结构，例如 onView(withId(-1)).perform(click());
- View 断言：
- 使用 check 方法对当前 View 进行断言，而 matches 方法表示具体断言；
- 检查列表中的数据加载：
- 通过 onData() 来处理这个问题；
- 例如：onView(withText("Hello World!")).check(matches(isDisplayed())); 查看显示对应文字的控价是否可见；
5.常见断言与操作：
- View 没有显示：onView(...).check(matcher(not(isDisplayed())))；
- View 不在视图结构中：onView(...).check(doesNotExist())；
- 数据是否在适配器中，可以通过自定义 Matcher 来完成；
- 可以通过自定义异常处理器来处理异常情况，有点相似线程的异常处理器；
// 官方
private static class CustomFailureHandler implements FailureHandler {
private final FailureHandler delegate;
public CustomFailureHandler(Context targetContext) {
delegate = new DefaultFailureHandler(targetContext)；
}
@Override
public void handle(Throwable error, Matcher<View> viewMatcher) {
try {
delegate.handle(error, viewMatcher);
} catch (NoMatchingViewException e) {
throw new MySpecialException(e);
}
}
}
- 与非默认 window 交互，比如弹窗之类的，Espresso 会猜测您打算和哪个窗口进行交互；
// 点开 Fab 按钮，弹出 Dialog
onView(withId(R.id.fab)).perform(click());
// 然后点击 Dialog 的 yes 按钮，使 Dialog 消失
onView(withText("yes")).inRoot(withDecorView(not(is(activityTestRule.getActivity().getWindow().getDecorView())))).perform(click());
- ListView 的头尾也可以匹配；
6.Espresso 可以在多进程中的使用，
- 注意事项：
- 8.0 以上；
- 无法测试后应用程序外的进程；
- 按照官网进行配置即可，否则会报错的；
在 src/androidTest/AndroidManifest.xml 下面加上即可
<!-- 多进程必备 -->
<instrumentation
android:name="androidx.test.runner.AndroidJUnitRunner"
android:targetPackage="com.jaaaelu.gzw.autotest"
android:targetProcesses="*">
<meta-data
android:name="remoteMethod"
android:value="androidx.test.espresso.remote.EspressoRemote#remoteInit" />
</instrumentation>
- 默认情况下测试的是应用启动的默认线程；
- 每个进程都有一个 AndroidJUintRunner 实例，每个 AndroidJUintRunner 都把 Espresso 注册为测试框架，不同进程的 AndroidJUintRunner 需要通过握手来建立连接，图片是跨进程通信：
7.测试代码可访问性，通过使用 AccessibilityChecks 类来使用。
8.AndroidJUnitRunner 类是一个JUnit测试运行器，允许您在 Android 设备上运行 JUnit 3 或 JUnit 4 样式的测试类，包括那些使用 Espresso 和 UI Automator 测试框架的测试类。测试运行器处理将测试包和被测应用程序加载到设备，运行测试和报告测试结果。此类替换了 InstrumentationTestRunner 类，该类仅支持 JUnit 3 测试。
页面依赖或者数据依赖怎么解决？
能否记录流程，比如截图
onData
9.onData 用来匹配数据（onView 也可以匹配 Text，而 onData 更多是和那种 AdapterView 的控件一起使用，比如 ListView、Spinner 等），onView 用来匹配试图，例如：
// 我们通过 onData 匹配列表的内容，并给出对应 Id
onData(withItemContent("item: 60"))
.onChildView(withId(R.id.item_size))
.perform(click());
对应匹配到的内容如图，先通过 item: 60 找到内容对应的行，然后再通过提供的控件 Id 去找到对应控件（不过这种用法一般适用于 ListView 这样的控件）：
如果我们使用的是 RecycleView 的话，就需要配合 RecycleViewAction 这个类来进行操作，它提供了一些常用的功能：
- scrollTo() - Scrolls to the matched View（滑动到匹配试图）；
- scrollToHolder() - Scrolls to the matched View Holder（滑动到匹配的 ViewHolder）；
- scrollToPosition() - Scrolls to a specific position（滑动到指定位置）；
- actionOnHolderItem() - Performs a View Action on a matched View Holder（在匹配的 ViewHolder 上执行操作）；
- actionOnItem() - Performs a View Action on a matched View（在指定 View 上执行操作）；
- actionOnItemAtPosition() - Performs a ViewAction on a view at a specific position（在指定位置上的 View 执行操作）；
// 官方 Demo，这个意思就是直接滑动到中间 Holder 位置，isInTheMiddle() 是自定义匹配器，然后判断是否滑动成功，对应控件是否已经显示在页面上了
// First, scroll to the view holder using the isInTheMiddle matcher.
onView(ViewMatchers.withId(R.id.recyclerView))
.perform(RecyclerViewActions.scrollToHolder(isInTheMiddle()));
// Check that the item has the special text.
String middleElementText =
getApplicationContext().getResources().getString(R.string.middle);
onView(withText(middleElementText)).check(matches(isDisplayed()));
// 自定义的匹配器
private static Matcher<CustomAdapter.ViewHolder> isInTheMiddle() {
return new TypeSafeMatcher<CustomAdapter.ViewHolder>() {
@Override
protected boolean matchesSafely(CustomAdapter.ViewHolder customHolder) {
// 调用的是 holder 中的方法来判断
return customHolder.getIsInTheMiddle();
}
@Override
public void describeTo(Description description) {
description.appendText("item in the middle");
}
};
}
// 点击第 40 个 item，然后判断是否已经显示在页面上
// First scroll to the position that needs to be matched and click on it.
onView(ViewMatchers.withId(R.id.recyclerView))
.perform(RecyclerViewActions.actionOnItemAtPosition(40, click()));
// Match the text in an item below the fold and check that it's displayed.
String itemElementText = getApplicationContext().getResources().getString(
R.string.item_element_text) + String.valueOf(40);
onView(withText(itemElementText)).check(matches(isDisplayed()));
官方的第二个 Demo 肯定也是测试成功的，因为 RecyclerViewActions.actionOnItemAtPosition 这个方法会先滑动到对应位置
10.Espresso-Intents，是 Espresso 的扩展，它可以用来验证和存储被测试的程序发出的 Intent，不过使用前需要先添加对应依赖：
androidTestImplementation 'androidx.test.espresso:espresso-intents:3.1.0'
// 需要指定 Intent 发出页面
// 如果要测试意图这里需要使用 IntentsTestRule 而不是 ActivityTestRule，不过 IntentsTestRule 是它的之类，做了一些额外的工作
// 例如初始化 Intents，里面有个变量来手机 Intent
// // Should be accessed only from main thread
// private static final List<VerifiableIntent> recordedIntents = new ArrayList<VerifiableIntent>();
@Rule
public IntentsTestRule<DialerActivity> mActivityRule = new IntentsTestRule<>(
DialerActivity.class);
// 对应权限给足
@Rule public GrantPermissionRule grantPermissionRule = GrantPermissionRule.grant("android.permission.CALL_PHONE");
// 判断对应 Intent.ACTION_CALL 的 Intent 是否发送
@Test
public void typeNumber_ValidInput_InitiatesCall() {
// Types a phone number into the dialer edit text field and presses the call button.
onView(withId(R.id.edit_text_caller_number))
.perform(typeText(VALID_PHONE_NUMBER), closeSoftKeyboard());
onView(withId(R.id.button_call_number)).perform(click());
// Verify that an intent to the dialer was sent with the correct action, phone
// number and package. Think of Intents intended API as the equivalent to Mockito's verify.
// intended 用于校验给定匹配器中被测应用是否发送该意图
intended(allOf(
hasAction(Intent.ACTION_CALL),
hasData(INTENT_DATA_PHONE_NUMBER)));
}
// R.id.button_call_number 触发的方法
private Intent createCallIntentFromNumber() {
final Intent intentToCall = new Intent(Intent.ACTION_CALL);
String number = mCallerNumber.getText().toString();
intentToCall.setData(Uri.parse("tel:" + number));
return intentToCall;
}
// 如果是 startActivityForResult 的启动方式，可以通过这种方式来构建代码并测试，不过这种只是模拟启动和数据返回，不会真的启动页面，然后模拟调用 // onActivityResult
@Test
public void testStartActivityForResult() {
// 构造结果Intent
Intent resultIntent = new Intent();
resultIntent.putExtra("result", "OK");
Instrumentation.ActivityResult activityResult =
new Instrumentation.ActivityResult(Activity.RESULT_OK, resultIntent);
// 如果有相应的 intent 发送，并返回虚构的结果
intending(allOf(
hasComponent(hasShortClassName(".OtherActivity")),
toPackage(TEST_PAGE_NAME)))
.respondWith(activityResult);
// 点击获取结果按钮，这个按钮就是对应调用 startActivityForResult 方法的按钮
onView(withId(R.id.for_result_button)).perform(click());
// 查看是否显示结果
onView(withId(R.id.result_text_view))
.check(matches(withText("OK")));
}
// 验证 Intent 中参数是否与测试内容一致
intended(allOf(
hasAction(equalTo(Intent.ACTION_VIEW)),
hasCategories(hasItem(equalTo(Intent.CATEGORY_BROWSABLE))),
hasData(hasHost(equalTo("www.google.com"))),
hasExtras(allOf(
hasEntry(equalTo("key1"), equalTo("value1")),
hasEntry(equalTo("key2"), equalTo("value2")))),
toPackage("com.android.browser")));
所以这么看下来主要就是两个功能，一个 Intent 的验证（使用 intended，验证还可以验证 Intent 中的参数是否正确，验证不必以与发送意图相同的顺序发生。从调用Intents.init的时间开始记录意图），一个 Intent 的存根（使用 intending，方法说明：启用存根意图响应。此方法类似于Mockito.when，当启动 intent 的活动需要返回数据时（特别是在目标活动是外部的情况下），此方法特别有用。在这种情况下，测试作者可以调用 intending（matcher）.thenRespond（myResponse）并验证启动活动是否正确处理结果。注意：目标活动不会启动）。
11.使用 Espresso-Web 测试混合应用程序，也就是 native + WebView，如果只是想要单独测试 WebView 可以使用 WebDriver 框架来编写常规的的 Web 测试。
WebDriver 框架使用 Atoms 方式查找与操作 Web 元素，Atoms 类似 ViewAction。
常用 API 介绍：
- onWebView 是 WebView 的入口点；
- withElement 查找网页中的元素；
- check 进行断言；
- perform 执行操作；
- reset 将 WebView 恢复到初始状态；
// 先通过 Id 找到元素，然后出发点击事件，并检查跳转后的页面是否包含 navigation_2.html
onWebView()
.withElement(findElement(Locator.ID, "link_2")) // similar to onView(withId(...))
.perform(webClick()) // Similar to perform(click())
// Similar to check(matches(...))
.check(webMatches(getCurrentUrl(), containsString("navigation_2.html")));
public static final String MACCHIATO = "Macchiato";
// 先通过 id 查找 text_input，然后清空之前的输入，然后输入 Macchiato，再查找 submitBtn，点击按钮，跳到转新的网页上， 并检查这个网页上是否之
// 前输入的文字
@Test
public void typeTextInInput_clickButton_SubmitsForm() {
// Create an intent that displays a web form.
Intent webFormIntent = new Intent();
// ...
// Lazily launch the Activity with a custom start Intent per test.
// 每次都要写
ActivityScenario.launchActivity(webFormIntent);
// Selects the WebView in your layout. If you have multiple WebView objects,
// you can also use a matcher to select a given WebView,
// onWebView(withId(R.id.web_view)).
onWebView()
// Find the input element by ID.
.withElement(findElement(Locator.ID, "text_input"))
// Clear previous input and enter new text into the input element.
.perform(clearElement())
.perform(DriverAtoms.webKeys(MACCHIATO))
// Find the "Submit" button and simulate a click using JavaScript.
.withElement(findElement(Locator.ID, "submitBtn"))
.perform(webClick())
// Find the response element by ID, and verify that it contains the
// entered text.
.withElement(findElement(Locator.ID, "response"))
.check(webMatches(getText(), containsString(MACCHIATO)));
}
在使用 Espresso-Web 是，一定要确保 JS 打开，
@Rule
public ActivityTestRule<WebViewActivity> mActivityRule = new ActivityTestRule<WebViewActivity>(
WebViewActivity.class, false, false) {
@Override
protected void afterActivityLaunched() {
// Technically we do not need to do this - WebViewActivity has javascript turned on.
// Other WebViews in your app may have javascript turned off, however since the only way
// to automate WebViews is through javascript, it must be enabled.
onWebView().forceJavascriptEnabled();
}
};
12.Espresso 提供的一套同步的功能，所以它并不知道任何异步操作，比如后台线程上运行的操作。如果为了让 Espresso 长期运行，那么就需要为空闲资源注册，如果不使用空闲资源这种方式，可以使用例如 Thread.sleep 或 CountDownLatch 的方式。
在执行以下操作时，应该考虑使用空闲资源：
- 从网络或本地数据源加载数据；
- 数据库操作；
- 使用 Service；
- 执行复杂的耗时逻辑；
这些操作完成后可能会涉及到 UI 更新，这时就该注册空闲资源。
可直接使用的空闲资源实现：
- CountingIdlingResource，计数器，计数器为零时，关联的资源被视为空闲；
- UriIdlingResource，与上面的类型，不过在资源被视为空闲之前，计数器需要在特定时间段内为 0。额外的等待时间会考虑连续的网络请求；
- IdlingThreadPoolExecutor，内部实现了线程池，可跟踪创建的线程池中正在运行的任务总数；
- IdlingScheduledThreadPoolExecutor，内部实现了 ScheduledThreadPoolExecutor，与上面的一样，不过它还可以跟踪定时执行的任务；
创建自己的 IdlingResource，
public void isIdle() {
// DON'T call callback.onTransitionToIdle() here!
}
public void backgroundWorkDone() {
// 在后台工作完成后通知
// Background work finished.
callback.onTransitionToIdle() // Good. Tells Espresso that the app is idle.
// Don't do any post-processing work beyond this point. Espresso now
// considers your app to be idle and moves on to the next test action.
}
一般我们都在 @Before 中注册空闲资源，然后别忘了在完成了反注册，代码如下：
不过这些需要修改代码，需要在代码中配合，至少配合通知到空闲资源后台工作已经完成，然后调用通知方法。
如果不希望过多影响代码可以有以下方式，如构建 Gradle's product flavors，仅在调试版本中使用，或使用像 Dagger 的依赖注入框架；
