測試 API

與 UI 元素互動的方式主要有三種：

  • Finder讓您選取一或多個元素 (或 節點 語意樹狀結構) 進行斷言或執行操作。
  • 宣告是用來驗證元素是否存在或具有特定屬性。
  • 動作會在元素上插入模擬使用者事件，例如點擊或其他手勢。

其中部分 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 Testing 一覽表中瀏覽完整清單。

比對器

有多種比對器可用於測試 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 的某些層面有所幫助 進行測試。