混合（Compose+XML）项目中Espresso无法定位Composable内文本的问题

问题说明 #

在Compose与XML混合的Android项目中，尝试用Espresso的onView(withText("FindMeText"))定位Composable中的文本时，出现报错：

No views in hierarchy found matching: an instance of android.widget.TextView and view.getText() with or without transformation to match: is "FindMeText"

无法直接使用createAndroidComposeRule的setContent方法初始化CustomCheckbox，因为该Composable需要大量输入参数，且已由Activity完成初始化。

项目关键代码如下：

MainActivity代码 #

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        findViewById<ComposeView>(R.id.my_composable).setContent {
            CustomCheckbox()
        }
    }
}

CustomCheckbox Composable代码 #

@Composable
fun CustomCheckbox(){
    Row(Modifier.background(color = Color.DarkGray)){
        Button(onClick =  {}){
            Text("FindMeText")
        }
        Checkbox(checked = true, onCheckedChange = {})
    }
}

原测试代码（失败） #

class MainActivityTest(){
    @get:Rule
    var activityScenarioRule = activityScenarioRule<MainActivity>()

    @Test
    fun findTextInComposeViewFail() {
        onView(withText("FindMeText")).perform(click())
    }
}

原因分析 #

Espresso的onView方法默认扫描Android原生View层级，而Compose中的Text组件是Compose独立的UI节点，并非原生TextView，因此直接用withText无法匹配到目标内容。

解决方案 #

方案1：使用Espresso与Compose测试的互操作API #

通过Espresso定位到XML中的ComposeView，再调用Compose测试API在其内部执行操作：

class MainActivityTest {
    @get:Rule
    val activityScenarioRule = activityScenarioRule<MainActivity>()

    @Test
    fun findTextInComposeViewSuccess() {
        // 定位到XML中的ComposeView
        onView(withId(R.id.my_composable))
            // 在ComposeView内部执行Compose测试操作
            .perform(clickInComposable {
                onNodeWithText("FindMeText").performClick()
            })
    }
}

方案2：使用createAndroidComposeRule直接访问已加载的Compose内容 #

无需手动调用setContent，createAndroidComposeRule会自动启动Activity并关联已初始化的Composable内容：

class MainActivityTest {
    @get:Rule
    val composeTestRule = createAndroidComposeRule<MainActivity>()

    @Test
    fun findTextInComposeViewSuccess() {
        // 直接定位Compose中的文本节点并执行点击
        composeTestRule.onNodeWithText("FindMeText").performClick()
    }
}

依赖要求 #

确保项目中已添加Compose测试相关依赖：

androidTestImplementation "androidx.compose.ui:ui-test-junit4:${compose_version}"
debugImplementation "androidx.compose.ui:ui-test-manifest:${compose_version}"

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