Тестирование API

Существует три основных способа взаимодействия с элементами пользовательского интерфейса:

  • Поисковики позволяют выбирать один или несколько элементов (или узлов в дереве семантики), чтобы делать утверждения или выполнять над ними действия.
  • Утверждения используются для проверки того, что элементы существуют или имеют определенные атрибуты.
  • Действия внедряют в элементы имитированные пользовательские события, такие как щелчки или другие жесты.

Некоторые из этих API принимают SemanticsMatcher для ссылки на один или несколько узлов в дереве семантики.

Искатели

Вы можете использовать onNode и onAllNodes для выбора одного или нескольких узлов соответственно, но также можете воспользоваться удобными поисковиками для наиболее распространённых запросов, такими как onNodeWithText и onNodeWithContentDescription . Полный список можно найти в шпаргалке по Compose Testing .

Выберите один узел 

composeTestRule.onNode(<<SemanticsMatcher>>, useUnmergedTree = false): SemanticsNodeInteraction 
// Example composeTestRule     .onNode(hasText("Button")) // Equivalent to onNodeWithText("Button")

Выберите несколько узлов 

composeTestRule     .onAllNodes(<<SemanticsMatcher>>): SemanticsNodeInteractionCollection 
// Example composeTestRule     .onAllNodes(hasText("Button")) // Equivalent to onAllNodesWithText("Button")

Необъединенное дерево

Некоторые узлы объединяют семантическую информацию своих дочерних элементов. Например, кнопка с двумя текстовыми элементами объединяет подписи текстовых элементов:

MyButton {     Text("Hello")     Text("World") }

В тесте используйте printToLog() для отображения дерева семантики:

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

Этот код выводит следующий результат:

Node #1 at (...)px  |-Node #2 at (...)px    Role = 'Button'    Text = '[Hello, World]'    Actions = [OnClick, GetTextLayoutResult]    MergeDescendants = 'true'

Если вам нужно сопоставить узел того, что будет необъединенным деревом, вы можете установить useUnmergedTree в true :

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

Этот код выводит следующий результат:

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]'

Параметр useUnmergedTree доступен во всех поисковиках. Например, здесь он используется в поисковике onNodeWithText . 

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

Утверждения

Проверьте утверждения, вызвав assert() для SemanticsNodeInteraction , возвращаемого поисковиком с одним или несколькими сопоставителями: 

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

Вы также можете использовать вспомогательные функции для наиболее распространённых утверждений, таких как assertExists , assertIsDisplayed и assertTextEquals . Полный список можно найти в шпаргалке по тестированию Compose .

Существуют также функции для проверки утверждений на коллекции узлов: 

// 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())

Действия

Чтобы внедрить действие в узел, вызовите функцию perform…() : 

composeTestRule.onNode(...).performClick()

Вот несколько примеров действий: 

performClick(), performSemanticsAction(key), performKeyPress(keyEvent), performGesture { swipeLeft() }

Полный список можно просмотреть в шпаргалке по тестированию Compose .

Матчеры

Для тестирования вашего кода Compose доступны различные сопоставители.

Иерархические сопоставители

Иерархические сопоставители позволяют вам перемещаться вверх или вниз по дереву семантики и выполнять сопоставление. 

fun hasParent(matcher: SemanticsMatcher): SemanticsMatcher fun hasAnySibling(matcher: SemanticsMatcher): SemanticsMatcher fun hasAnyAncestor(matcher: SemanticsMatcher): SemanticsMatcher fun hasAnyDescendant(matcher: SemanticsMatcher):  SemanticsMatcher

Вот несколько примеров использования этих сопоставителей: 

composeTestRule.onNode(hasParent(hasText("Button")))     .assertIsDisplayed()

Селекторы

Альтернативный способ создания тестов — использование селекторов , которые могут сделать некоторые тесты более читабельными. 

composeTestRule.onNode(hasTestTag("Players"))     .onChildren()     .filter(hasClickAction())     .assertCountEquals(4)     .onFirst()     .assert(hasText("John"))

Полный список можно просмотреть в шпаргалке по тестированию Compose .

Дополнительные ресурсы

  • Тестирование приложений на Android : основная целевая страница тестирования Android предоставляет более широкий обзор основ и методов тестирования.
  • Основы тестирования : узнайте больше об основных концепциях тестирования приложений для Android.
  • Локальные тесты : вы можете запустить некоторые тесты локально, на своей рабочей станции.
  • Инструментированные тесты : рекомендуется также проводить инструментированные тесты, то есть тесты, которые выполняются непосредственно на устройстве.
  • Непрерывная интеграция : Непрерывная интеграция позволяет интегрировать ваши тесты в конвейер развертывания.
  • Тестируйте разные размеры экрана . Поскольку пользователям доступно множество устройств, вам следует тестировать экраны разных размеров.
  • Espresso : хотя знание Espresso и предназначено для пользовательских интерфейсов на основе представлений, оно все равно может быть полезным для некоторых аспектов тестирования Compose.