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 drzewo semantycznego), aby tworzyć asercje lub wykonywać na nich działania.
- Asercje służą do sprawdzania, czy elementy istnieją lub mają określone .
- Działania pozwalają wstawiać do elementów symulowane zdarzenia użytkownika, takie jak kliknięcia czy inne gesty.
Niektóre z tych interfejsów API akceptują właściwość SemanticsMatcher
odwołującą się do co najmniej jednego
węzłów w drzewie semantyki.
Wyszukiwanie
Za pomocą onNode
i onAllNodes
możesz wybrać co najmniej 1 węzeł
ale możesz też korzystać z wyszukiwarki dogodnej, by znaleźć najpopularniejsze
wyszukiwania, takie jak onNodeWithText
, oraz
onNodeWithContentDescription
. Pełną listę możesz przejrzeć w
Ściągawka dotycząca funkcji 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 plik z dwoma elementami tekstowymi, powoduje scalenie 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ć
Od useUnmergedTree
do 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. Na przykład tutaj
jest używany w wyszukiwarce onNodeWithText
.
composeTestRule
.onNodeWithText("World", useUnmergedTree = true).assertIsDisplayed()
Asercje
Sprawdź asercje, wywołując metodę assert()
w systemie SemanticsNodeInteraction
zwracane przez znalazcę z co najmniej jednym 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 wygodnych w przypadku najpopularniejszych asercji, 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ę możesz przejrzeć w Ściągawka dotycząca funkcji Compose Testing
Dopasowania
Do testowania funkcji tworzenia wiadomości możesz korzystać z różnych funkcji dopasowywania w kodzie.
Hierarchiczne dopasowania
Dopasowania hierarchiczne umożliwiają przewijanie w górę lub w dół drzewa semantycznego i skuteczność dopasowania.
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ą powodować, jest bardziej czytelny.
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 Androidzie: główne testy na Androidzie. daje szersze spojrzenie na podstawy i techniki testowania.
- Podstawy testowania: więcej informacji o podstawowych koncepcjach testowania aplikacji na Androida.
- Testy lokalne: możesz przeprowadzić testy. lokalnie, na własnej stacji roboczej.
- Testy instrumentowane: są dobre. w ramach testów instrumentalnych. Oznacza to, że testy przeprowadzane bezpośrednio na urządzeniu.
- Tryb ciągłej integracji: Tryb ciągłej integracji umożliwia integrowanie testów we wdrożeniu potoku.
- Testowanie różnych rozmiarów ekranu: za pomocą dostępnych dla użytkowników jest bardzo wiele urządzeń, należy przetestować różne urządzenia rozmiarów reklam Google Ads.
- Espresso: chociaż jest przeznaczony do obsługi widoków Interfejsy użytkownika i język espresso mogą też być przydatne w niektórych aspektach funkcji Compose i testowania.