使用 Espresso Device API 測試螢幕設定變更

當裝置進行常見的設定變更 (例如旋轉和螢幕展開) 時，請使用 Espresso Device API 測試應用程式。Espresso Device API 可讓您在虛擬裝置上模擬這些設定變更，並同步執行測試，因此每次只會發生一個 UI 動作或斷言，測試結果也會更可靠。如果您是第一次使用 Espresso 編寫 UI 測試，請參閱相關說明文件。

如要使用 Espresso Device API，您需要：

  • Android Studio Iguana 以上版本
  • Android Gradle 外掛程式 8.3 以上版本
  • Android Emulator 33.1.10 以上版本
  • 搭載 API 級別 24 以上版本的 Android 虛擬裝置

設定 Espresso Device API 專案

如要設定專案以支援 Espresso Device API，請按照下列步驟操作：

  1. 如要讓測試將指令傳遞至測試裝置，請在 androidTest 來源集中的資訊清單檔案中新增 INTERNET 和 ACCESS_NETWORK_STATE 權限：

      <uses-permission android:name="android.permission.INTERNET" />
  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

  2. 在 gradle.properties 檔案中啟用 enableEmulatorControl 實驗旗標：

      android.experimental.androidTest.enableEmulatorControl=true

  3. 在模組層級的建構指令碼中啟用 emulatorControl 選項：

    Kotlin

      testOptions {
    emulatorControl {
      enable = true
    }
  }

    Groovy

      testOptions {
    emulatorControl {
      enable = true
    }
  }

  4. 在模組層級的建構指令碼中，將 Espresso Device 程式庫匯入專案：

    Kotlin

      dependencies {
    androidTestImplementation("androidx.test.espresso:espresso-device:1.0.1")
  }

    Groovy

      dependencies {
    androidTestImplementation 'androidx.test.espresso:espresso-device:1.0.1'
  }

針對常見的設定變更進行測試

Espresso Device API 提供多種螢幕方向和折疊式狀態，可用於模擬裝置設定變更。

針對螢幕旋轉功能進行測試

以下範例說明如何測試裝置螢幕旋轉時，應用程式會發生什麼情況：

  1. 首先，為確保一致的啟動狀態，請將裝置設為直向模式：

      import androidx.test.espresso.device.action.ScreenOrientation
  import androidx.test.espresso.device.rules.ScreenOrientationRule
  ...
  @get:Rule
  val screenOrientationRule: ScreenOrientationRule = ScreenOrientationRule(ScreenOrientation.PORTRAIT)

  2. 建立測試，在測試執行期間將裝置設為橫向：

      @Test
  fun myRotationTest() {
    ...
    // Sets the device to landscape orientation during test execution.
    onDevice().setScreenOrientation(ScreenOrientation.LANDSCAPE)
    ...
  }

  3. 螢幕旋轉後，請確認 UI 是否如預期調整至新版面配置。

      @Test
  fun myRotationTest() {
    ...
    // Sets the device to landscape orientation during test execution.
    onDevice().setScreenOrientation(ScreenOrientation.LANDSCAPE)
    composeTestRule.onNodeWithTag("NavRail").assertIsDisplayed()
    composeTestRule.onNodeWithTag("BottomBar").assertDoesNotExist()
  }

針對螢幕展開功能進行測試

以下範例說明如何測試應用程式在可折疊裝置上展開螢幕時的情況：

  1. 首先，請呼叫 onDevice().setClosedMode()，以便在裝置處於折疊狀態時進行測試。請確認應用程式的版面配置可配合精簡螢幕寬度調整。

      @Test
  fun myUnfoldedTest() {
    onDevice().setClosedMode()
    composeTestRule.onNodeWithTag("BottomBar").assetIsDisplayed()
    composeTestRule.onNodeWithTag("NavRail").assetDoesNotExist()
    ...
  }

  2. 如要轉換至完全展開狀態，請呼叫 onDevice().setFlatMode()。檢查應用程式的版面配置是否可配合擴大的大小類別調整。

      @Test
  fun myUnfoldedTest() {
    onDevice().setClosedMode()
    ...
    onDevice().setFlatMode()
    composeTestRule.onNodeWithTag("NavRail").assertIsDisplayed()
    composeTestRule.onNodeWithTag("BottomBar").assetDoesNotExist()
  }

指定測試所需的裝置

如果您執行的測試是在非折疊式裝置上執行折疊動作，測試可能會失敗。如要只執行與執行中裝置相關的測試，請使用 @RequiresDeviceMode 註解。測試執行程式會自動略過在裝置上執行測試，如果該裝置不支援所測試的設定。您可以將裝置需求規則新增至每個測試或整個測試類別。

舉例來說，如要指定測試應只在支援展開至平面設定的裝置上執行，請在測試中加入以下 @RequiresDeviceMode 程式碼：

@Test
@RequiresDeviceMode(mode = FLAT)
fun myUnfoldedTest() {
  ...
}