Testowanie układu tworzenia wiadomości

Przetestuj interfejs aplikacji, aby sprawdzić, czy kod tworzenia wiadomości działa prawidłowo. Dzięki temu możesz wcześnie wykrywać błędy i poprawiać jakość aplikacji.

Compose udostępnia zestaw testowych interfejsów API do znajdowania elementów, weryfikowania ich atrybutów i wykonywania działań użytkowników. Interfejsy API zawierają też zaawansowane funkcje, takie jak manipulowanie czasem. Korzystaj z tych interfejsów API, aby tworzyć niezawodne testy, które sprawdzają działanie aplikacji.

Wyświetlenia

Jeśli pracujesz z widokami, a nie z Compose, zapoznaj się z ogólnymi informacjami w sekcji Testowanie aplikacji na Androidzie.

Dobrym punktem wyjścia jest w szczególności przewodnik Automatyzacja testów interfejsu użytkownika. Pokazuje on, jak zautomatyzować testy wykonywane na urządzeniu, w tym przy użyciu widoków.

Kluczowe pojęcia

Poniżej przedstawiamy kilka najważniejszych koncepcji dotyczących testowania kodu Compose.

• Semantyka: testy komponowania współpracują z interfejsem za pomocą semantyki, która nadaje znaczenie elementom interfejsu i jest generowana wraz z hierarchią interfejsu.
• Interfejsy API do testowania: Compose udostępnia interfejsy API do testowania, które umożliwiają znajdowanie elementów, tworzenie twierdzeń dotyczących ich stanu i właściwości oraz wykonywanie działań w celu symulowania interakcji z użytkownikiem.
• Synchronizacja: domyślnie testy funkcji tworzenia wiadomości są automatycznie synchronizowane z interfejsem użytkownika i czekają na stan bezczynności przed wykonywaniem asercji lub wykonywaniem innych czynności.
• Współpraca: w aplikacjach hybrydowych testy mogą bezproblemowo współpracować z elementami opartymi na Compose i View oraz integrować się z innymi frameworkami testowymi.

Ściągawka dotycząca testowania

Aby poznać wszystkie najważniejsze tematy związane z testowaniem w Compose, zapoznaj się z ściągawką dotyczącą testów.

Konfiguracja

Skonfiguruj aplikację, aby umożliwić testowanie kodu Compose.

Najpierw dodaj do pliku build.gradle modułu zawierającego testy UI te zależności:

// Test rules and transitive dependencies:
androidTestImplementation("androidx.compose.ui:ui-test-junit4:$compose_version")
// Needed for createComposeRule(), but not for createAndroidComposeRule<YourActivity>():
debugImplementation("androidx.compose.ui:ui-test-manifest:$compose_version")

Moduł ten zawiera ComposeTestRule i implementację AndroidComposeTestRule na Androida. Dzięki tej regule możesz ustawić tworzenie treści lub uzyskać dostęp do aktywności. Reguły tworzysz przy użyciu funkcji fabrycznych: createComposeRule lub createAndroidComposeRule – jeśli potrzebujesz dostępu do aktywności. Typowy test interfejsu Compose wygląda tak:

// file: app/src/androidTest/java/com/package/MyComposeTest.kt

class MyComposeTest {

    @get:Rule val composeTestRule = createComposeRule()
    // use createAndroidComposeRule<YourActivity>() if you need access to
    // an activity

    @Test
    fun myTest() {
        // Start the app
        composeTestRule.setContent {
            MyAppTheme {
                MainScreen(uiState = fakeUiState, /*...*/)
            }
        }

        composeTestRule.onNodeWithText("Continue").performClick()

        composeTestRule.onNodeWithText("Welcome").assertIsDisplayed()
    }
}

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 przeprowadzane bezpośrednio na urządzeniu.
• Tryb ciągłej integracji: tryb ciągłej integracji umożliwia zintegrowanie testów z potokiem wdrożeniowym.
• Przetestuj różne rozmiary ekranów: warto przetestować różne rozmiary ekranów w przypadku dużej liczby urządzeń dostępnych dla użytkowników.
• Espresso: chociaż wiedza o Espresso jest przeznaczona dla interfejsu opartego na widoku, może okazać się przydatna w niektórych aspektach testowania funkcji Compose.

Ćwiczenia z programowania

Aby dowiedzieć się więcej, skorzystaj z kompilacji kodu testowego Jetpack Compose.

Próbki