إعداد مشروع لاختبار AndroidX

‫AndroidX Test هي مجموعة من مكتبات Jetpack تتيح لك إجراء اختبارات على تطبيقات Android. وتوفّر أيضًا سلسلة من الأدوات لمساعدتك في كتابة هذه الاختبارات.

على سبيل المثال، توفّر مكتبة AndroidX Test قواعد JUnit4 لبدء الأنشطة والتفاعل معها في اختبارات JUnit4. ويحتوي أيضًا على أُطر عمل لاختبار واجهة المستخدم، مثل Espresso وUI Automator ومحاكي Robolectric.

إضافة مكتبات AndroidX Test

لاستخدام AndroidX Test، يجب تعديل التبعيات الخاصة بمشروع تطبيقك داخل بيئة التطوير.

إضافة تبعيات Gradle

لتعديل التبعيات في مشروع تطبيقك، أكمِل الخطوات التالية:

• الخطوة 1: افتح ملف build.gradle لوحدة Gradle.
• الخطوة 2: في قسم المستودعات، تأكَّد من ظهور مستودع Maven الخاص بـ Google:

  allprojects {
    repositories {
      jcenter()
      google()
    }
  }

• الخطوة 3: أضِف اسم الحزمة إلى قسم التبعيات لكل حزمة AndroidX Test تريد استخدامها. على سبيل المثال، لإضافة حزمة espresso-core، أضِف الأسطر التالية:

أنيق

dependencies {
        ...
        androidTestImplementation "androidx.test.espresso:espresso-core:$espressoVersion"
    }

Kotlin

dependencies {
        ...
        androidTestImplementation('androidx.test.espresso:espresso-core:$espressoVersion')
    }

في ما يلي أكثر تبعيات AndroidX Test شيوعًا:

أنيق

dependencies {
    // Core library
    androidTestImplementation "androidx.test:core:$androidXTestVersion0"

    // AndroidJUnitRunner and JUnit Rules
    androidTestImplementation "androidx.test:runner:$testRunnerVersion"
    androidTestImplementation "androidx.test:rules:$testRulesVersion"

    // Assertions
    androidTestImplementation "androidx.test.ext:junit:$testJunitVersion"
    androidTestImplementation "androidx.test.ext:truth:$truthVersion"

    // Espresso dependencies
    androidTestImplementation "androidx.test.espresso:espresso-core:$espressoVersion"
    androidTestImplementation "androidx.test.espresso:espresso-contrib:$espressoVersion"
    androidTestImplementation "androidx.test.espresso:espresso-intents:$espressoVersion"
    androidTestImplementation "androidx.test.espresso:espresso-accessibility:$espressoVersion"
    androidTestImplementation "androidx.test.espresso:espresso-web:$espressoVersion"
    androidTestImplementation "androidx.test.espresso.idling:idling-concurrent:$espressoVersion"

    // The following Espresso dependency can be either "implementation",
    // or "androidTestImplementation", depending on whether you want the
    // dependency to appear on your APK’"s compile classpath or the test APK
    // classpath.
    androidTestImplementation "androidx.test.espresso:espresso-idling-resource:$espressoVersion"
}

Kotlin

dependencies {
    // Core library
    androidTestImplementation("androidx.test:core:$androidXTestVersion")

    // AndroidJUnitRunner and JUnit Rules
    androidTestImplementation("androidx.test:runner:$testRunnerVersion")
    androidTestImplementation("androidx.test:rules:$testRulesVersion")

    // Assertions
    androidTestImplementation("androidx.test.ext:junit:$testJunitVersion")
    androidTestImplementation("androidx.test.ext:truth:$truthVersion")

    // Espresso dependencies
    androidTestImplementation( "androidx.test.espresso:espresso-core:$espressoVersion")
    androidTestImplementation( "androidx.test.espresso:espresso-contrib:$espressoVersion")
    androidTestImplementation( "androidx.test.espresso:espresso-intents:$espressoVersion")
    androidTestImplementation( "androidx.test.espresso:espresso-accessibility:$espressoVersion")
    androidTestImplementation( "androidx.test.espresso:espresso-web:$espressoVersion")
    androidTestImplementation( "androidx.test.espresso.idling:idling-concurrent:$espressoVersion")

    // The following Espresso dependency can be either "implementation",
    // or "androidTestImplementation", depending on whether you want the
    // dependency to appear on your APK"s compile classpath or the test APK
    // classpath.
    androidTestImplementation( "androidx.test.espresso:espresso-idling-resource:$espressoVersion")
}

تحتوي صفحة ملاحظات الإصدار على جدول يتضمّن أحدث الإصدارات لكل عنصر.

ملاحظة: من المهم التأكّد من أنّ هذه الاعتماديات الخاصة بالاختبار تشير إلى مجموعة رموز المصدر الصحيحة. عادةً ما تكون حزمة AndroidX Test مطلوبة في اختبارات لقياس حالة التطبيق فقط، لذا عليك استخدام androidTestImplementation(). ومع ذلك، في حالات مثل espresso-idling-resource، يتم استخدام واجهات برمجة التطبيقات من الرمز البرمجي للإنتاج، ما يتطلّب منك استخدام وظيفة التنفيذ.

يُرجى الرجوع إلى فهرس الحِزم أو فهرس الفئات للحصول على مستندات مرجعية محدّدة حول هذه المكتبات.

المشاريع التي تستخدم فئات تم إيقافها نهائيًا

تحذير: إذا كنت تنشئ اختبارات قياس حالة التطبيق باستخدام Gradle، ستحصل على دعم إضافي. عند إنشاء ملف بيان الاختبار تلقائيًا، يضيف المكوّن الإضافي لنظام Gradle المتوافق مع Android المكتبات وعناصر ملف البيان التالية إلى مشروعك تلقائيًا، لذا لن تحتاج إلى اتّخاذ هذه الخطوات.

إذا كان تطبيقك يستخدم اختبارات تعتمد على فئات android.test قديمة مستندة إلى JUnit3، مثل InstrumentationTestCase وTestSuiteLoader، أضِف الأسطر التالية في القسم android من الملف:

android {
    ...
    useLibrary 'android.test.runner'

    useLibrary 'android.test.base'
    useLibrary 'android.test.mock'
  }

ملاحظة: عليك تضمين المكتبات التي تحتوي على الفئات المستخدَمة في تطبيقك فقط. للاطّلاع على قائمة بالفئات التي تظهر في كل مكتبة، راجِع المكتبات المستندة إلى JUnit.

إضافة بيانات في ملف البيان

لتشغيل الاختبارات التي تعتمد على فئات android.test المستندة إلى JUnit3 التي تم إيقافها نهائيًا، أضِف عناصر <uses-library> اللازمة إلى بيان تطبيق الاختبار. على سبيل المثال، إذا أضفت اختبارات تعتمد على مكتبة android.test.runner، أضِف العنصر التالي إلى بيان تطبيقك:

<!-- You don't need to include android:required="false" if your app's

   minSdkVersion is 28 or higher. -->

<uses-library android:name="android.test.runner"

       android:required="false" />

لتحديد المكتبة التي تحتوي على فئة معيّنة مستندة إلى JUnit، راجِع المكتبات المستندة إلى JUnit.

تنبيه: تجنَّب استخدام الفئات المتوقّفة نهائيًا متى أمكن ذلك. استخدِم فئات متوافقة مستندة إلى JUnit بدلاً منها.

اعتبارات مهمة عند استخدام الفئات المتوقّفة نهائيًا واستهداف الإصدار 9 من نظام التشغيل Android أو إصدار أحدث

أعلى

لا تنطبق الإرشادات الواردة في هذا القسم إلا إذا كنت تستهدف الإصدار Android 9 (مستوى واجهة برمجة التطبيقات 28) أو إصدارًا أحدث وتم ضبط الحد الأدنى لإصدار حزمة تطوير البرامج (SDK) لتطبيقك على Android 9.

تعتمد مكتبة android.test.runner بشكل ضِمني على مكتبتَي android.test.base وandroid.test.mock. إذا كان تطبيقك يستخدم الفئات من android.test.base أو android.test.mock فقط، يمكنك تضمين المكتبات بحد ذاتها:

<!-- For both of these declarations, you don't need to include
   android:required="false" if your app's minSdkVersion is 28
   or higher. -->

<uses-library android:name="android.test.base"
       android:required="false" />
<uses-library android:name="android.test.mock"
       android:required="false" />