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

測試 Compose 版面配置

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

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

View

如果您使用的是 View 而非 Compose，請參閱一般性的「在 Android 上測試應用程式」一節。

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

核心概念

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

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

測試一覽表

請參閱測試一覽表，瞭解您應學習的所有關鍵主題，以便在 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()
    }
}

其他資源

在 Android 上測試應用程式：主要的 Android 測試專頁可讓您更深入瞭解測試基礎知識和技巧。
測試基礎知識：進一步瞭解測試 Android 應用程式的核心概念。
本機測試：您可以在本機上執行部分測試。
檢測設備測試：建議您也執行檢測設備測試。也就是說，直接在裝置上執行的測試。
持續整合：持續整合可讓您將測試整合至部署管道。
測試不同螢幕大小：由於使用者可使用的裝置種類繁多，因此您應測試各種螢幕大小。
Espresso：雖然 Espresso 是為以 View 為基礎的 UI 設計，但對於 Compose 測試的某些層面，Espresso 知識仍相當實用。