Testar mudanças na configuração da tela com a API Espresso Device

Use a API Espresso Device para testar seu app quando o dispositivo passar por mudanças de configuração comuns, como rotação e desdobramento da tela. A API Espresso Device permite simular essas mudanças de configuração em um dispositivo virtual e executar testes de forma síncrona. Assim, apenas uma ação ou declaração de interface acontece por vez e os resultados do teste são mais confiáveis. Se você não sabe programar testes de interface com o Espresso, consulte a documentação dele.

Para usar a API Espresso Device, você precisará do seguinte:

• Android Studio Iguana ou versão mais recente
• Plug-in do Android para Gradle 8.3 ou mais recente
• Android Emulator 33.1.10 ou mais recente
• Dispositivo virtual Android com o nível 24 da API ou mais recente.

Configurar o projeto para a API Espresso Device

Para configurar o projeto para que ele ofereça suporte à API Espresso Device, faça o seguinte:

1. Para permitir que o teste passe comandos para o dispositivo de teste, adicione as permissões INTERNET e ACCESS_NETWORK_STATE ao arquivo de manifesto no conjunto de origem androidTest:

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

2. Ative a flag experimental enableEmulatorControl no arquivo gradle.properties:

     android.experimental.androidTest.enableEmulatorControl=true
     

3. Ative a opção emulatorControl no script de build do módulo:

   Kotlin

     testOptions {
       emulatorControl {
         enable = true
       }
     }
     

   Groovy

     testOptions {
       emulatorControl {
         enable = true
       }
     }
     

4. No script de build do módulo, importe a biblioteca Espresso Device para o projeto:

   Kotlin

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

   Groovy

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

teste em relação a alterações comuns de configuração

A API Espresso Device tem várias orientações de tela e estados dobráveis que podem ser usados para simular mudanças de configuração do dispositivo.

Testar a rotação da tela

Confira um exemplo de como testar o que acontece com o app quando a tela do dispositivo é girada:

1. Primeiro, para um estado inicial consistente, defina o dispositivo para o modo retrato:

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

2. Crie um teste que defina o dispositivo para a orientação paisagem durante a execução do teste:

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

3. Depois que a tela girar, verifique se a interface se adapta ao novo layout conforme o esperado.

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

Testar o desdobramento da tela

Confira um exemplo de como testar o que acontece com o app se ele estiver em um dispositivo dobrável e a tela se abrir:

1. Primeiro, teste com o dispositivo no estado dobrado chamando onDevice().setClosedMode(). Verifique se o layout do app se adapta à largura compacta da tela.

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

2. Para fazer a transição para um estado totalmente desdobrado, chame onDevice().setFlatMode(). Verifique se o layout do app se adapta à classe de tamanho expandida.

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

Especificar os dispositivos necessários para os testes

Se você estiver executando um teste que realiza ações de dobra em um dispositivo não dobrável, é provável que o teste falhe. Para executar apenas os testes relevantes para o dispositivo em execução, use a anotação @RequiresDeviceMode. O executor de testes ignora automaticamente a execução de testes em dispositivos que não oferecem suporte à configuração que está sendo testada. Você pode adicionar a regra de requisito de dispositivo a cada teste ou a uma classe de teste inteira.

Por exemplo, para especificar que um teste só pode ser executado em dispositivos compatíveis com uma configuração simples, adicione o seguinte código @RequiresDeviceMode ao teste:

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