使用Espresso实现图库选图及ImageView显示验证的技术问询

我之前也碰到过类似的需求，Espresso处理系统应用跳转确实有点绕，不过用Espresso Intents模拟外部应用返回结果就能搞定，下面一步步给你说怎么实现：

1. 准备依赖 #

先确保你的Module级build.gradle里添加了必要的测试依赖：

// Espresso核心与Intents依赖
androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'
androidTestImplementation 'androidx.test.espresso:espresso-intents:3.5.1'
// 权限与测试规则依赖
androidTestImplementation 'androidx.test:rules:1.5.0'
androidTestImplementation 'androidx.test:runner:1.5.2'

2. 完整测试代码实现 #

2.1 初始化测试环境 #

用IntentsTestRule管理Activity和Intents的生命周期，同时自动授予存储权限：

@RunWith(AndroidJUnit4::class)
class ImagePickerTest {

    // 管理目标Activity与Intents
    @get:Rule
    val activityRule = IntentsTestRule(MainActivity::class.java)

    // 自动授予读取外部存储权限
    @get:Rule
    val grantPermissionRule = GrantPermissionRule.grant(
        android.Manifest.permission.READ_EXTERNAL_STORAGE
    )

2.2 核心测试逻辑 #

拦截图库跳转的Intent，模拟返回测试图片Uri，然后验证ImageView的显示：

@Test
    fun selectGalleryImage_displaysInImageView() {
        // 1. 创建测试用的图片Uri（用FileProvider生成安全Uri）
        val testImageUri = createTestImageUri()

        // 2. 拦截图库的选择Intent，模拟返回选中的图片
        intending(IntentMatchers.hasAction(Intent.ACTION_GET_CONTENT))
            .respondWith(Instrumentation.ActivityResult(Activity.RESULT_OK, Intent().setData(testImageUri)))

        // 3. 点击打开图库的ImageButton
        onView(withId(R.id.gallery_open_button))
            .perform(click())

        // 4. 验证ImageView是否显示了目标图片
        onView(withId(R.id.image_preview))
            .check(matches(hasMatchingImageUri(testImageUri)))
    }

2.3 辅助方法：生成测试图片Uri #

创建临时测试图片，用FileProvider生成符合Android权限要求的Uri：

private fun createTestImageUri(): Uri {
        val context = InstrumentationRegistry.getInstrumentation().targetContext
        // 在缓存目录创建临时图片文件
        val testImage = File(context.cacheDir, "test_sample.jpg")
        testImage.createNewFile()
        
        // 用FileProvider生成安全Uri（需提前配置FileProvider）
        return FileProvider.getUriForFile(
            context,
            "${context.packageName}.fileprovider",
            testImage
        )
    }

2.4 自定义Matcher：验证ImageView的图片Uri #

Espresso没有内置的图片Uri匹配器，我们自己写一个：

private fun hasMatchingImageUri(expectedUri: Uri): Matcher<View> {
        return object : TypeSafeMatcher<View>() {
            override fun describeTo(description: Description?) {
                description?.appendText("ImageView应加载Uri为$expectedUri的图片")
            }

            override fun matchesSafely(item: View?): Boolean {
                if (item !is ImageView) return false
                
                // 这里假设你把选中的Uri存在了ImageView的tag里，可根据你的实际逻辑调整
                // 如果用Glide/Picasso等加载库，可改用对应测试工具验证加载源
                val loadedUri = item.tag as? Uri
                return loadedUri == expectedUri
            }
        }
    }
}

3. 关键配置注意事项 #

• FileProvider配置：Android N及以上必须配置FileProvider才能安全共享文件Uri，在AndroidManifest.xml添加：

<provider
    android:name="androidx.core.content.FileProvider"
    android:authorities="${applicationId}.fileprovider"
    android:exported="false"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/file_paths" />
</provider>

然后在res/xml下创建file_paths.xml：

<?xml version="1.0" encoding="utf-8"?>
<paths>
    <cache-path name="test_images" path="." />
</paths>

• 图片加载库适配：如果用Glide/Picasso加载图片，需要调整验证逻辑，比如用Glide的测试扩展库检查加载的Uri。

内容的提问来源于stack exchange，提问作者david benalal