Bergabunglah bersama kami di ⁠#Android11: The Beta Launch Show pada tanggal 3 Juni!

Petunjuk penyiapan Espresso

Panduan ini berisi cara menginstal Espresso menggunakan SDK Manager dan membuatnya menggunakan Gradle. Android Studio direkomendasikan.

Menyiapkan lingkungan pengujian Anda

Untuk menghindari kegagalan, kami sangat menyarankan agar Anda menonaktifkan animasi sistem pada perangkat virtual atau fisik yang digunakan untuk pengujian. Di perangkat, di bagian Setelan > Opsi developer, nonaktifkan 3 setelan berikut:

  • Skala animasi jendela
  • Skala animasi transisi
  • Skala durasi animator

Menambahkan dependensi Espresso

Untuk menambahkan dependensi Espresso ke project Anda, selesaikan langkah-langkah berikut:

  1. Buka file build.gradle aplikasi Anda. File tersebut biasanya bukan file build.gradle tingkat teratas, tetapi app/build.gradle.
  2. Tambahkan baris berikut ke dalam dependensi:
androidTestImplementation 'androidx.test.espresso:espresso-core:3.1.0'
    androidTestImplementation 'androidx.test:runner:1.1.0'
    androidTestImplementation 'androidx.test:rules:1.1.0'
    

Lihat set lengkap dependensi Gradle.

Menyiapkan runner instrumentasi

Tambahkan baris berikut ke file build.gradle yang sama di android.defaultConfig:

testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    

Contoh file build Gradle

apply plugin: 'com.android.application'

    android {
        compileSdkVersion 28

        defaultConfig {
            applicationId "com.my.awesome.app"
            minSdkVersion 15
            targetSdkVersion 28
            versionCode 1
            versionName "1.0"

            testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
        }
    }

    dependencies {
        androidTestImplementation 'androidx.test:runner:1.1.0'
        androidTestImplementation 'androidx.test.espresso:espresso-core:3.1.0'
    }
    

Analisis

Untuk memastikan kita berada di jalur yang benar dengan setiap rilis baru, runner pengujian akan mengumpulkan analisis. Secara teknis, runner mengupload hash nama paket aplikasi yang diuji untuk setiap pemanggilan. Perilaku ini memungkinkan kita untuk mengukur jumlah paket unik menggunakan Espresso serta volume penggunaannya.

Jika tidak ingin mengupload data ini, Anda dapat memilih tidak ikut dengan menyertakan argumen disableAnalytics dalam perintah instrumentasi Anda:

    adb shell am instrument -e disableAnalytics true
    

Menambahkan pengujian pertama

Android Studio membuat pengujian secara default di src/androidTest/java/com.example.package/.

Contoh pengujian JUnit4 menggunakan Aturan:

Kotlin

    @RunWith(AndroidJUnit4::class)
    @LargeTest
    class HelloWorldEspressoTest {

        @get:Rule
        val activityRule = ActivityTestRule(MainActivity::class.java)

        @Test fun listGoesOverTheFold() {
            onView(withText("Hello world!")).check(matches(isDisplayed()))
        }
    }
    

Java

    @RunWith(AndroidJUnit4.class)
    @LargeTest
    public class HelloWorldEspressoTest {

        @Rule
        public ActivityTestRule<MainActivity> activityRule =
                new ActivityTestRule<>(MainActivity.class);

        @Test
        public void listGoesOverTheFold() {
            onView(withText("Hello world!")).check(matches(isDisplayed()));
        }
    }
    

Menjalankan pengujian

Anda dapat menjalankan pengujian di Android Studio atau dari command line.

Di Android Studio

Untuk membuat konfigurasi pengujian di Android Studio, selesaikan langkah-langkah berikut:

  1. Buka Run > Edit Configurations.
  2. Tambahkan konfigurasi Pengujian Android baru.
  3. Pilih modul.
  4. Menambahkan runner instrumentasi tertentu: androidx.test.runner.AndroidJUnitRunner
  5. Jalankan konfigurasi yang baru dibuat.

Dari command line

Jalankan perintah Gradle berikut:

    ./gradlew connectedAndroidTest