Menguji perubahan konfigurasi layar dengan Espresso Device API

Gunakan Espresso Device API untuk menguji aplikasi Anda saat perangkat mengalami perubahan konfigurasi umum, seperti rotasi dan pembentangan layar. Espresso Device API memungkinkan Anda menyimulasikan perubahan konfigurasi ini di perangkat virtual dan menjalankan pengujian secara serentak, sehingga hanya satu tindakan atau pernyataan UI yang terjadi pada satu waktu dan hasil pengujian Anda lebih andal. Jika Anda baru menulis pengujian UI dengan Espresso, lihat dokumentasinya.

Untuk menggunakan Espresso Device API, Anda memerlukan hal berikut:

• Android Studio Iguana atau yang lebih baru
• Plugin Android Gradle 8.3 atau yang lebih tinggi
• Android Emulator 33.1.10 atau yang lebih tinggi
• Perangkat virtual Android yang menjalankan level API 24 atau yang lebih tinggi

Menyiapkan project untuk Espresso Device API

Untuk menyiapkan project agar mendukung Espresso Device API, lakukan hal berikut:

1. Agar pengujian dapat meneruskan perintah ke perangkat pengujian, tambahkan izin INTERNET dan ACCESS_NETWORK_STATE ke file manifes di set sumber androidTest:

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

2. Aktifkan tanda eksperimental enableEmulatorControl di file gradle.properties:

     android.experimental.androidTest.enableEmulatorControl=true
     

3. Aktifkan opsi emulatorControl di skrip build level modul:

   Kotlin

     testOptions {
       emulatorControl {
         enable = true
       }
     }
     

   Groovy

     testOptions {
       emulatorControl {
         enable = true
       }
     }
     

4. Dalam skrip build level modul, impor library Espresso Device ke project Anda:

   Kotlin

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

   Groovy

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

Menguji terhadap perubahan konfigurasi umum

Espresso Device API memiliki beberapa orientasi layar dan status perangkat foldable yang dapat Anda gunakan untuk menyimulasikan perubahan konfigurasi perangkat.

Menguji terhadap rotasi layar

Berikut adalah contoh cara menguji apa yang terjadi pada aplikasi Anda saat layar perangkat berputar:

1. Pertama, untuk status awal yang konsisten, setel perangkat ke mode potret:

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

2. Buat pengujian yang menyetel perangkat ke orientasi lanskap selama eksekusi pengujian:

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

3. Setelah layar berputar, periksa apakah UI beradaptasi dengan tata letak baru seperti yang diharapkan.

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

Menguji terhadap pelipatan layar

Berikut contoh cara menguji apa yang terjadi pada aplikasi Anda jika aplikasi tersebut berada di perangkat foldable dan layar dibuka:

1. Pertama, uji dengan perangkat dalam status terlipat dengan memanggil onDevice().setClosedMode(). Pastikan tata letak aplikasi Anda beradaptasi dengan lebar layar yang ringkas.

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

2. Untuk bertransisi ke status terbuka sepenuhnya, panggil onDevice().setFlatMode(). Pastikan tata letak aplikasi beradaptasi dengan class ukuran yang diperluas.

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

Tentukan perangkat yang dibutuhkan pengujian Anda

Jika Anda menjalankan pengujian yang melakukan tindakan melipat pada perangkat yang tidak dapat dilipat, pengujian kemungkinan akan gagal. Untuk menjalankan hanya pengujian yang relevan dengan perangkat yang sedang berjalan, gunakan anotasi @RequiresDeviceMode. Runner pengujian secara otomatis melewati pengujian yang dijalankan di perangkat yang tidak mendukung konfigurasi yang sedang diuji. Anda dapat menambahkan aturan persyaratan perangkat ke setiap pengujian atau seluruh class pengujian.

Misalnya, untuk menentukan bahwa pengujian hanya boleh dijalankan di perangkat yang mendukung membuka ke konfigurasi datar, tambahkan kode @RequiresDeviceMode berikut ke pengujian Anda:

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