Test

Compose'un createComposeRule()'u gibi pencere olmadan çalışan arayüz testleri: bir composable'ı kompoze edin, düğümleri bulun, onlar üzerinde işlem yapın ve sonucu kontrol edin; animasyonları ve coroutine'leri deterministik kılan sanal bir saatle.

#İlk test

ComposeTestRule, içeriğini ekransız (headless) olarak, sabit boyutlu bir metin ölçücüyle kompoze eder, yerleştirir ve çizer. Düğümleri metne, içerik açıklamasına ya da test etiketine göre bulun, onlar üzerinde işlem yapın ve doğrulayın:

#include <kompoz/testing.hpp>
using namespace kompoz::testing;

void Counter() {
auto count = remember([] { return mutableStateOf(0); });
Column([&] {
Text("Count: " + std::to_string(count.get()));
Button([count] { count.set(count.get() + 1); }, [] { Text("Add"); });
});
}

void counterIncrements() {
ComposeTestRule rule([] { Counter(); });
rule.onNodeWithText("Count: 0").assertIsDisplayed();
rule.onNodeWithText("Add").performClick();
rule.onNodeWithText("Count: 1").assertIsDisplayed();
}

Başarısız bir doğrulama, neyi aradığını ve ne bulduğunu söyleyen bir kompoz::testing::AssertionError fırlatır. Herhangi bir test çatısını kullanın ya da hiçbirini: rule sade bir fonksiyon içinde de çalışır.

#Bir test hedefi kurmak

Testlerin yalnızca çekirdek kütüphaneye ihtiyacı vardır, pencere sistemine değil:

add_executable(myapp_tests tests/main.cpp src/screens.cpp)
target_link_libraries(myapp_tests PRIVATE kompoz_core)
add_test(NAME myapp_tests COMMAND myapp_tests)

Composable'larınızı uygulamanın ve testlerin paylaştığı kaynak dosyalarda tutun. Ekranı ya da SDL'i olmayan bir derleme sunucusunda Kompoz'u -DKOMPOZ_BUILD_SDL3=OFF ile derleyin.

#Düğümleri bulmak

Compose'da olduğu gibi bulucular birleştirilmiş semantiği kullanır: bir tıklanabilirin içindeki metin o tıklanabilir adına yanıt verir; böylece onNodeWithText("Add").performClick() butona tıklar ve assertIsEnabled() onu kontrol eder.

Metni değişen ya da çevrilen bir şeyi bulmanın en sağlam yolu bir test etiketidir:

void Search() {
auto query = rememberTextFieldState();
OutlinedTextField(query, Modifier().testTag("search"), {.label = "Search"});
}

void typingFillsTheField() {
ComposeTestRule rule([] { Search(); });
rule.onNodeWithTag("search").performTextInput("kompoz");
rule.onNodeWithText("kompoz").assertExists();
}

#İşlemler

Her işlem ardından arayüzün durulmasını bekler.

#Doğrulamalar

assertExists, assertDoesNotExist, assertIsDisplayed (pencerede, kırpılıp gizlenmemiş), assertIsNotDisplayed, assertTextEquals, assertTextContains, assertContentDescriptionEquals, assertHasClickAction, assertIsEnabled, assertIsNotEnabled, assertIsSelected (seçili bir sekme, işaretli bir checkbox, açık bir anahtar), assertIsOn, assertIsOff. Düğümü döndürdükleri için zincirlenebilirler:

rule.onNodeWithText("Save").assertIsDisplayed().assertIsEnabled().performClick();

Diğer her şey için bir düğüm bounds()'unu (dp cinsinden, pencere içinde) ve text()'ini verir, bir de exists() vardır. rule.drawnTexts() gerçekten çizilen metinleri listeler; ekrana neyin ulaştığını kontrol etmek için.

#Zaman

Rule'un saati sanaldır: zaman yalnızca test öyle dediğinde ilerler; böylece animasyonlar, gecikmeler ve coroutine'ler her çalıştırmada aynı sonucu verir.

• rule.waitForIdle() bekleyen hiçbir şey kalmayana kadar kare çalıştırır: recomposition, yerleşim ve birkaç saniye içinde vakti gelen zamanlayıcılar.
• rule.advanceTimeBy(ms) saati ileri alır ve aradaki kareleri çalıştırır.
• rule.advanceFrame() bir kare çalıştırır.

void Toast(bool show) {
auto visible = remember([] { return mutableStateOf(false); });
LaunchedEffect(show, [show, visible]() -> Task {
if (!show) co_return;
visible.set(true);
co_await delay(std::chrono::seconds(2));
visible.set(false);
});
if (visible.get()) Text("Saved");
}

void toastGoesAwayAfterTwoSeconds() {
ComposeTestRule rule([] { Toast(true); });
rule.onNodeWithText("Saved").assertExists();
rule.advanceTimeBy(2100);
rule.onNodeWithText("Saved").assertDoesNotExist();
}

withBackground'a verilen işler gerçek thread'lerde çalışır; waitForIdle bitmelerini bekler.

#Testin gösterdiğini değiştirmek

İçerik lambda'sı testin sahip olduğu durumu okuyabilir; böylece test onu adımlar arasında değiştirebilir:

void showsTheNewName() {
auto name = mutableStateOf(std::string("Ada"));
ComposeTestRule rule([name] { Text("Hello, " + name.get()); });
rule.onNodeWithText("Hello, Ada").assertExists();
name.set("Grace");
rule.waitForIdle();
rule.onNodeWithText("Hello, Grace").assertExists();
}

rule.host() host'u verir; platformun değiştireceği şeyleri değiştirmek için: setSystemDarkTheme(true), setLayoutDirection(LayoutDirection::Rtl), setStrings(Strings::turkish()). Rule kurucusunun ikinci argümanı pencerenin dp cinsinden boyutudur, varsayılanı {400, 800}.

#Neyi test etmeli

• Durumsuz composable'lar en kolayıdır: veriyi verin, gösterileni kontrol edin, olayların geri çağrıldığını kontrol edin. Durumu yukarı taşımak (bkz. Durum) arayüzünüzün çoğunu bu şekilde test edilebilir kılar.
• ViewModel'lar ve diğer mantık sade C++ nesneleridir: onları hiç rule olmadan test edin.
• ViewModel'larıyla birlikte ekranlar: rule onları uygulamanın yapacağı gibi kompoze eder.

#Ekran görüntüleri

Bir ekranın nasıl göründüğünü kontrol etmek için gerçek uygulamayı bir betikle ekransız çalıştırın ve kaydettiği resimleri karşılaştırın; bkz. Araçlar.

#Ayrıca bakın

• Erişilebilirlik: bulucuların kullandığı semantik.
• Mimari: kodu test etmesi kolay olacak biçimde yapılandırmak.
• Araçlar: gerçek uygulamanın betikli çalıştırmaları.