Espresso-Intents 是 Espresso 的扩展程序,可对被测应用发出的 intent 进行验证和桩处理。它类似于 Mockito,但适用于 Android intent。
如果您的应用将功能委托给其他应用或平台,您可以使用 Espresso-Intents 专注于您自己的应用逻辑,同时假设其他应用或平台能够正常运行。借助 Espresso-Intents,您可以匹配和验证您的传出 intent,甚至可以提供桩响应来代替实际的 intent 响应。
在项目中添加 Espresso-Intents
在应用的 app/build.gradle 文件中,在 dependencies 内添加以下行:
Groovy
androidTestImplementation 'androidx.test.espresso:espresso-intents:3.6.1'
Kotlin
androidTestImplementation('androidx.test.espresso:espresso-intents:3.6.1')
Espresso-Intents 仅与 Espresso 2.1+ 和 0.3+ 版本的 Android 测试库兼容,因此请务必同时更新以下几行代码:
Groovy
androidTestImplementation 'androidx.test:runner:1.6.1' androidTestImplementation 'androidx.test:rules:1.6.1' androidTestImplementation 'androidx.test.espresso:espresso-core:3.6.1'
Kotlin
androidTestImplementation('androidx.test:runner:1.6.1') androidTestImplementation('androidx.test:rules:1.6.1') androidTestImplementation('androidx.test.espresso:espresso-core:3.6.1')
编写测试规则
在编写 Espresso-Intents 测试之前,先设置 IntentsTestRule。这是 ActivityTestRule 类的扩展,可让您在功能界面测试中轻松使用 Espresso-Intents API。IntentsTestRule 会在每个带有 @Test 注解的测试之前初始化 Espresso-Intents,并在每次测试运行后释放 Espresso-Intents。
以下代码段是 IntentsTestRule 的一个示例:
@get:Rule val intentsTestRule = IntentsTestRule(MyActivity::class.java)
匹配
Espresso-Intents 能够根据特定匹配条件(使用 Hamcrest 匹配器定义)拦截传出 intent。Hamcrest 允许您:
- 使用现有 intent 匹配器:最简单的选项,几乎始终是首选。
- 实现您自己的 intent 匹配器:这是最灵活的选项。如需了解详情,请参阅 Hamcrest 教程中标题为“编写自定义匹配器”的部分。
Espresso-Intents 分别提供 intended() 和 intending() 方法,用于 intent 验证和桩。两者都将 Hamcrest Matcher<Intent> 对象作为参数。
以下代码段展示了 intent 验证,该验证使用与启动浏览器的传出 intent 匹配的现有 intent 匹配器:
assertThat(intent).hasAction(Intent.ACTION_VIEW) assertThat(intent).categories().containsExactly(Intent.CATEGORY_BROWSABLE) assertThat(intent).hasData(Uri.parse("www.google.com")) assertThat(intent).extras().containsKey("key1") assertThat(intent).extras().string("key1").isEqualTo("value1") assertThat(intent).extras().containsKey("key2") assertThat(intent).extras().string("key2").isEqualTo("value2")
验证 intent
Espresso-Intents 会记录所有尝试从被测应用启动 activity 的 intent。使用 intended() 方法(类似于 Mockito.verify()),您可以断言已看到给定 intent。不过,除非您明确配置 Espresso-Intents 桩出对 intent 的响应,否则它不会这样做。
以下代码段是一个示例测试,用于验证启动外部“电话”activity 的传出 intent,但不会对该 intent 的响应进行桩处理:
@Test fun validateIntentSentToPackage() { // User action that results in an external "phone" activity being launched. user.clickOnView(system.getView(R.id.callButton)) // Using a canned RecordedIntentMatcher to validate that an intent resolving // to the "phone" activity has been sent. intended(toPackage("com.android.phone")) }
打桩
使用 intending() 方法(类似于 Mockito.when()),您可以为使用 startActivityForResult() 启动的 activity 提供桩响应。这对于外部 activity 尤其有用,因为您无法操纵外部 activity 的界面,也无法控制返回到被测 activity 的 ActivityResult。
以下代码段实现了一个示例 activityResult_DisplaysContactsPhoneNumber() 测试,该测试验证当用户在被测应用中启动“联系人”activity 时,系统会显示联系人电话号码:
构建要在启动特定 Activity 时返回的结果。示例测试会拦截发送到“contacts”的所有 intent,并使用结果代码
RESULT_OK通过有效的ActivityResult桩出其响应val resultData = Intent() val phoneNumber = "123-345-6789" resultData.putExtra("phone", phoneNumber) val result = Instrumentation.ActivityResult(Activity.RESULT_OK, resultData)
指示 Espresso 提供桩结果对象,以响应对“contacts”intent 的所有调用:
intending(toPackage("com.android.contacts")).respondWith(result)
验证用于启动 activity 的操作是否会产生预期的桩结果。在本例中,示例测试会检查在启动“联系人 activity”时是否返回并显示电话号码 "123-345-6789":
onView(withId(R.id.pickButton)).perform(click()) onView(withId(R.id.phoneNumber)).check(matches(withText(phoneNumber)))
下面是完整的 activityResult_DisplaysContactsPhoneNumber() 测试:
@Test fun activityResult_DisplaysContactsPhoneNumber() { // Build the result to return when the activity is launched. val resultData = Intent() val phoneNumber = "123-345-6789" resultData.putExtra("phone", phoneNumber) val result = Instrumentation.ActivityResult(Activity.RESULT_OK, resultData) // Set up result stubbing when an intent sent to "contacts" is seen. intending(toPackage("com.android.contacts")).respondWith(result) // User action that results in "contacts" activity being launched. // Launching activity expects phoneNumber to be returned and displayed. onView(withId(R.id.pickButton)).perform(click()) // Assert that the data we set up above is shown. onView(withId(R.id.phoneNumber)).check(matches(withText(phoneNumber))) }
其他资源
如需详细了解如何在 Android 测试中使用 Espresso-Intents,请参阅以下资源。
示例
- IntentsBasicSample:
intended()和intending()的基本用法。 - IntentsAdvancedSample:模拟用户使用相机获取位图。