测试您的 Compose 布局

测试您的应用的 UI 以验证 Compose 代码的行为是否正确。这使您能够尽早发现错误并提高应用的质量。

Compose 提供了一组测试 API 来查找元素、验证其属性并执行用户操作。这些 API 还包括时间操作等高级功能。使用这些 API 创建稳健的测试以验证您的应用的行为。

视图

如果您使用的是视图而不是 Compose，请参阅常规的 在 Android 上测试应用 部分。

特别是，一个好的起点是 自动化 UI 测试 指南。它概述了如何在设备上运行自动化测试，包括使用视图时。

关键概念

以下是测试 Compose 代码的一些关键概念。

  • 语义：Compose 测试使用语义与 UI 交互，语义赋予 UI 片段意义，并与 UI 层次结构一起生成。
  • 测试 API：Compose 提供了测试 API 用于查找元素，对元素的状态和属性进行断言，以及执行操作以模拟用户交互。
  • 同步：默认情况下，Compose 测试会自动与 UI 同步，等待 UI 空闲后才进行断言或执行操作。
  • 互操作性：在混合应用中，测试可以无缝地与 Compose 和基于 View 的元素进行交互，并与其他测试框架集成。

测试备忘单

请参阅 测试备忘单，了解有关 Compose 中测试的所有关键主题的概述。

设置

设置您的应用以允许您测试 Compose 代码。

首先，将以下依赖项添加到包含 UI 测试的模块的 build.gradle 文件中

// Test rules and transitive dependencies:
androidTestImplementation("androidx.compose.ui:ui-test-junit4:$compose_version")
// Needed for createComposeRule(), but not for createAndroidComposeRule<YourActivity>():
debugImplementation("androidx.compose.ui:ui-test-manifest:$compose_version")

此模块包含一个 ComposeTestRule 和一个名为 AndroidComposeTestRule 的 Android 实现。通过此规则，您可以设置 Compose 内容或访问 Activity。您可以使用工厂函数构建规则，即 createComposeRule 或（如果您需要访问 Activity）createAndroidComposeRule。Compose 的典型 UI 测试如下所示

// file: app/src/androidTest/java/com/package/MyComposeTest.kt

class MyComposeTest {

    @get:Rule val composeTestRule = createComposeRule()
    // use createAndroidComposeRule<YourActivity>() if you need access to
    // an activity

    @Test
    fun myTest() {
        // Start the app
        composeTestRule.setContent {
            MyAppTheme {
                MainScreen(uiState = fakeUiState, /*...*/)
            }
        }

        composeTestRule.onNodeWithText("Continue").performClick()

        composeTestRule.onNodeWithText("Welcome").assertIsDisplayed()
    }
}

其他资源

  • 在 Android 上测试应用：主要的 Android 测试登陆页面提供了更广泛的测试基础知识和技术的概述。
  • 测试基础知识：详细了解 Android 应用测试背后的核心概念。
  • 本地测试：您可以在本地（您自己的工作站上）运行一些测试。
  • 工具测试：最好也运行工具测试。也就是说，直接在设备上运行的测试。
  • 持续集成：持续集成允许您将测试集成到部署管道中。
  • 测试不同的屏幕尺寸：由于用户可以使用多种设备，因此您应该测试不同的屏幕尺寸。
  • Espresso：虽然旨在用于基于 View 的 UI，但 Espresso 知识对于 Compose 测试的某些方面仍然很有帮助。

Codelab

要了解更多信息，请尝试 Jetpack Compose 测试 Codelab。

示例