Istnieją 3 główne sposoby wchodzenia w interakcję z elementami interfejsu:
- Findery umożliwiają wybór jednego lub wielu elementów (lub węzłów w drzewie semantycznym) do tworzenia asercji lub wykonywania na nich działań.
- Assercje służą do sprawdzania, czy elementy istnieją lub mają określone atrybuty.
- Działania mogą wstrzykiwać do elementów symulowane zdarzenia użytkownika, np. kliknięcia lub inne gesty.
Niektóre z tych interfejsów API akceptują SemanticsMatcher
, aby odwołać się do co najmniej 1 węzła w drzewie semantycznym.
Wykrywacze
Za pomocą onNode
i onAllNodes
możesz wybrać 1 węzeł lub wiele węzłów, ale w przypadku najczęstszych wyszukiwań, takich jak onNodeWithText
czy onNodeWithContentDescription
, możesz też korzystać z narzędzi, które zapewniają wygodę. Pełną listę możesz przejrzeć w ściągawce dotyczącej testowania tworzenia wiadomości.
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")
Rozdzielono drzewo
Niektóre węzły scalają informacje o semantyce elementów podrzędnych. Na przykład przycisk z 2 elementami tekstowymi powoduje scalenie etykiet elementów tekstowych:
MyButton {
Text("Hello")
Text("World")
}
Na poziomie testu użyj narzędzia printToLog()
, aby wyświetlić drzewo semantyczne:
composeTestRule.onRoot().printToLog("TAG")
Ten kod wyświetla 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ł, dla którego byłoby rozdzielone drzewo, możesz ustawić useUnmergedTree
na true
:
composeTestRule.onRoot(useUnmergedTree = true).printToLog("TAG")
Ten kod wyświetla 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 wyszukiwarkach. Na przykład jest on używany w wyszukiwarce onNodeWithText
.
composeTestRule
.onNodeWithText("World", useUnmergedTree = true).assertIsDisplayed()
Asercje
Sprawdź asercje, wywołując assert()
pod adresem SemanticsNodeInteraction
zwróconym przez osobę wyszukującą 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"))
Możesz też używać funkcji ułatwień dostępu do najczęstszych asercji, takich jak assertExists
, assertIsDisplayed
i assertTextEquals
.
Pełną listę znajdziesz w ściągawce dotyczącej testowania tworzenia wiadomości.
Dostępne są 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 wstrzykiwać działanie w węźle, wywołaj funkcję perform…()
:
composeTestRule.onNode(...).performClick()
Oto kilka przykładów:
performClick(),
performSemanticsAction(key),
performKeyPress(keyEvent),
performGesture { swipeLeft() }
Pełną listę możesz przejrzeć w ściągawce dotyczącej testowania tworzenia wiadomości.
Dopasowania
Do testowania kodu tworzenia wiadomości dostępne są różne dopasowania.
Dopasowania hierarchiczne
Dopasowania hierarchiczne pozwalają przechodzić w górę lub w dół drzewa semantycznego i dopasowywać.
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 dopasowania:
composeTestRule.onNode(hasParent(hasText("Button")))
.assertIsDisplayed()
Selektory
Innym 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 testowania tworzenia wiadomości.
Dodatkowe materiały
- Testowanie aplikacji na Androida: główna strona docelowa testowania aplikacji na Androida zapewnia szerszy wgląd w podstawy i techniki testowania.
- Podstawy testowania: dowiedz się więcej o podstawowych pojęciach związanych z testowaniem aplikacji na Androida.
- Testy lokalne: niektóre testy możesz przeprowadzić lokalnie na własnej stacji roboczej.
- Testy z instrumentacją: warto też przeprowadzać testy z użyciem instrumentów. Oznacza to, że testy przeprowadzane bezpośrednio na urządzeniu.
- Tryb ciągłej integracji: tryb ciągłej integracji umożliwia integrację testów z potokiem wdrożenia.
- Testowanie różnych rozmiarów ekranu: użytkownicy mają do dyspozycji wiele urządzeń, dlatego warto przetestować różne rozmiary ekranów.
- Espresso: to narzędzie jest przeznaczone dla użytkowników korzystających z widoku danych, ale wiedza o espresso może być pomocna w niektórych aspektach testowania funkcji Compose.