使用 Espresso Device API 测试屏幕配置更改

使用 Espresso Device API 测试您的应用在设备经历常见的配置更改（例如旋转和屏幕展开）时的表现。Espresso Device API 允许您在虚拟设备上模拟这些配置更改并同步执行测试，因此一次只会发生一个 UI 操作或断言，您的测试结果也更加可靠。如果您是 Espresso UI 测试的新手，请参阅其文档。

要使用 Espresso Device API，您需要满足以下条件：

• Android Studio Iguana 或更高版本
• Android Gradle 插件 8.3 或更高版本
• Android 模拟器 33.1.10 或更高版本
• 运行 API 级别 24 或更高版本的 Android 虚拟设备

为 Espresso Device API 设置您的项目

要设置您的项目以支持 Espresso Device API，请执行以下操作：

1. 为了让测试将命令传递给测试设备，请将 INTERNET 和 ACCESS_NETWORK_STATE 权限添加到 androidTest 源集中的清单文件中

     <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() {
  ...
}