Petunjuk penyiapan Espresso

Panduan ini membahas cara menginstal Espresso menggunakan SDK Manager dan mem-build-nya menggunakan Gradle. Android Studio direkomendasikan.

Menyiapkan lingkungan pengujian Anda

Untuk menghindari flakiness, sebaiknya nonaktifkan animasi sistem di perangkat virtual atau perangkat fisik yang digunakan untuk pengujian. Di perangkat, di bagian Settings > 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:

Groovy

androidTestImplementation 'androidx.test.espresso:espresso-core:3.6.1'
androidTestImplementation 'androidx.test:runner:1.6.1'
androidTestImplementation 'androidx.test:rules:1.6.1'

Kotlin

androidTestImplementation('androidx.test.espresso:espresso-core:3.6.1')
androidTestImplementation('androidx.test:runner:1.6.1')
androidTestImplementation('androidx.test:rules:1.6.1')

Lihat set lengkap dependensi Gradle.

Menyiapkan runner instrumentasi

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

Groovy

testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"

Kotlin

testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"

Contoh file build Gradle

Groovy

plugins {
  id 'com.android.application'
}

android {
    compileSdkVersion 36

    defaultConfig {
        applicationId "com.my.awesome.app"
        minSdkVersion 23
        targetSdkVersion 36
        versionCode 1
        versionName "1.0"

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

dependencies {
    androidTestImplementation 'androidx.test:runner:1.6.1'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.6.1'
}

Kotlin

plugins {
    id("com.android.application")
}

android {
    compileSdkVersion(36)

    defaultConfig {
        applicationId = "com.my.awesome.app"
        minSdkVersion(23)
        targetSdkVersion(36)
        versionCode = 1
        versionName = "1.0"

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

dependencies {
    androidTestImplementation('androidx.test:runner:1.6.1')
    androidTestImplementation('androidx.test.espresso:espresso-core:3.6.1')
}

Analytics

Untuk memastikan bahwa kita berada di jalur yang benar dengan setiap rilis baru, runner pengujian mengumpulkan analisis. Lebih khusus lagi, alat ini mengupload hash nama paket aplikasi yang sedang diuji untuk setiap pemanggilan. Dengan demikian, kami dapat mengukur jumlah paket unik yang menggunakan Espresso serta volume penggunaannya.

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

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 = ActivityScenarioRule(MainActivity::class.java)

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

Java

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

    @Rule
    public ActivityScenarioRule<MainActivity> activityRule =
            new ActivityScenarioRule<>(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