يتناول هذا الدليل تثبيت Espresso باستخدام أداة SDK Manager وإنشائها باستخدام Gradle. ننصحك باستخدام "استوديو Android".
إعداد بيئة الاختبار
لتجنب الارتباك، ننصحك بشدة بإيقاف الصور المتحركة للنظام على الأجهزة الافتراضية أو الفعلية المستخدمة في الاختبار. على جهازك، ضمن الإعدادات > خيارات المطوّرين، عطِّل الإعدادات الثلاثة التالية:
- حجم الرسوم المتحركة للنافذة
- حجم الرسوم المتحركة للنقل
- طول مدة الرسوم المتحركة
إضافة تبعيات قهوة الإسبريسو
لإضافة تبعيات الإسبريسو إلى مشروعك، أكمل الخطوات التالية:
- افتح ملف
build.gradle
الخاص بتطبيقك. لا يكون هذا عادةً ملفbuild.gradle
ذي المستوى الأعلى، ولكن ملفapp/build.gradle
. - أضف الأسطر التالية داخل التبعيات:
رائع
androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0' androidTestImplementation 'androidx.test:runner:1.4.0' androidTestImplementation 'androidx.test:rules:1.4.0'
Kotlin
androidTestImplementation('androidx.test.espresso:espresso-core:3.4.0') androidTestImplementation('androidx.test:runner:1.4.0') androidTestImplementation('androidx.test:rules:1.4.0')
اعرض المجموعة الكاملة لتبعيات Gradle.
ضبط وحدة تشغيل الأدوات
أضِف السطر التالي في ملف build.gradle
نفسه في android.defaultConfig
:
رائع
testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
Kotlin
testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
مثال على ملف إصدار Gradle
رائع
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.4.0' androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0' }
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.4.0') androidTestImplementation('androidx.test.espresso:espresso-core:3.4.0') }
الإحصاءات
للتأكُّد من أنّنا على المسار الصحيح مع كل إصدار جديد، يجمع عدّاء الاختبار التحليلات. وبشكل أكثر تحديدًا، تُحمّل تجزئة لاسم حزمة التطبيق قيد الاختبار لكل استدعاء. ويتيح لنا ذلك قياس عدد الحزم الفريدة باستخدام الإسبريسو بالإضافة إلى حجم الاستخدام.
إذا لم تكن تريد تحميل هذه البيانات، يمكنك إيقاف هذه الميزة من خلال تضمين الوسيطة disableAnalytics
في أمر الأدوات:
adb shell am instrument -e disableAnalytics true
إضافة الاختبار الأول
ينشئ "استوديو Android" الاختبارات تلقائيًا في
src/androidTest/java/com.example.package/
.
مثال على اختبار JUnit4 باستخدام القواعد:
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())); } }
إجراء الاختبارات
يمكنك إجراء اختباراتك في "استوديو Android" أو من سطر الأوامر.
في "استوديو Android"
لإنشاء إعدادات اختبار في "استوديو Android"، أكمِل الخطوات التالية:
- افتح تشغيل > تعديل الإعدادات.
- إضافة إعدادات جديدة لاختبارات Android
- اختَر وحدة.
- إضافة وحدة تشغيل أدوات معيّنة:
androidx.test.runner.AndroidJUnitRunner
- شغِّل الإعدادات التي تم إنشاؤها حديثًا.
من سطر الأوامر
نفِّذ أمر Gradle التالي:
./gradlew connectedAndroidTest