如何在Jetpack Compose测试中创建页面对象/屏幕对象模型

核心思路 #

页面对象模式的核心是把每个页面的元素定位、操作逻辑封装到独立类中，测试用例只需调用这些类的方法或属性，无需关注底层定位细节。针对Jetpack Compose测试，要让页面对象持有ComposeTestRule实例，通过它完成节点的定位与操作。

1. 编写页面对象类 #

LoginPage类（封装登录页元素与操作）

import androidx.compose.ui.test.ComposeTestRule
import androidx.compose.ui.test.onNodeWithText

class LoginPage(private val composeTestRule: ComposeTestRule) {
    // 延迟获取登录按钮节点，避免页面未加载时提前初始化报错
    val loginBtn get() = composeTestRule.onNodeWithText("Login")

    // 可选：封装点击登录的操作方法，把逻辑内聚在页面对象中
    fun clickLogin() {
        loginBtn.performClick()
    }
}

HomePage类（封装首页元素与断言）

import androidx.compose.ui.test.ComposeTestRule
import androidx.compose.ui.test.onNodeWithText
import androidx.compose.ui.test.assertIsDisplayed

class HomePage(private val composeTestRule: ComposeTestRule) {
    val homeTxt get() = composeTestRule.onNodeWithText("Home")

    // 可选：封装断言首页显示的方法
    fun assertHomeIsDisplayed() {
        homeTxt.assertIsDisplayed()
    }
}

2. 修改测试类使用页面对象 #

import androidx.compose.ui.test.junit4.createAndroidComposeRule
import org.junit.Rule
import org.junit.Test

class MyComposeTest {

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

    @Test
    fun myTest() {
        // 初始化页面对象，传入ComposeTestRule实例
        val loginPage = LoginPage(composeTestRule)
        val homePage = HomePage(composeTestRule)

        // 方式1：直接操作页面对象的属性（对应你想要的简化写法）
        loginPage.loginBtn.performClick()
        homePage.homeTxt.assertIsDisplayed()

        // 方式2：调用封装好的方法（更推荐，后续UI变更只需修改页面对象）
        // loginPage.clickLogin()
        // homePage.assertHomeIsDisplayed()
    }
}

关键说明 #

• 依赖传递：页面对象必须持有ComposeTestRule实例，因为所有Compose测试的节点定位、操作、断言都需要通过这个规则执行。
• 延迟初始化：用get()语法延迟获取节点，避免测试启动时页面未渲染完成，导致找不到节点的错误。
• 逻辑内聚：推荐把操作和断言封装成方法，而非直接暴露节点。比如clickLogin()方法，后续若登录按钮的文本或定位方式改变，只需修改LoginPage内部，所有测试用例无需调整。

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