如何为Google指纹认证API BiometricPrompt编写Espresso测试？

嘿，作为Espresso新手，要搞定BiometricPrompt的测试确实需要借助官方提供的测试工具——毕竟咱们总不能在测试机上反复摸指纹传感器对吧？下面我给你一步步拆解具体怎么做：

第一步：添加必要的测试依赖 #

首先得在你的模块级build.gradle（或build.gradle.kts）里加上Biometric测试相关的依赖，官方专门提供了用于模拟指纹认证的库：

dependencies {
    // 基础Espresso依赖
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'
    androidTestImplementation 'androidx.test.ext:junit:1.1.5'
    
    // Biometric测试专用库
    androidTestImplementation 'androidx.biometric:biometric-testing:1.2.0-alpha05'
}

第二步：模拟BiometricPrompt的认证行为 #

官方的biometric-testing库提供了BiometricPromptTestUtils类，能帮我们模拟指纹认证的各种场景，完全不用依赖真实硬件。

测试指纹认证成功的场景 #

假设你的Activity里有个按钮btn_authenticate，点击后会弹出BiometricPrompt，认证成功后会显示文本tv_success_message。测试用例可以这么写：

@RunWith(AndroidJUnit4::class)
class BiometricAuthTest {

    @get:Rule
    val activityScenarioRule = ActivityScenarioRule(MainActivity::class.java)

    @Test
    fun testBiometricAuthenticationSuccess() {
        // 1. 点击触发指纹认证的按钮
        onView(withId(R.id.btn_authenticate))
            .perform(click())

        // 2. 模拟指纹认证成功
        BiometricPromptTestUtils.authenticateSuccess(activityScenarioRule.scenario)

        // 3. 验证成功提示是否显示
        onView(withId(R.id.tv_success_message))
            .check(matches(isDisplayed()))
    }
}

测试指纹认证失败的场景 #

如果要测试指纹识别失败的情况（比如用户输错指纹），可以用authenticateFailure方法指定错误类型：

@Test
fun testBiometricAuthenticationFailure() {
    onView(withId(R.id.btn_authenticate))
        .perform(click())

    // 模拟指纹不匹配的失败场景
    BiometricPromptTestUtils.authenticateFailure(
        activityScenarioRule.scenario,
        BiometricPrompt.ERROR_NEGATIVE_BUTTON
    )

    // 验证失败提示是否显示
    onView(withId(R.id.tv_error_message))
        .check(matches(isDisplayed()))
}

测试用户取消认证的场景 #

如果用户点击了BiometricPrompt的取消按钮，我们可以直接模拟这个操作：

@Test
fun testBiometricAuthenticationCancelled() {
    onView(withId(R.id.btn_authenticate))
        .perform(click())

    // 模拟用户主动取消认证
    BiometricPromptTestUtils.cancelAuthentication(activityScenarioRule.scenario)

    // 验证取消后按钮可再次点击
    onView(withId(R.id.btn_authenticate))
        .check(matches(isEnabled()))
}

一些需要注意的细节 #

• 确保你的BiometricPrompt是在主线程创建的，Espresso测试默认在主线程执行，避免线程同步问题。
• 如果你的认证逻辑包含异步操作，可能需要用IdlingResource等待操作完成，但BiometricPromptTestUtils已经帮我们处理了大部分同步工作。
• 不同Android版本的BiometricPrompt UI有差异，但测试逻辑是通用的——官方测试库会自动适配不同版本的行为。

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