测试 Compose 布局

测试应用的界面，以验证 Compose 代码的行为是否正确。这样，您就可以尽早发现错误并提升应用质量。

Compose 提供了一组测试 API，用于查找元素、验证其属性以及执行用户操作。这些 API 还包含时间操控等高级功能。您可以使用这些 API 创建强大的测试，以验证应用的行为。

重要提示： 如需详细了解如何对 Android 应用进行常规测试（包括测试 View 元素），请参阅“常规测试”部分。建议您从 Android 应用测试基础知识指南入手。

View

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

具体而言，最好从自动化界面测试指南入手。其中介绍了如何自动运行设备端测试，包括使用 View 时。

关键概念

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

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

测试备忘单

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

设置

设置应用以便测试 Compose 代码。

首先，将以下依赖项添加到包含界面测试的模块的 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 或 createAndroidComposeRule（如果需要访问 activity）来构建规则。Compose 的典型界面测试如下所示：

// 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：虽然 Espresso 适用于基于 View 的界面，但对于 Compose 测试的某些方面，Espresso 知识仍然很有帮助。

Codelab

如需了解详情，请参阅 Jetpack Compose 测试 Codelab。

示例

支持在单个文本字符串中添加多个链接

您可以在一条文本字符串中支持多个链接，以便用户选择要前往的位置并提高互动度。

设置文本的部分样式

您可以设置文本的部分样式，以提高可读性、提升用户体验，并通过使用颜色和字体来激发更大的创造力。

在用户输入时验证输入内容

您可以在用户在文本字段中输入内容（例如输入姓名、电子邮件地址、地址或其他联系信息）时验证输入内容。此验证可减少错误并为用户节省时间。

展开