JUnit を使用した Compose Multiplatform UI のテスト

デスクトップ向けの Compose Multiplatform は、JUnit と Jetpack Compose テスト API に基づくテスト API を提供します。実装の詳細については、Jetpack Compose ドキュメントの Compose レイアウトをテストするガイドを参照してください。

サポートされているすべてのプラットフォームで利用可能な UI テスト機能については、Compose Multiplatform UI のテストの記事を参照してください。

JUnit ベースのテストを実際に見てみるために、Kotlin Multiplatform ウィザードで生成されたプロジェクトから始めましょう。既存のプロジェクトにテストを追加する場合は、パスやコマンド内の shared を、テスト対象のモジュール名に置き換える必要があるかもしれません。

テストソースセットを作成し、必要な依存関係を追加します。

テスト用のディレクトリ shared/src/desktopTest/kotlin を作成します。

shared/build.gradle.kts ファイルに、以下の依存関係を追加します。

kotlin

kotlin { 
    //...
    sourceSets { 
        //...
        val desktopTest by getting { 
            dependencies {
                implementation(compose.desktop.uiTestJUnit4)
                implementation(compose.desktop.currentOs)
            }
        }
    }
}

ExampleTest.kt という名前のテストファイルを作成し、以下のコードをそこにコピーします。

kotlin

import androidx.compose.material.*
import androidx.compose.runtime.*
import androidx.compose.ui.Modifier
import androidx.compose.ui.test.*
import androidx.compose.ui.platform.testTag
import androidx.compose.ui.test.junit4.v2.createComposeRule
import org.junit.Rule
import org.junit.Test

class ExampleTest {
    @get:Rule
    val rule = createComposeRule()

    @Test
    fun myTest(){
        // API 呼び出しを実演するためのモック UI を宣言します
        //
        // プロジェクト内のコードをテストするために、独自の宣言に置き換えてください
        rule.setContent {
            var text by remember { mutableStateOf("Hello") }

            Text(
                text = text,
                modifier = Modifier.testTag("text")
            )
            Button(
                onClick = { text = "Compose" },
                modifier = Modifier.testTag("button")
            ) {
                Text("Click me")
            }
        }

        // JUnit ベースのテスト API のアサーションとアクションを使用して、宣言された UI をテストします
        rule.onNodeWithTag("text").assertTextEquals("Hello")
        rule.onNodeWithTag("button").performClick()
        rule.onNodeWithTag("text").assertTextEquals("Compose")
    }
}

テストを実行するには、myTest() 関数の横にあるガターの実行アイコンをクリックするか、ターミナルで以下のコマンドを実行します。
shell
```
./gradlew desktopTest
```

次は？

マルチプラットフォームテストの作成と実行方法を確認する。
Kotlin プロジェクトにおける JUnit ベースのテストの一般的な概要については、JVM で JUnit を使用してコードをテストするチュートリアルを参照してください。

JUnit を使用した Compose Multiplatform UI のテスト ​

次は？ ​

JUnit を使用した Compose Multiplatform UI のテスト

次は？