Z elementami interfejsu możesz wchodzić w interakcje z elementami interfejsu na 3 główne sposoby:
- Findery umożliwiają wybór jednego lub wielu elementów (albo węzłów w drzewie semantycznym), aby tworzyć asercje lub wykonywać na nich działania.
- Asercje służą do sprawdzania, czy elementy istnieją lub mają określone atrybuty.
- Działania służą do wstrzykiwania do elementów symulowanych zdarzeń użytkownika, takich jak kliknięcia lub inne gesty.
Niektóre z tych interfejsów API akceptują obiekt SemanticsMatcher
, aby odwoływać się do co najmniej 1 węzła w drzewie semantyki.
Wyszukiwanie
Za pomocą onNode
i onAllNodes
możesz wybierać odpowiednio 1 lub kilka węzłów, ale możesz też korzystać z najprostszych funkcji wyszukiwania, takich jak onNodeWithText
czy onNodeWithContentDescription
. Pełną listę znajdziesz w ściągawce dotyczącej Compose Testing.
Wybierz jeden węzeł
composeTestRule.onNode(<<SemanticsMatcher>>, useUnmergedTree = false): SemanticsNodeInteraction
// Example
composeTestRule
.onNode(hasText("Button")) // Equivalent to onNodeWithText("Button")
Wybierz wiele węzłów
composeTestRule
.onAllNodes(<<SemanticsMatcher>>): SemanticsNodeInteractionCollection
// Example
composeTestRule
.onAllNodes(hasText("Button")) // Equivalent to onAllNodesWithText("Button")
Rozdzielone drzewo
Niektóre węzły scalają informacje semantyczne swoich elementów podrzędnych. Na przykład przycisk z 2 elementami tekstowymi służy do łączenia etykiet elementów tekstowych:
MyButton {
Text("Hello")
Text("World")
}
W teście użyj narzędzia printToLog()
, aby wyświetlić drzewo semantyki:
composeTestRule.onRoot().printToLog("TAG")
Ten kod generuje następujące dane wyjściowe:
Node #1 at (...)px
|-Node #2 at (...)px
Role = 'Button'
Text = '[Hello, World]'
Actions = [OnClick, GetTextLayoutResult]
MergeDescendants = 'true'
Jeśli chcesz dopasować węzeł rozdzielonego drzewa, możesz ustawić useUnmergedTree
na true
:
composeTestRule.onRoot(useUnmergedTree = true).printToLog("TAG")
Ten kod generuje następujące dane wyjściowe:
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]'
Parametr useUnmergedTree
jest dostępny we wszystkich wynikach wyszukiwania. Tutaj jest używany na przykład w wyszukiwarce onNodeWithText
.
composeTestRule
.onNodeWithText("World", useUnmergedTree = true).assertIsDisplayed()
Asercje
Aby sprawdzić asercje, wywołaj assert()
w elemencie SemanticsNodeInteraction
zwróconym przez wyszukiwanie z co najmniej 1 dopasowaniem:
// 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"))
W przypadku najczęstszych asercji możesz też używać funkcji wygodnych, takich jak assertExists
, assertIsDisplayed
i assertTextEquals
.
Pełną listę znajdziesz w ściągawce dotyczącej Compose Testing.
Istnieją też funkcje służące do sprawdzania asercji w zbiorze węzłów:
// 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())
Działania
Aby wprowadzić działanie na węźle, wywołaj funkcję perform…()
:
composeTestRule.onNode(...).performClick()
Oto kilka przykładów działań:
performClick(),
performSemanticsAction(key),
performKeyPress(keyEvent),
performGesture { swipeLeft() }
Pełną listę znajdziesz w ściągawce dotyczącej Compose Testing.
Dopasowania
Do testowania kodu tworzenia wiadomości dostępne są różne moduły dopasowania.
Hierarchiczne dopasowania
Dopasowania hierarchiczne umożliwiają przewijanie w górę lub w dół drzewa semantycznego i przeprowadzanie dopasowywania.
fun hasParent(matcher: SemanticsMatcher): SemanticsMatcher
fun hasAnySibling(matcher: SemanticsMatcher): SemanticsMatcher
fun hasAnyAncestor(matcher: SemanticsMatcher): SemanticsMatcher
fun hasAnyDescendant(matcher: SemanticsMatcher): SemanticsMatcher
Oto kilka przykładów użycia tych dopasowań:
composeTestRule.onNode(hasParent(hasText("Button")))
.assertIsDisplayed()
Selektory
Alternatywnym sposobem tworzenia testów jest użycie selektorów, które mogą zwiększyć czytelność niektórych testów.
composeTestRule.onNode(hasTestTag("Players"))
.onChildren()
.filter(hasClickAction())
.assertCountEquals(4)
.onFirst()
.assert(hasText("John"))
Pełną listę znajdziesz w ściągawce dotyczącej Compose Testing.
Dodatkowe materiały
- Testowanie aplikacji na Androida: główna strona docelowa testowania na Androida zawiera szersze omówienie podstaw i technik testowania.
- Podstawy testowania: dowiedz się więcej o podstawowych założeniach testowania aplikacji na Androida.
- Testy lokalne: niektóre testy możesz przeprowadzić lokalnie, na swojej stacji roboczej.
- Testy instrumentowane: warto też przeprowadzać testy instrumentowane. Chodzi o testy przeprowadzane bezpośrednio na urządzeniu.
- Tryb ciągłej integracji: tryb ciągłej integracji umożliwia integrację testów z potokiem wdrażania.
- Przetestuj różne rozmiary ekranów: warto przetestować różne rozmiary ekranów w przypadku dużej liczby urządzeń dostępnych dla użytkowników.
- Espresso: chociaż wiedza o Espresso jest przeznaczona dla interfejsu opartego na widoku, może okazać się przydatna w niektórych aspektach testowania funkcji Compose.