相互運用性

Compose は一般的なテスト フレームワークと統合されています。

Espresso との相互運用

ハイブリッド アプリでは、Compose コンポーネントをビュー階層内に配置し、Compose コンポーザブル内のビューを(AndroidView コンポーザブルを介して)見つけることができます。

どちらのタイプも、マッチングするために特別な手順は必要ありません。ビューとのマッチングは Espresso の onView を使用し、Compose 要素は ComposeTestRule と照合します。

@Test
fun androidViewInteropTest() {
    // Check the initial state of a TextView that depends on a Compose state.
    Espresso.onView(withText("Hello Views")).check(matches(isDisplayed()))
    // Click on the Compose button that changes the state.
    composeTestRule.onNodeWithText("Click here").performClick()
    // Check the new value.
    Espresso.onView(withText("Hello Compose")).check(matches(isDisplayed()))
}

UiAutomator との相互運用

デフォルトでは、コンポーズ可能な要素は、便利な記述子(表示されるテキスト、コンテンツの説明など)によってのみ UiAutomator からアクセスできます。Modifier.testTag を使用するコンポーザブルにアクセスするには、特定のコンポーザブルのサブツリーでセマンティック プロパティ testTagsAsResourceId を有効にする必要があります。この動作を有効にすると、スクロール可能なコンポーザブル(LazyColumn など)など、他の一意のハンドルを持たないコンポーザブルに対して有用です。

コンポーザブルの階層の上位にある 1 回だけセマンティック プロパティを有効にして、Modifier.testTag でネストされたすべてのコンポーザブルに UiAutomator からアクセスできるようにします。

Scaffold(
    // Enables for all composables in the hierarchy.
    modifier = Modifier.semantics {
        testTagsAsResourceId = true
    }
){
    // Modifier.testTag is accessible from UiAutomator for composables nested here.
    LazyColumn(
        modifier = Modifier.testTag("myLazyColumn")
    ){
        // Content
    }
}

Modifier.testTag(tag) を持つすべてのコンポーザブルにアクセスするには、resourceName と同じ tag を使用して By.res(resourceName) を使用します。

val device = UiDevice.getInstance(getInstrumentation())

val lazyColumn: UiObject2 = device.findObject(By.res("myLazyColumn"))
// Some interaction with the lazyColumn.

その他のリソース

  • Android でアプリをテストする: Android テストのメイン ランディング ページでは、テストの基礎と手法について幅広く確認できます。
  • テストの基礎: Android アプリのテストの基本コンセプトについて説明します。
  • ローカルテスト: 一部のテストは、自分のワークステーションでローカルに実行できます。
  • インストルメンテーション テスト: インストルメンテーション テストも実行することをおすすめします。つまり、デバイス上で直接実行されるテストです。
  • 継続的インテグレーション: 継続的インテグレーションを使用すると、テストをデプロイ パイプラインに統合できます。
  • さまざまな画面サイズをテストする: ユーザーが利用できるデバイスが多数ある場合は、さまざまな画面サイズでテストする必要があります。
  • Espresso: Espresso の知識はビューベースの UI を対象としていますが、Compose テストの一部では Espresso の知識が役立ちます。