BaseHostJUnit4Test

public abstract class BaseHostJUnit4Test
extends Object implements IAbiReceiver, ITestInformationReceiver

java.lang.Object
   ↳ com.android.tradefed.testtype.junit4.BaseHostJUnit4Test


فئة الاختبار الأساسية لتنفيذ اختبارات JUnit4 على الجهاز المضيف توفّر هذه الفئة إمكانية تثبيت اختبارات قياس حالة التطبيق وتشغيلها وتنظيفها من جهة المضيف. هذا الصف متوافق مع أجهزة متعددة. يجب أن يكون المصدر الوحيد للحقيقة لتشغيل اختبارات قياس حالة التطبيق من جهة المضيف لتجنُّب تكرار برنامج الخدمات والصنف الأساسي.

ملخّص

طُرق وضع التصميم العامة

BaseHostJUnit4Test()

الإجراءات العامة

final void autoTearDown()

إيقاف جميع حِزم APK المثبَّتة تلقائيًا

final IAbi getAbi()
final IBuildInfo getBuild()
final ITestDevice getDevice()
final IInvocationContext getInvocationContext()
final TestRunResult getLastDeviceRunResults()

تعرض هذه السمة TestRunResult الناتجة عن آخر عملية runDeviceTests تم تنفيذها.

final List<ITestDevice> getListDevices()
TestInformation getTestInformation()
boolean hasDeviceFeature(String feature)
final void installPackage(DeviceTestRunOptions options)

ثبِّت حزمة apk استنادًا إلى DeviceTestRunOptions على الجهاز.

final void installPackage(String apkFileName, String... options)

تثبيت حزمة apk مع تحديد اسمها على الجهاز

final void installPackage(ITestDevice device, String apkFileName, String... options)

تثبيت حزمة apk من خلال اسمها على جهاز معيّن

final void installPackageAsUser(ITestDevice device, String apkFileName, boolean grantPermission, int userId, String... options)

تثبيت حزمة APK مع تحديد اسمها لمستخدم معيّن على جهاز معيّن

final void installPackageAsUser(String apkFileName, boolean grantPermission, int userId, String... options)

تثبيت حزمة apk مع تحديد اسم المستخدم

final boolean isPackageInstalled(String pkg)

تتحقّق هذه الطريقة ممّا إذا كانت حزمة تحمل اسمًا معيّنًا مثبَّتة على الجهاز

final boolean isPackageInstalled(ITestDevice device, String pkg)

تتحقّق هذه الطريقة ممّا إذا كانت حزمة تحمل اسمًا معيّنًا مثبَّتة على الجهاز

final boolean runDeviceTests(ITestDevice device, String runner, String pkgName, String testClassName, String testMethodName, Integer userId, Long testTimeoutMs, Long maxTimeToOutputMs, Long maxInstrumentationTimeoutMs, boolean checkResults, boolean isHiddenApiCheckDisabled, boolean isTestApiCheckDisabled, boolean isIsolatedStorageDisabled, boolean isWindowAnimationDisabled, boolean isRestartDisabled, boolean instrumentInPcc, Map<String, String> instrumentationArgs, List<ITestLifeCycleReceiver> extraListeners)

طريقة لتشغيل حزمة أدوات مثبَّتة

final boolean runDeviceTests(ITestDevice device, String runner, String pkgName, String testClassName, String testMethodName, Integer userId, Long testTimeoutMs, Long maxTimeToOutputMs, Long maxInstrumentationTimeoutMs, boolean checkResults, boolean isHiddenApiCheckDisabled, boolean isTestApiCheckDisabled, boolean isIsolatedStorageDisabled, boolean isWindowAnimationDisabled, Map<String, String> instrumentationArgs, List<ITestLifeCycleReceiver> extraListeners)

طريقة لتشغيل حزمة أدوات مثبَّتة

final boolean runDeviceTests(ITestDevice device, String runner, String pkgName, String testClassName, String testMethodName, Integer userId, Long testTimeoutMs, Long maxTimeToOutputMs, Long maxInstrumentationTimeoutMs, boolean checkResults, boolean isHiddenApiCheckDisabled, Map<String, String> instrumentationArgs)

طريقة لتشغيل حزمة أدوات مثبَّتة

final boolean runDeviceTests(ITestDevice device, String pkgName, String testClassName, String testMethodName, Integer userId, Long testTimeoutMs)

طريقة لتشغيل حزمة أدوات مثبَّتة

final boolean runDeviceTests(ITestDevice device, String pkgName, String testClassName, String testMethodName, Long testTimeoutMs, Long maxTimeToOutputMs, Long maxInstrumentationTimeoutMs)

طريقة لتشغيل حزمة أدوات مثبَّتة

final boolean runDeviceTests(ITestDevice device, String pkgName, String testClassName, String testMethodName, Long testTimeoutMs)

طريقة لتشغيل حزمة أدوات مثبَّتة

final boolean runDeviceTests(String pkgName, String testClassName, String testMethodName)

طريقة لتشغيل حزمة أدوات مثبَّتة

final boolean runDeviceTests(DeviceTestRunOptions options)

يتم تشغيل أداة القياس استنادًا إلى المعلومات الواردة في DeviceTestRunOptions.

final boolean runDeviceTests(ITestDevice device, String runner, String pkgName, String testClassName, String testMethodName, Integer userId, Long testTimeoutMs, Long maxTimeToOutputMs, Long maxInstrumentationTimeoutMs, boolean checkResults, boolean isHiddenApiCheckDisabled, boolean isTestApiCheckDisabled, boolean isIsolatedStorageDisabled, Map<String, String> instrumentationArgs, List<ITestLifeCycleReceiver> extraListeners)

طريقة لتشغيل حزمة أدوات مثبَّتة

final boolean runDeviceTests(ITestDevice device, String pkgName, String testClassName, String testMethodName)

طريقة لتشغيل حزمة أدوات مثبَّتة

final boolean runDeviceTests(String pkgName, String testClassName, Integer userId, Long testTimeoutMs)

طريقة لتشغيل حزمة أدوات مثبَّتة

final boolean runDeviceTests(String pkgName, String testClassName)

طريقة لتشغيل حزمة أدوات مثبَّتة

final boolean runDeviceTests(String pkgName, String testClassName, Long testTimeoutMs)

طريقة لتشغيل حزمة أدوات مثبَّتة

final boolean runDeviceTests(String runner, String pkgName, String testClassName, String testMethodName)

طريقة لتشغيل حزمة أدوات مثبَّتة

final void setAbi(IAbi abi)
final void setTestInformation(TestInformation testInformation)
final String uninstallPackage(String pkgName)

تؤدي هذه السياسة إلى إلغاء تثبيت حزمة على الجهاز.

final String uninstallPackage(ITestDevice device, String pkgName)

إلغاء تثبيت حزمة على الجهاز

طُرق وضع التصميم العامة

BaseHostJUnit4Test

public BaseHostJUnit4Test ()

الإجراءات العامة

autoTearDown

public final void autoTearDown ()

إيقاف جميع حِزم APK المثبَّتة تلقائيًا سيؤدي هذا الإجراء إلى إلغاء تثبيت جميع حِزم APK من الجهاز الذي تم تثبيتها عليه.

عمليات الطرح
DeviceNotAvailableException

getAbi

public final IAbi getAbi ()

المرتجعات
IAbi

getBuild

public final IBuildInfo getBuild ()

المرتجعات
IBuildInfo

getDevice

public final ITestDevice getDevice ()

المرتجعات
ITestDevice

getInvocationContext

public final IInvocationContext getInvocationContext ()

المرتجعات
IInvocationContext

getLastDeviceRunResults

public final TestRunResult getLastDeviceRunResults ()

تعرض هذه السمة TestRunResult الناتجة عن آخر عملية runDeviceTests تم تنفيذها. أو قيمة فارغة إذا لم تتوفّر أي نتائج.

المرتجعات
TestRunResult

getListDevices

public final List<ITestDevice> getListDevices ()

المرتجعات
List<ITestDevice>

getTestInformation

public TestInformation getTestInformation ()

المرتجعات
TestInformation

hasDeviceFeature

public boolean hasDeviceFeature (String feature)

المعلَمات
feature String

القيم المُعادة
boolean

عمليات الطرح
DeviceNotAvailableException

installPackage

public final void installPackage (DeviceTestRunOptions options)

ثبِّت حزمة apk استنادًا إلى DeviceTestRunOptions على الجهاز. سيتم تنظيف ملف APK تلقائيًا.

المعلَمات
options ‫DeviceTestRunOptions: خيارات تثبيت الحزمة

عمليات الطرح
DeviceNotAvailableException
TargetSetupError

installPackage

public final void installPackage (String apkFileName, 
                String... options)

تثبيت حزمة apk مع تحديد اسمها على الجهاز سيتم تنظيف ملف APK تلقائيًا.

المعلَمات
apkFileName String: اسم ملف APK

options ‫String: خيارات إضافية يتم تقديمها لأمر التثبيت

عمليات الطرح
DeviceNotAvailableException
TargetSetupError

installPackage

public final void installPackage (ITestDevice device, 
                String apkFileName, 
                String... options)

تثبيت حزمة apk من خلال اسمها على جهاز معيّن سيتم تنظيف ملف APK تلقائيًا.

المعلَمات
device ITestDevice: هو ITestDevice الذي سيتم تثبيت حزمة APK عليه.

apkFileName String: اسم ملف APK

options ‫String: خيارات إضافية يتم تقديمها لأمر التثبيت

عمليات الطرح
DeviceNotAvailableException
TargetSetupError

installPackageAsUser

public final void installPackageAsUser (ITestDevice device, 
                String apkFileName, 
                boolean grantPermission, 
                int userId, 
                String... options)

تثبيت حزمة APK مع تحديد اسمها لمستخدم معيّن على جهاز معيّن

المعلَمات
device ITestDevice: هو ITestDevice الذي سيتم تثبيت حزمة APK عليه.

apkFileName String: اسم ملف APK

grantPermission ‫boolean: تحدّد ما إذا كان سيتم تمرير علامة منح الإذن عند تثبيت حزمة APK.

userId int: رقم تعريف المستخدم الذي سيتم تثبيت حزمة APK عليه.

options ‫String: خيارات إضافية يتم تقديمها لأمر التثبيت

عمليات الطرح
DeviceNotAvailableException
TargetSetupError

installPackageAsUser

public final void installPackageAsUser (String apkFileName, 
                boolean grantPermission, 
                int userId, 
                String... options)

تثبيت حزمة apk مع تحديد اسم المستخدم

المعلَمات
apkFileName String: اسم ملف APK

grantPermission ‫boolean: تحدّد ما إذا كان سيتم تمرير علامة منح الإذن عند تثبيت حزمة APK.

userId int: رقم تعريف المستخدم الذي سيتم تثبيت حزمة APK عليه.

options ‫String: خيارات إضافية يتم تقديمها لأمر التثبيت

عمليات الطرح
DeviceNotAvailableException
TargetSetupError

isPackageInstalled

public final boolean isPackageInstalled (String pkg)

تتحقّق هذه الطريقة ممّا إذا كانت حزمة تحمل اسمًا معيّنًا مثبَّتة على الجهاز

المعلَمات
pkg ‫String: اسم الحزمة

المرتجعات
boolean صحيح إذا تم العثور على الحزمة على الجهاز

عمليات الطرح
DeviceNotAvailableException

isPackageInstalled

public final boolean isPackageInstalled (ITestDevice device, 
                String pkg)

تتحقّق هذه الطريقة ممّا إذا كانت حزمة تحمل اسمًا معيّنًا مثبَّتة على الجهاز

المعلَمات
device استبدِل ITestDevice بالجهاز الذي يجب إلغاء تثبيت الحزمة عليه.

pkg ‫String: اسم الحزمة

المرتجعات
boolean صحيح إذا تم العثور على الحزمة على الجهاز

عمليات الطرح
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (ITestDevice device, 
                String runner, 
                String pkgName, 
                String testClassName, 
                String testMethodName, 
                Integer userId, 
                Long testTimeoutMs, 
                Long maxTimeToOutputMs, 
                Long maxInstrumentationTimeoutMs, 
                boolean checkResults, 
                boolean isHiddenApiCheckDisabled, 
                boolean isTestApiCheckDisabled, 
                boolean isIsolatedStorageDisabled, 
                boolean isWindowAnimationDisabled, 
                boolean isRestartDisabled, 
                boolean instrumentInPcc, 
                Map<String, String> instrumentationArgs, 
                List<ITestLifeCycleReceiver> extraListeners)

طريقة لتشغيل حزمة أدوات مثبَّتة استخدِم getLastDeviceRunResults() مباشرةً بعد ذلك للحصول على تفاصيل النتائج.

المعلَمات
device ‫ITestDevice: الجهاز الذي سيتم تشغيل أداة القياس عليه.

runner String

pkgName ‫String: اسم الحزمة المطلوب تشغيلها.

testClassName ‫String: اسم فئة الاختبار المطلوب تشغيلها

testMethodName String: اسم طريقة الاختبار في الفئة التي سيتم تنفيذها

userId ‫Integer: معرّف المستخدم الذي سيتم إجراء الاختبار عليه، ويمكن أن تكون القيمة فارغة.

testTimeoutMs ‫Long: المهلة الزمنية بالملي ثانية التي سيتم تطبيقها على كل حالة اختبار.

maxTimeToOutputMs ‫Long: الحد الأقصى لمهلة بدء الاختبار في عرض أي نتائج

maxInstrumentationTimeoutMs ‫Long: الحد الأقصى للمهلة التي يجب أن يكتمل فيها القياس الكامل.

checkResults ‫boolean: تحدّد ما إذا كان يتم التحقّق من النتائج بحثًا عن الأعطال أم لا.

isHiddenApiCheckDisabled ‫boolean: تحدّد ما إذا كان يجب إيقاف عملية التحقّق من واجهة برمجة التطبيقات المخفية أم لا.

isTestApiCheckDisabled ‫boolean: تحدّد ما إذا كان يجب إيقاف فحص واجهة برمجة التطبيقات التجريبية أم لا.

isIsolatedStorageDisabled ‫boolean: ما إذا كان يجب إيقاف مساحة التخزين المعزولة أم لا

isWindowAnimationDisabled ‫boolean: تحدّد هذه السمة ما إذا كان يجب إيقاف حركة النافذة أم لا.

isRestartDisabled boolean

instrumentInPcc boolean

instrumentationArgs ‫Map: وسيطات لتمريرها إلى أداة القياس.

extraListeners List

المرتجعات
boolean صحيح إذا نجحت العملية بدون حدوث أي خطأ. ويتم عرض القيمة "خطأ" إذا لم تكن نقطة الإدخال داخله.

عمليات الطرح
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (ITestDevice device, 
                String runner, 
                String pkgName, 
                String testClassName, 
                String testMethodName, 
                Integer userId, 
                Long testTimeoutMs, 
                Long maxTimeToOutputMs, 
                Long maxInstrumentationTimeoutMs, 
                boolean checkResults, 
                boolean isHiddenApiCheckDisabled, 
                boolean isTestApiCheckDisabled, 
                boolean isIsolatedStorageDisabled, 
                boolean isWindowAnimationDisabled, 
                Map<String, String> instrumentationArgs, 
                List<ITestLifeCycleReceiver> extraListeners)

طريقة لتشغيل حزمة أدوات مثبَّتة استخدِم getLastDeviceRunResults() مباشرةً بعد ذلك للحصول على تفاصيل النتائج.

المعلَمات
device ‫ITestDevice: الجهاز الذي سيتم تشغيل أداة القياس عليه.

runner String

pkgName ‫String: اسم الحزمة المطلوب تشغيلها.

testClassName ‫String: اسم فئة الاختبار المطلوب تشغيلها

testMethodName String: اسم طريقة الاختبار في الفئة التي سيتم تنفيذها

userId ‫Integer: معرّف المستخدم الذي سيتم إجراء الاختبار عليه، ويمكن أن تكون القيمة فارغة.

testTimeoutMs ‫Long: المهلة الزمنية بالملي ثانية التي سيتم تطبيقها على كل حالة اختبار.

maxTimeToOutputMs ‫Long: الحد الأقصى لمهلة بدء الاختبار في عرض أي نتائج

maxInstrumentationTimeoutMs ‫Long: الحد الأقصى للمهلة التي يجب أن يكتمل فيها القياس الكامل.

checkResults ‫boolean: تحدّد ما إذا كان يتم التحقّق من النتائج بحثًا عن الأعطال أم لا.

isHiddenApiCheckDisabled ‫boolean: تحدّد ما إذا كان يجب إيقاف عملية التحقّق من واجهة برمجة التطبيقات المخفية أم لا.

isTestApiCheckDisabled ‫boolean: تحدّد ما إذا كان يجب إيقاف فحص واجهة برمجة التطبيقات التجريبية أم لا.

isIsolatedStorageDisabled ‫boolean: ما إذا كان يجب إيقاف مساحة التخزين المعزولة أم لا

isWindowAnimationDisabled ‫boolean: تحدّد هذه السمة ما إذا كان يجب إيقاف حركة النافذة أم لا.

instrumentationArgs ‫Map: وسيطات لتمريرها إلى أداة القياس.

extraListeners List

المرتجعات
boolean صحيح إذا نجحت العملية بدون حدوث أي خطأ. ويتم عرض القيمة "خطأ" إذا لم تكن نقطة الإدخال داخله.

عمليات الطرح
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (ITestDevice device, 
                String runner, 
                String pkgName, 
                String testClassName, 
                String testMethodName, 
                Integer userId, 
                Long testTimeoutMs, 
                Long maxTimeToOutputMs, 
                Long maxInstrumentationTimeoutMs, 
                boolean checkResults, 
                boolean isHiddenApiCheckDisabled, 
                Map<String, String> instrumentationArgs)

طريقة لتشغيل حزمة أدوات مثبَّتة استخدِم getLastDeviceRunResults() مباشرةً بعد ذلك للحصول على تفاصيل النتائج.

المعلَمات
device ‫ITestDevice: الجهاز الذي سيتم تشغيل أداة القياس عليه.

runner String

pkgName ‫String: اسم الحزمة المطلوب تشغيلها.

testClassName ‫String: اسم فئة الاختبار المطلوب تشغيلها

testMethodName String: اسم طريقة الاختبار في الفئة التي سيتم تنفيذها

userId ‫Integer: معرّف المستخدم الذي سيتم إجراء الاختبار عليه، ويمكن أن تكون القيمة فارغة.

testTimeoutMs ‫Long: المهلة الزمنية بالملي ثانية التي سيتم تطبيقها على كل حالة اختبار.

maxTimeToOutputMs ‫Long: الحد الأقصى لمهلة بدء الاختبار في عرض أي نتائج

maxInstrumentationTimeoutMs ‫Long: الحد الأقصى للمهلة التي يجب أن يكتمل فيها القياس الكامل.

checkResults ‫boolean: تحدّد ما إذا كان يتم التحقّق من النتائج بحثًا عن الأعطال أم لا.

isHiddenApiCheckDisabled ‫boolean: تحدّد ما إذا كان يجب إيقاف عملية التحقّق من واجهة برمجة التطبيقات المخفية أم لا.

instrumentationArgs ‫Map: وسيطات لتمريرها إلى أداة القياس.

المرتجعات
boolean صحيح إذا نجحت العملية بدون حدوث أي خطأ. ويتم عرض القيمة "خطأ" إذا لم تكن نقطة الإدخال داخله.

عمليات الطرح
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (ITestDevice device, 
                String pkgName, 
                String testClassName, 
                String testMethodName, 
                Integer userId, 
                Long testTimeoutMs)

طريقة لتشغيل حزمة أدوات مثبَّتة استخدِم getLastDeviceRunResults() مباشرةً بعد ذلك للحصول على تفاصيل النتائج.

المعلَمات
device ‫ITestDevice: الجهاز الذي سيتم تشغيل أداة القياس عليه.

pkgName ‫String: اسم الحزمة المطلوب تشغيلها.

testClassName ‫String: اسم فئة الاختبار المطلوب تشغيلها

testMethodName String: اسم طريقة الاختبار في الفئة التي سيتم تنفيذها

userId ‫Integer: معرّف المستخدم الذي سيتم إجراء الاختبار عليه، ويمكن أن تكون القيمة فارغة.

testTimeoutMs ‫Long: المهلة الزمنية بالملي ثانية التي سيتم تطبيقها على كل حالة اختبار.

المرتجعات
boolean صحيح إذا نجح بدون فشل. ويتم عرض القيمة "خطأ" إذا لم تكن نقطة الإدخال داخله.

عمليات الطرح
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (ITestDevice device, 
                String pkgName, 
                String testClassName, 
                String testMethodName, 
                Long testTimeoutMs, 
                Long maxTimeToOutputMs, 
                Long maxInstrumentationTimeoutMs)

طريقة لتشغيل حزمة أدوات مثبَّتة استخدِم getLastDeviceRunResults() مباشرةً بعد ذلك للحصول على تفاصيل النتائج.

المعلَمات
device ‫ITestDevice: الجهاز الذي سيتم تشغيل أداة القياس عليه.

pkgName ‫String: اسم الحزمة المطلوب تشغيلها.

testClassName ‫String: اسم فئة الاختبار المطلوب تشغيلها

testMethodName String: اسم طريقة الاختبار في الفئة التي سيتم تنفيذها

testTimeoutMs ‫Long: المهلة الزمنية بالملي ثانية التي سيتم تطبيقها على كل حالة اختبار.

maxTimeToOutputMs ‫Long: الحد الأقصى لمهلة بدء الاختبار في عرض أي نتائج

maxInstrumentationTimeoutMs ‫Long: الحد الأقصى لمهلة إكمال عملية القياس الكامل.

المرتجعات
boolean صحيح إذا نجح بدون فشل. ويتم عرض القيمة "خطأ" إذا لم تكن نقطة الإدخال داخله.

عمليات الطرح
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (ITestDevice device, 
                String pkgName, 
                String testClassName, 
                String testMethodName, 
                Long testTimeoutMs)

طريقة لتشغيل حزمة أدوات مثبَّتة استخدِم getLastDeviceRunResults() مباشرةً بعد ذلك للحصول على تفاصيل النتائج.

المعلَمات
device ‫ITestDevice: الجهاز الذي سيتم تشغيل أداة القياس عليه.

pkgName ‫String: اسم الحزمة المطلوب تشغيلها.

testClassName ‫String: اسم فئة الاختبار المطلوب تشغيلها

testMethodName String: اسم طريقة الاختبار في الفئة التي سيتم تنفيذها

testTimeoutMs ‫Long: المهلة الزمنية بالملي ثانية التي سيتم تطبيقها على كل حالة اختبار.

المرتجعات
boolean صحيح إذا نجح بدون فشل. ويتم عرض القيمة "خطأ" إذا لم تكن نقطة الإدخال داخله.

عمليات الطرح
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (String pkgName, 
                String testClassName, 
                String testMethodName)

طريقة لتشغيل حزمة أدوات مثبَّتة استخدِم getLastDeviceRunResults() مباشرةً بعد ذلك للحصول على تفاصيل النتائج.

المعلَمات
pkgName ‫String: اسم الحزمة المطلوب تشغيلها.

testClassName ‫String: اسم فئة الاختبار المطلوب تشغيلها

testMethodName String: اسم طريقة الاختبار في الفئة التي سيتم تنفيذها

المرتجعات
boolean صحيح إذا نجح بدون فشل. ويتم عرض القيمة "خطأ" إذا لم تكن نقطة الإدخال داخله.

عمليات الطرح
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (DeviceTestRunOptions options)

يتم تشغيل أداة القياس استنادًا إلى المعلومات الواردة في DeviceTestRunOptions.

المعلَمات
options ‫DeviceTestRunOptions: DeviceTestRunOptions الذي يضبط إعدادات الأجهزة.

المرتجعات
boolean صحيح إذا نجحت العملية بدون حدوث أي خطأ. ويتم عرض القيمة "خطأ" إذا لم تكن نقطة الإدخال داخله.

عمليات الطرح
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (ITestDevice device, 
                String runner, 
                String pkgName, 
                String testClassName, 
                String testMethodName, 
                Integer userId, 
                Long testTimeoutMs, 
                Long maxTimeToOutputMs, 
                Long maxInstrumentationTimeoutMs, 
                boolean checkResults, 
                boolean isHiddenApiCheckDisabled, 
                boolean isTestApiCheckDisabled, 
                boolean isIsolatedStorageDisabled, 
                Map<String, String> instrumentationArgs, 
                List<ITestLifeCycleReceiver> extraListeners)

طريقة لتشغيل حزمة أدوات مثبَّتة استخدِم getLastDeviceRunResults() مباشرةً بعد ذلك للحصول على تفاصيل النتائج.

المعلَمات
device ‫ITestDevice: الجهاز الذي سيتم تشغيل أداة القياس عليه.

runner String

pkgName ‫String: اسم الحزمة المطلوب تشغيلها.

testClassName ‫String: اسم فئة الاختبار المطلوب تشغيلها

testMethodName String: اسم طريقة الاختبار في الفئة التي سيتم تنفيذها

userId ‫Integer: معرّف المستخدم الذي سيتم إجراء الاختبار عليه، ويمكن أن تكون القيمة فارغة.

testTimeoutMs ‫Long: المهلة الزمنية بالملي ثانية التي سيتم تطبيقها على كل حالة اختبار.

maxTimeToOutputMs ‫Long: الحد الأقصى لمهلة بدء الاختبار في عرض أي نتائج

maxInstrumentationTimeoutMs ‫Long: الحد الأقصى للمهلة التي يجب أن يكتمل فيها القياس الكامل.

checkResults ‫boolean: تحدّد ما إذا كان يتم التحقّق من النتائج بحثًا عن الأعطال أم لا.

isHiddenApiCheckDisabled ‫boolean: تحدّد ما إذا كان يجب إيقاف عملية التحقّق من واجهة برمجة التطبيقات المخفية أم لا.

isTestApiCheckDisabled ‫boolean: تحدّد ما إذا كان يجب إيقاف فحص واجهة برمجة التطبيقات التجريبية أم لا.

isIsolatedStorageDisabled ‫boolean: ما إذا كان يجب إيقاف مساحة التخزين المعزولة أم لا

instrumentationArgs ‫Map: وسيطات لتمريرها إلى أداة القياس.

extraListeners List

المرتجعات
boolean صحيح إذا نجحت العملية بدون حدوث أي خطأ. ويتم عرض القيمة "خطأ" إذا لم تكن نقطة الإدخال داخله.

عمليات الطرح
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (ITestDevice device, 
                String pkgName, 
                String testClassName, 
                String testMethodName)

طريقة لتشغيل حزمة أدوات مثبَّتة استخدِم getLastDeviceRunResults() مباشرةً بعد ذلك للحصول على تفاصيل النتائج.

المعلَمات
device ‫ITestDevice: الجهاز الذي سيتم تشغيل أداة القياس عليه.

pkgName ‫String: اسم الحزمة المطلوب تشغيلها.

testClassName ‫String: اسم فئة الاختبار المطلوب تشغيلها

testMethodName String: اسم طريقة الاختبار في الفئة التي سيتم تنفيذها

المرتجعات
boolean صحيح إذا نجح بدون فشل. ويتم عرض القيمة "خطأ" إذا لم تكن نقطة الإدخال داخله.

عمليات الطرح
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (String pkgName, 
                String testClassName, 
                Integer userId, 
                Long testTimeoutMs)

طريقة لتشغيل حزمة أدوات مثبَّتة استخدِم getLastDeviceRunResults() مباشرةً بعد ذلك للحصول على تفاصيل النتائج.

المعلَمات
pkgName ‫String: اسم الحزمة المطلوب تشغيلها.

testClassName ‫String: اسم فئة الاختبار المطلوب تشغيلها

userId ‫Integer: معرّف المستخدم الذي سيتم إجراء الاختبار عليه، ويمكن أن تكون القيمة فارغة.

testTimeoutMs ‫Long: المهلة الزمنية بالملي ثانية التي سيتم تطبيقها على كل حالة اختبار.

المرتجعات
boolean صحيح إذا نجح بدون فشل. ويتم عرض القيمة "خطأ" إذا لم تكن نقطة الإدخال داخله.

عمليات الطرح
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (String pkgName, 
                String testClassName)

طريقة لتشغيل حزمة أدوات مثبَّتة استخدِم getLastDeviceRunResults() مباشرةً بعد ذلك للحصول على تفاصيل النتائج.

المعلَمات
pkgName ‫String: اسم الحزمة المطلوب تشغيلها.

testClassName ‫String: اسم فئة الاختبار المطلوب تشغيلها

المرتجعات
boolean صحيح إذا نجح بدون فشل. ويتم عرض القيمة "خطأ" إذا لم تكن نقطة الإدخال داخله.

عمليات الطرح
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (String pkgName, 
                String testClassName, 
                Long testTimeoutMs)

طريقة لتشغيل حزمة أدوات مثبَّتة استخدِم getLastDeviceRunResults() مباشرةً بعد ذلك للحصول على تفاصيل النتائج.

المعلَمات
pkgName ‫String: اسم الحزمة المطلوب تشغيلها.

testClassName ‫String: اسم فئة الاختبار المطلوب تشغيلها

testTimeoutMs ‫Long: المهلة الزمنية بالملي ثانية التي سيتم تطبيقها على كل حالة اختبار.

المرتجعات
boolean صحيح إذا نجح بدون فشل. ويتم عرض القيمة "خطأ" إذا لم تكن نقطة الإدخال داخله.

عمليات الطرح
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (String runner, 
                String pkgName, 
                String testClassName, 
                String testMethodName)

طريقة لتشغيل حزمة أدوات مثبَّتة استخدِم getLastDeviceRunResults() مباشرةً بعد ذلك للحصول على تفاصيل النتائج.

المعلَمات
runner ‫String: أداة تشغيل أدوات القياس التي سيتم استخدامها

pkgName ‫String: اسم الحزمة المطلوب تشغيلها.

testClassName ‫String: اسم فئة الاختبار المطلوب تشغيلها

testMethodName String: اسم طريقة الاختبار في الفئة التي سيتم تنفيذها

المرتجعات
boolean صحيح إذا نجح بدون فشل. ويتم عرض القيمة "خطأ" إذا لم تكن نقطة الإدخال داخله.

عمليات الطرح
DeviceNotAvailableException

setAbi

public final void setAbi (IAbi abi)

المعلَمات
abi IAbi

setTestInformation

public final void setTestInformation (TestInformation testInformation)

المعلَمات
testInformation TestInformation

uninstallPackage

public final String uninstallPackage (String pkgName)

تؤدي هذه السياسة إلى إلغاء تثبيت حزمة على الجهاز.

المعلَمات
pkgName ‫String: حزمة Android التي سيتم إلغاء تثبيتها

المرتجعات
String ‫String مع رمز خطأ، أو null في حال النجاح

عمليات الطرح
DeviceNotAvailableException

uninstallPackage

public final String uninstallPackage (ITestDevice device, 
                String pkgName)

إلغاء تثبيت حزمة على الجهاز

المعلَمات
device استبدِل ITestDevice بالجهاز الذي يجب إلغاء تثبيت الحزمة عليه.

pkgName ‫String: حزمة Android التي سيتم إلغاء تثبيتها

المرتجعات
String ‫String مع رمز خطأ، أو null في حال النجاح

عمليات الطرح
DeviceNotAvailableException