本頁面由 Cloud Translation API 翻譯而成。

測試 Compose 版面配置

測試應用程式的 UI，確認 Compose 程式碼的行為是否正確。這可讓您及早發現錯誤，並改善應用程式品質。

Compose 提供一組測試 API，可用於找出元素、驗證其屬性，以及執行使用者動作。這些 API 也包含時間操控等進階功能。您可以利用這些 API 建立完善的測試，以便驗證應用程式行為。

View

如果您使用檢視區塊，而非 Compose，請參閱一般「在 Android 上測試應用程式」一節。

建議您先參閱「自動化 UI 測試」指南。本文說明如何自動執行在裝置上執行的測試，包括使用檢視畫面。

核心概念

以下是測試 Compose 程式碼的一些重要概念。

語意：Compose 測試會使用語意與 UI 互動，為 UI 的各個部分賦予意義，並與 UI 階層一同產生。
測試 API：Compose 提供測試 API，可用於尋找元素、對其狀態和屬性做出斷言，並執行動作來模擬使用者互動。
同步處理：根據預設，Compose 測試會自動與 UI 同步處理，在發出斷言或執行動作之前，先等待測試處於閒置狀態。
互通性：在混合型應用程式中，測試能與 Compose 和以 View 為基礎的元素完美互動，並與其他測試架構整合。

測試一覽表

請參閱測試一覽表，瞭解您應學習的所有關鍵主題，以便在 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 實作。透過這項規則，您可以設定撰寫內容或存取活動。您可使用工廠函式 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()
    }
}