测试 API

与 UI 元素交互主要有三种方式

查找器允许您选择一个或多个元素（或语义树中的节点）以对其进行断言或执行操作。
断言用于验证元素是否存在或是否具有某些属性。
操作在元素上注入模拟的用户事件，例如点击或其他手势。

其中一些 API 接受一个SemanticsMatcher来引用语义树中的一个或多个节点。

查找器

您可以使用onNode和onAllNodes分别选择一个或多个节点，但您也可以使用便捷查找器进行最常见的搜索，例如onNodeWithText和onNodeWithContentDescription。您可以在Compose 测试备忘单中浏览完整列表。

选择单个节点

composeTestRule.onNode(<<SemanticsMatcher>>, useUnmergedTree = false): SemanticsNodeInteraction

// Example
composeTestRule
    .onNode(hasText("Button")) // Equivalent to onNodeWithText("Button")

选择多个节点

composeTestRule
    .onAllNodes(<<SemanticsMatcher>>): SemanticsNodeInteractionCollection

// Example
composeTestRule
    .onAllNodes(hasText("Button")) // Equivalent to onAllNodesWithText("Button")

未合并的树

某些节点合并了其子节点的语义信息。例如，带有两个文本元素的按钮合并了文本元素标签

MyButton {
    Text("Hello")
    Text("World")
}

从测试中，使用printToLog()显示语义树

composeTestRule.onRoot().printToLog("TAG")

此代码打印以下输出

Node #1 at (...)px
 |-Node #2 at (...)px
   Role = 'Button'
   Text = '[Hello, World]'
   Actions = [OnClick, GetTextLayoutResult]
   MergeDescendants = 'true'

如果您需要匹配未合并树的节点，可以将useUnmergedTree设置为true

composeTestRule.onRoot(useUnmergedTree = true).printToLog("TAG")

此代码打印以下输出

Node #1 at (...)px
 |-Node #2 at (...)px
   OnClick = '...'
   MergeDescendants = 'true'
    |-Node #3 at (...)px
    | Text = '[Hello]'
    |-Node #5 at (83.0, 86.0, 191.0, 135.0)px
      Text = '[World]'

所有查找器中都提供了useUnmergedTree参数。例如，此处在onNodeWithText查找器中使用它。

composeTestRule
    .onNodeWithText("World", useUnmergedTree = true).assertIsDisplayed()

断言

通过在由查找器使用一个或多个匹配器返回的SemanticsNodeInteraction上调用assert()来检查断言

// Single matcher:
composeTestRule
    .onNode(matcher)
    .assert(hasText("Button")) // hasText is a SemanticsMatcher

// Multiple matchers can use and / or
composeTestRule
    .onNode(matcher).assert(hasText("Button") or hasText("Button2"))

您还可以使用便捷函数进行最常见的断言，例如assertExists、assertIsDisplayed和assertTextEquals。您可以在Compose 测试备忘单中浏览完整列表。

还有一些函数可以检查节点集合上的断言

// Check number of matched nodes
composeTestRule
    .onAllNodesWithContentDescription("Beatle").assertCountEquals(4)
// At least one matches
composeTestRule
    .onAllNodesWithContentDescription("Beatle").assertAny(hasTestTag("Drummer"))
// All of them match
composeTestRule
    .onAllNodesWithContentDescription("Beatle").assertAll(hasClickAction())

操作

要在节点上注入操作，请调用perform…()函数

composeTestRule.onNode(...).performClick()

以下是一些操作示例

performClick(),
performSemanticsAction(key),
performKeyPress(keyEvent),
performGesture { swipeLeft() }

您可以在Compose 测试备忘单中浏览完整列表。

匹配器

有多种匹配器可用于测试您的 Compose 代码。

分层匹配器

分层匹配器允许您向上或向下遍历语义树并执行匹配。

fun hasParent(matcher: SemanticsMatcher): SemanticsMatcher
fun hasAnySibling(matcher: SemanticsMatcher): SemanticsMatcher
fun hasAnyAncestor(matcher: SemanticsMatcher): SemanticsMatcher
fun hasAnyDescendant(matcher: SemanticsMatcher):  SemanticsMatcher

以下是一些使用这些匹配器的示例

composeTestRule.onNode(hasParent(hasText("Button")))
    .assertIsDisplayed()

选择器

创建测试的另一种方法是使用选择器，这可以使某些测试更具可读性。

composeTestRule.onNode(hasTestTag("Players"))
    .onChildren()
    .filter(hasClickAction())
    .assertCountEquals(4)
    .onFirst()
    .assert(hasText("John"))

您可以在Compose 测试备忘单中浏览完整列表。

其他资源

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