このページは Cloud Translation API によって翻訳されました。

Compose レイアウトをテストする

アプリの UI をテストして、Compose コードの動作が正しいことを確認します。これにより、エラーを早期に発見し、アプリの品質を向上させることができます。

Compose には、要素の検索、属性の検証、ユーザーアクションの実行を行うための一連のテスト API が用意されています。また、時間操作などの高度な機能も含まれます。これらの API を使用して、アプリの動作を確認する堅牢なテストを作成します。

View

Compose ではなくビューを使用している場合は、一般的なAndroid でアプリをテストするをご覧ください。

特に、UI テストを自動化するガイドを参照することをおすすめします。ビューの使用時など、デバイス上で実行されるテストを自動化する方法について説明します。

主な概念

Compose コードをテストする主なコンセプトは次のとおりです。

セマンティクス: Compose テストは、UI の一部に意味を与え、UI 階層とともに生成されるセマンティクスを使用して UI を操作します。
テスト API: Compose には、要素の検索、状態とプロパティの断言、アクションの実行によるユーザー操作のシミュレーションを行うテスト API が用意されています。
同期: デフォルトでは、Compose テストは UI と自動的に同期し、UI がアイドル状態になるのを待ってから、アサーションの実行やアクションの実行を行います。
相互運用性: ハイブリッドアプリでは、テストで Compose ベースとビューベースの要素の両方をシームレスに操作し、他のテストフレームワークと統合できます。

テスト早見表

Compose でのテストについて学ぶべきすべての主要なトピックの概要については、テストのクイックリファレンスをご覧ください。

設定

Compose コードをテストできるようにアプリを設定します。

まず、UI テストを含むモジュールの build.gradle ファイルに次の依存関係を追加します。

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

このモジュールには、ComposeTestRule と、AndroidComposeTestRule と呼ばれる Android 用の実装が含まれています。このルールを通じて、Compose コンテンツを設定したり、アクティビティにアクセスしたりできます。ルールは、ファクトリ関数（createComposeRule）または（アクティビティにアクセスする必要がある場合は createAndroidComposeRule）を使用して作成します。Compose の一般的な UI テストは次のようになります。

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