تجمع الحزم الاختبارية الآلية اختبارات الأجهزة في حزم APK معزولة من النوع
testApk خارج دليل src/androidTest/
التلقائي للوحدة. يمكنك ضبطها باستخدام لغة DSL الخاصة بالحِزم الاختبارية للمكوّن الإضافي لنظام Gradle المتوافق مع Android (AGP) لفصل واجهة المستخدم أو عمليات الدمج أو عمليات التحقّق الشاملة باستخدام التبعيات والخيارات وأهداف الأجهزة المخصّصة.
المتطلبات
لاستخدام حِزم الاختبارات الآلية، تأكَّد من أنّ مشروعك يستوفي المتطلبات التالية:
- الإصدار Rabbit 3 Canary 3 من استوديو Android أو إصدار أحدث
- الإصدار 9.6.0-alpha03 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android" أو إصدار أحدث
- الإصدار 9.7.1 من Gradle أو إصدار أحدث والإصدار 17 من JDK أو إصدار أحدث
- وحدة
com.android.applicationأوcom.android.library - جهاز أو محاكي متصل من خلال Android Debug Bridge (adb) أو تعريف جهاز مُدار من خلال الإصدار
لمزيد من المعلومات حول مطابقة الإصدار المبكر الحصري، يُرجى الاطّلاع على التوافق مع الإصدارات المبكرة الحصرية للمكوّن الإضافي لنظام Gradle المتوافق مع Android.
إعداد حزمة اختبارات لقياس حالة التطبيق
لإضافة حزمة اختبارية لقياس حالة التطبيق إلى تطبيق أو وحدة مكتبة، أكمِل الخطوات التالية:
تفعيل الحزم الاختبارية
في ملف gradle.properties الخاص بمشروعك، فعِّل إمكانية استخدام الحزمة الاختبارية:
android.experimental.testSuiteSupport=true
ضبط إعدادات الحزمة
في ملف build.gradle.kts الخاص بالوحدة، أنشئ مجموعة داخل حزمة testOptions.customSuites باستخدام حزمتَي testApk وuseJunitEngine وقيم التعداد AgpTestSuiteInputParameters:
import com.android.build.api.dsl.AgpTestSuiteInputParameters
android {
testOptions {
// Optional: define build-managed virtual devices and device groups.
managedDevices {
localDevices {
create("api34Atd") {
// Use a device profile from Android Studio.
device = "Pixel 6"
apiLevel = 34
systemImageSource = "aosp-atd"
}
}
groups {
create("ciPhones") {
targetDevices.add(allDevices.getByName("api34Atd"))
}
}
}
customSuites {
create("androidSuite") {
targetVariants += listOf("debug")
testApk {
dependencies {
implementation("junit:junit:4.13.2")
implementation("androidx.test.ext:junit:1.2.1")
implementation("androidx.test:runner:1.6.2")
}
}
useJunitEngine {
includeEngines += listOf("android-test-engine")
// Match the engine and listener versions to your AGP
// version.
enginesDependencies.add(
"com.android.tools.androidtest:" +
"android-test-engine:9.6.0-alpha03"
)
enginesDependencies.add(
"com.android.tools.androidtest:" +
"android-test-engine-result-listener:9.6.0-alpha03"
)
enginesDependencies.add(
"org.junit.platform:junit-platform-launcher:1.10.2"
)
inputs += listOf(
// Omit TESTED_APKS in com.android.library modules.
AgpTestSuiteInputParameters.TESTED_APKS,
AgpTestSuiteInputParameters.TEST_APKS,
AgpTestSuiteInputParameters.ADB_EXECUTABLE,
AgpTestSuiteInputParameters.AAPT2_EXECUTABLE,
)
}
targets {
// Runs on connected adb devices.
create("default")
// Optional: runs on build-managed devices or groups in
// targetDevices.
create("managed") {
targetDevices += listOf("ciPhones")
}
}
}
}
}
}
يضبط مكوّن AGP الإضافي معرّفات الحزمة وأداة تشغيل الاختبار AndroidJUnitRunner
تلقائيًا بدون اكتساب التبعيات من
إعدادات androidTestImplementation. لاستخدام مشغّل مخصّص، اضبط السمة android:name على العنصر instrumentation في ملف src/{suiteName}/AndroidManifest.xml.
إنشاء اختبارات
ضَع اختباراتك لقياس حالة التطبيق في الدليل {module}/src/{suiteName}/kotlin/ أو java/، إلى جانب أي أدلة اختيارية res/ أو assets/ أو ملف AndroidManifest.xml. على سبيل المثال، أنشئ ملف
app/src/androidSuite/kotlin/com/example/myapp/AppContextSuiteTest.kt:
package com.example.myapp
import androidx.test.ext.junit.runners.AndroidJUnit4
import androidx.test.platform.app.InstrumentationRegistry
import org.junit.Assert.assertEquals
import org.junit.Test
import org.junit.runner.RunWith
@RunWith(AndroidJUnit4::class)
class AppContextSuiteTest {
@Test
fun useAppContext() {
val appContext =
InstrumentationRegistry.getInstrumentation().targetContext
assertEquals("com.example.myapp", appContext.packageName)
}
}
الجمع بين اختبارات الوحدات واختبارات قياس حالة التطبيق
لإجراء اختبارات JVM المحلية واختبارات الأجهزة التي تم قياس حالتها في مهمة Gradle واحدة،
يجب تعريف كل من مجموعتَي hostJar وtestApk في حزمة واحدة. ضَع
الاختبارات على المضيف في الدليل src/{suiteName}/test/ والاختبارات على الجهاز في
الدليل src/{suiteName}/androidTest/:
import com.android.build.api.dsl.AgpTestSuiteInputParameters
android {
testOptions {
customSuites {
create("combinedSuite") {
targetVariants += listOf("debug")
hostJar {
dependencies {
implementation(
"org.junit.jupiter:junit-jupiter-api:5.10.2"
)
}
}
testApk {
dependencies {
implementation("junit:junit:4.13.2")
implementation("androidx.test.ext:junit:1.2.1")
implementation("androidx.test:runner:1.6.2")
}
}
useJunitEngine {
includeEngines += listOf(
"junit-jupiter",
"android-test-engine",
)
enginesDependencies.add(
"org.junit.jupiter:junit-jupiter-engine:5.10.2"
)
enginesDependencies.add(
"com.android.tools.androidtest:" +
"android-test-engine:9.6.0-alpha03"
)
enginesDependencies.add(
"com.android.tools.androidtest:" +
"android-test-engine-result-listener:9.6.0-alpha03"
)
enginesDependencies.add(
"org.junit.platform:junit-platform-launcher:1.10.2"
)
inputs += listOf(
// Omit TESTED_APKS in com.android.library modules.
AgpTestSuiteInputParameters.TESTED_APKS,
AgpTestSuiteInputParameters.TEST_APKS,
AgpTestSuiteInputParameters.ADB_EXECUTABLE,
AgpTestSuiteInputParameters.AAPT2_EXECUTABLE,
)
}
targets {
create("default")
}
}
}
}
}
إجراء الاختبارات وجمع بيانات التغطية
استخدِم Gradle لتشغيل مجموعات الاختبارات الآلية وفلترة إطارات الاختبار وإنشاء تقارير التغطية.
التشغيل على الأجهزة المتصلة أو الأجهزة المُدارة من خلال الإصدار
يمكنك تشغيل هدف متصل على كل جهاز adb متصل بالإنترنت، أو تشغيل هدف تم ضبطه
باستخدام السمة targetDevices:
# Run on connected adb devices. ./gradlew :app:testDebugAndroidSuiteDefaultTestSuite# Run on the ciPhones build-managed device group. ./gradlew :app:testDebugAndroidSuiteManagedCiPhonesTestSuite
فلترة اختبارات قياس حالة التطبيق
يمكنك فلترة الاختبارات باستخدام خيار --tests في Gradle
أو وسيطات AndroidJUnitRunner:
./gradlew :app:testDebugAndroidSuiteDefaultTestSuite \
--tests "com.example.myapp.AppContextSuiteTest.useAppContext"يمكنك أيضًا تمرير وسيطات AndroidJUnitRunner في سطر الأوامر باستخدام سمة مشروع مثل -Pandroid.testInstrumentationRunnerArguments.size=small. لضبط وسيطات المشغّل التلقائية في مجموعة useJunitEngine، يمكنك استدعاء طريقة addInputProperty، مثل addInputProperty("android-test.instrumentation-args", "size=small").
جمع نسبة استخدام رموز الصفحة على الجهاز فقط
تتطلّب نسبة استخدام رموز الصفحة على الجهاز فقط إصدارًا قابلاً للتصحيح وجهازًا يعمل بنظام التشغيل Android 9 (مستوى واجهة برمجة التطبيقات 28) أو إصدار أحدث. لجمع بيانات التغطية لمجموعة اختبارات مُعدّة أو مختلطة، أكمِل الخطوات التالية:
- اضبط السمة
android.experimental.androidTest.coverage.useOnDeviceAgent=trueفي ملفgradle.properties. - اضبط السمة
codeCoverageعلىtrueفي المجموعة. - إذا كانت هناك عدة أجهزة متصلة، يمكنك استهداف جهاز واحد باستخدام متغيّر البيئة
ANDROID_SERIAL.
لمزيد من المعلومات حول متطلبات الوكيل، يُرجى الاطّلاع على عرض تقارير نسبة استخدام رموز الصفحة (باستخدام وكيل على الجهاز).
فحص التقارير
بعد اكتمال التشغيل التجريبي، ينشئ المكوّن الإضافي AGP مخرجات في المسارات التالية:
- تقرير اختبار HTML:
{module}/build/reports/tests/{taskName}/index.html - نتائج JUnit XML:
{module}/build/test-results/{taskName}/ - ملف XML وlogcat لكل جهاز:
{module}/build/intermediates/{variant}/{taskName}/results/ - تقرير نسبة استخدام رموز الصفحة:
{module}/build/reports/coverage/{suiteName}/index.html