Testowanie interfejsów API

Z elementami interfejsu możesz wchodzić w interakcje z elementami interfejsu na 3 główne sposoby:

• Znajdowanie umożliwia wybranie co najmniej 1 elementu (lub węzła w drzewie semantycznym), aby sformułować twierdzenia lub wykonać na nich działania.
• Afirmacje służą do sprawdzania, czy elementy istnieją lub mają określone atrybuty.
• Działania umożliwiają symulowanie zdarzeń użytkownika na elementach, takich jak kliknięcia czy inne gesty.

Niektóre z tych interfejsów API akceptują parametr SemanticsMatcher, który odwołuje się do co najmniej 1 węzła w drzewie semantycznym.

Wyszukiwanie

Do wybierania jednego lub wielu węzłów możesz używać odpowiednio poleceń onNode i onAllNodes, ale w przypadku najczęstszych wyszukiwań, takich jak onNodeWithText i onNodeWithContentDescription, możesz też korzystać z wygodnych narzędzi do znajdowania. Pełną listę znajdziesz w ściągawce dotyczącej Compose Testing.

Wybieranie pojedynczego węzła

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")

Niezłączone drzewo

Niektóre węzły scalają informacje semantyczne swoich 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 ramach testu kliknij printToLog(), aby wyświetlić drzewo semantyczne:

composeTestRule.onRoot().printToLog("TAG")

Ten kod wyświetla te 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ł do drzewa, które byłoby niezjednoczonym, możesz ustawić useUnmergedTree na true:

composeTestRule.onRoot(useUnmergedTree = true).printToLog("TAG")

Ten kod wyświetla te 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. Tutaj jest on używany w finderze onNodeWithText.

composeTestRule
    .onNodeWithText("World", useUnmergedTree = true).assertIsDisplayed()

Twierdzenia

Sprawdź stwierdzenia, wywołując funkcję assert() dla SemanticsNodeInteractionzwracanego przez wyszukiwacz z co najmniej jednym elementem dopasowującym:

// 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 do testowania funkcji tworzenia treści.

Dostępne są też funkcje do sprawdzania asercji w kolekcji 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 Compose dostępne są różne narzędzia do dopasowywania.

Dopasowania hierarchiczne

Dopasowywacze hierarchiczne umożliwiają poruszanie się w głąb i na zewnątrz drzewa semantycznego oraz wykonywanie dopasowań.

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

Innym sposobem tworzenia testów jest używanie selekcji, które mogą ułatwić czytanie 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 z informacjami o testowaniu na Androida zawiera więcej informacji o podstawach i technikach testowania.
• Podstawy testowania: dowiedz się więcej o podstawowych założeniach testowania aplikacji na Androida.
• Testy lokalne: niektóre testy możesz przeprowadzać lokalnie na swoim komputerze.
• Testy z instrumentacją: warto też przeprowadzać testy z instrumentacją. Chodzi o testy, które są wykonywane bezpośrednio na urządzeniu.
• Tryb ciągłej integracji: tryb ciągłej integracji umożliwia integrację testów z potokiem wdrażania.
• Testowanie różnych rozmiarów ekranu: ze względu na dużą liczbę urządzeń dostępnych dla użytkowników, należy przeprowadzić testy na różnych rozmiarach ekranu.
• Espresso: chociaż jest ono przeznaczone do interfejsów użytkownika opartych na widokach, znajomość Espresso może być przydatna w niektórych aspektach testowania w Compose.