Petunjuk penyiapan Espresso

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

Menyiapkan lingkungan pengujian Anda

Untuk menghindari kegagalan, sebaiknya nonaktifkan 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:

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 33

    defaultConfig {
        applicationId "com.my.awesome.app"
        minSdkVersion 21
        targetSdkVersion 33
        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(33)

    defaultConfig {
        applicationId = "com.my.awesome.app"
        minSdkVersion(21)
        targetSdkVersion(33)
        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')
}

Analisis

Untuk memastikan kita berada di jalur yang benar dengan setiap rilis baru, runner pengujian akan mengumpulkan analisis. Secara khusus, runner mengupload hash nama paket aplikasi yang diuji untuk setiap pemanggilan. Hal ini memungkinkan kita 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 = 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