Testowanie interfejsów API

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.