دستورالعمل‌های راه‌اندازی Espresso

این راهنما نصب Espresso بااستفاده از «مدیر SDK» و ساختن آن بااستفاده از Gradle را پوشش می‌دهد. «استودیو Android» توصیه می‌شود.

راه‌اندازی محیط آزمایشی

برای جلوگیری از ناپایداری، اکیداً توصیه می‌کنیم پویانمایی‌های سیستم را در دستگاه‌های مجازی یا فیزیکی مورداستفاده برای آزمایش خاموش کنید. در دستگاهتان، در بخش تنظیمات > گزینه‌های توسعه‌دهندگان، ۳ تنظیم زیر را غیرفعال کنید:

• مقیاس پویانمایی پنجره
• مقیاس پویانمایی انتقالی
• مقیاس مدت پویانماساز

افزودن وابستگی‌های Espresso

برای افزودن وابستگی‌های Espresso به پروژه‌تان، مراحل زیر را تکمیل کنید:

1. فایل build.gradle برنامه‌تان را باز کنید. این معمولاً فایل سطح بالای build.gradle نیست، بلکه app/build.gradle است.
2. خطوط زیر را به dependencies اضافه کنید:

شیک

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

کاتلین

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

مجموعه کامل وابستگی‌های Gradle را مشاهده کنید.

تنظیم کردن اجراکننده ابزار دقیق

خط زیر را به همان فایل build.gradle در android.defaultConfig اضافه کنید:

شیک

testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"

کاتلین

testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"

نمونه فایل ساخت Gradle

شیک

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'
}

کاتلین

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')
}

تجزیه‌وتحلیل

برای اطمینان از اینکه با هر نسخه جدید در مسیر درستی هستیم، اجراکننده آزمایش تجزیه‌وتحلیل‌ها را جمع‌آوری می‌کند. به‌طور دقیق‌تر، درهم‌سازی نام بسته برنامه تحت آزمایش را برای هر فراخوانی بارگذاری می‌کند. این کار به ما امکان می‌دهد هم تعداد بسته‌های منحصربه‌فردی را که از Espresso استفاده می‌کنند و هم حجم استفاده را اندازه‌گیری کنیم.

اگر نمی‌خواهید این داده‌ها را بارگذاری کنید، می‌توانید با گنجاندن آرگومان disableAnalytics در فرمان ابزارسازی‌تان، انصراف دهید:

adb shell am instrument -e disableAnalytics true

افزودن اولین آزمایش

«استودیو Android» به‌طور پیش‌فرض در src/androidTest/java/com.example.package/ آزمایش ایجاد می‌کند.

نمونه آزمایش JUnit4 بااستفاده از Rules:

کاتلین

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

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

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

جاوا

@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()));
    }
}

اجرای آزمایش‌ها

می‌توانید آزمایش‌هایتان را در Android Studio یا از خط فرمان اجرا کنید.

در «استودیو Android»

برای ایجاد پیکربندی آزمایشی در «استودیو Android»، مراحل زیر را تکمیل کنید:

1. اجرا > ویرایش پیکربندی‌ها را باز کنید.
2. پیکربندی جدیدی برای «آزمایش‌های Android» اضافه کنید.
3. واحدی را انتخاب کنید.
4. افزودن یک اجراکننده ابزار دقیق خاص: androidx.test.runner.AndroidJUnitRunner
5. پیکربندی جدیداً ایجادشده را اجرا کنید.

از خط فرمان

فرمان Gradle زیر را اجرا کنید:

./gradlew connectedAndroidTest