相互運用性

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

Espresso との相互運用

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

どちらのタイプも、マッチングするために特別な手順は必要ありません。ビューは 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 のテストのいくつかの側面においても役立ちます。