أجهزة الاختبار

public class InstrumentationTest
extends Object implements IDeviceTest , IRemoteTest , ITestCollector , IAbiReceiver , IConfigurationReceiver , IMetricCollectorReceiver

java.lang.Object
↳ com.android.tradefed.testtype.InstrumentationTest

اختبار يقوم بتشغيل حزمة اختبار الأجهزة على جهاز معين.

ملخص

مجالات

public static final String RUN_TESTS_AS_USER_KEY

public static final String RUN_TESTS_ON_SDK_SANDBOX

protected boolean mDebug

المنشأت العامة

InstrumentationTest ()

الأساليب العامة

void addDeviceListeners ( extraListeners) addDeviceListeners ( extraListeners)

يسمح بإضافة المزيد من المستمعين المخصصين إلى العداء

void addInstrumentationArg (String key, String value)

أضف وسيطة لتقديمها عند إجراء اختبارات الأجهزة.

IAbi getAbi ()
IConfiguration getConfiguration ()

يحصل على IConfiguration لهذا الاختبار.

String getCoverageTarget ()

احصل على تغطية الهدف المحدد مسبقًا عبر setCoverageTarget(String) .

boolean getDebug ()

احصل على إعداد تصحيح أخطاء الأجهزة.

ITestDevice getDevice ()

احصل على الجهاز قيد الاختبار.

String getForceAbi ()
long getMaxTimeout ()

إرجاع الحد الأقصى للمهلة المحددة للأجهزة.

String getPackageName ()

احصل على حزمة بيان Android للتشغيل.

String getRunName ()

احصل على الاسم المخصص للتشغيل التجريبي الذي سيتم توفيره للمستمع

String getRunnerName ()

الحصول على عداء أجهزة Android ليتم استخدامه.

void run ( TestInformation testInfo, ITestInvocationListener listener)

يجري الاختبارات ، ويبلغ نتائجها للمستمع.

void setAbi ( IAbi abi)
void setClassName (String testClassName)

اختياريًا ، قم بتعيين اسم فئة الاختبار للتشغيل.

void setCollectTestsOnly (boolean shouldCollectTest)

يمكّن أو يعطل وضع مجموعة الاختبار

void setCollectsTestsShellTimeout (int timeout)

هذه الطريقة مهملة. هذه الطريقة غير عملية

void setConfiguration ( IConfiguration config)

يُحقن رمز IConfiguration قيد الاستخدام.

void setCoverageTarget (String coverageTarget)

حدد هدف التغطية لهذا الاختبار.

void setDebug (boolean debug)

اضبط إعداد تصحيح أخطاء الأجهزة.

void setDevice ( ITestDevice device)

احقن الجهاز قيد الاختبار.

void setEnforceFormat (boolean enforce)

اضبط True إذا فرضنا تنسيق إخراج AJUR للأجهزة.

void setForceAbi (String abi)

يضبط خيار Force-abi.

void setInstallFile (File installFile)

قم بتعيين الملف الاختياري المراد تثبيته والذي يحتوي على الاختبارات.

void setIsolatedStorage (boolean isolatedStorage)

تعيين الرطوبة أو عدم استخدام التخزين المعزول.

void setMethodName (String testMethodName)

اختياريًا ، قم بتعيين طريقة الاختبار للتشغيل.

void setMetricCollectors ( collectors) setMetricCollectors ( collectors)

يضبط قائمة IMetricCollector s المحددة للتشغيل التجريبي.

void setPackageName (String packageName)

قم بتعيين حزمة بيان Android للتشغيل.

void setReRunUsingTestFile (boolean reRunUsingTestFile)

يضبط الخيار --rerun-from-file.

void setRerunMode (boolean rerun)

اختياريًا ، قم بتعيين وضع إعادة التشغيل.

void setRunName (String runName)

قم بتعيين اسم التشغيل التجريبي المخصص الذي سيتم توفيره للمستمع

void setRunnerName (String runnerName)

اختياريًا ، قم بتعيين عداء أجهزة Android للاستخدام.

void setShellTimeout (long timeout)

اختياريًا ، قم بتعيين الحد الأقصى للوقت (بالمللي ثانية) لتوقع إخراج shell من الجهاز.

void setTestFilePathOnDevice (String testFilePathOnDevice)

اختياريًا ، قم بتعيين المسار إلى ملف موجود على الجهاز الذي يجب أن يحتوي على قائمة بفئات وأساليب الاختبار المفصولة عن الأسطر (التنسيق: أسلوب com.foo.Class #) ليتم تشغيله.

void setTestPackageName (String testPackageName)

يضبط مرشح حزمة الاختبار.

void setTestSize (String size)

اختياريًا ، قم بتعيين حجم الاختبار للتشغيل.

void setTestTimeout (long timeout)

اختياريًا ، قم بتعيين الحد الأقصى للوقت (بالمللي ثانية) لكل تشغيل اختباري فردي.

void setTestsToRun ( tests) setTestsToRun ( tests)

قم بتعيين مجموعة الاختبارات التي يجب تنفيذها بواسطة اختبار الأجهزة هذا.

void setWindowAnimation (boolean windowAnimation)

الطرق المحمية

static excludeNonExecuted ( TestRunResult results)

تصفية "NOT_EXECUTED" لغرض تتبع ما يجب إعادة تشغيله.

String getClassName ()

احصل على اسم الفصل للتشغيل.

ListInstrumentationParser getListInstrumentationParser ()

احصل على ListInstrumentationParser المستخدمة لتحليل استعلامات "أدوات قائمة pm".

String getMethodName ()

احصل على طريقة الاختبار للتشغيل.

String getTestPackageName ()

احصل على حزمة جافا التجريبية للتشغيل.

String queryRunnerName ()

استعلم عن الجهاز لاستخدام عداء اختبار.

void setRunnerArgs (IRemoteAndroidTestRunner runner)

مجالات

RUN_TESTS_AS_USER_KEY

public static final String RUN_TESTS_AS_USER_KEY

RUN_TESTS_ON_SDK_SANDBOX

public static final String RUN_TESTS_ON_SDK_SANDBOX

mDebug

protected boolean mDebug

المنشأت العامة

أجهزة الاختبار

public InstrumentationTest ()

الأساليب العامة

addDeviceListeners

public void addDeviceListeners ( extraListeners)

يسمح بإضافة المزيد من المستمعين المخصصين إلى العداء

حدود
extraListeners

addIn InstrumentationArg

public void addInstrumentationArg (String key, 
                String value)

أضف وسيطة لتقديمها عند إجراء اختبارات الأجهزة.

حدود
key String : اسم الوسيطة

value String : قيمة الوسيطة

getAbi

public IAbi getAbi ()

عائدات
IAbi

getConfiguration

public IConfiguration getConfiguration ()

يحصل على IConfiguration لهذا الاختبار.

عائدات
IConfiguration

getCoverageTarget

public String getCoverageTarget ()

احصل على تغطية الهدف المحدد مسبقًا عبر setCoverageTarget(String) .

عائدات
String

getDebug

public boolean getDebug ()

احصل على إعداد تصحيح أخطاء الأجهزة.

عائدات
boolean إعداد التصحيح المنطقي.

getDevice

public ITestDevice getDevice ()

احصل على الجهاز قيد الاختبار.

عائدات
ITestDevice ITestDevice

getForceAbi

public String getForceAbi ()

عائدات
String

getMaxTimeout

public long getMaxTimeout ()

إرجاع الحد الأقصى للمهلة المحددة للأجهزة.

عائدات
long

getPackageName

public String getPackageName ()

احصل على حزمة بيان Android للتشغيل.

عائدات
String

getRunName

public String getRunName ()

احصل على الاسم المخصص للتشغيل التجريبي الذي سيتم توفيره للمستمع

عائدات
String

getRunnerName

public String getRunnerName ()

الحصول على عداء أجهزة Android ليتم استخدامه.

عائدات
String

يجري

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

يجري الاختبارات ، ويبلغ نتائجها للمستمع.

حدود
testInfo TestInformation : يحتوي كائن TestInformation على معلومات مفيدة لتشغيل الاختبارات.

listener ITestInvocationListener : ITestInvocationListener لنتائج الاختبار

رميات
DeviceNotAvailableException

setAbi

public void setAbi (IAbi abi)

حدود
abi IAbi

setClassName

public void setClassName (String testClassName)

اختياريًا ، قم بتعيين اسم فئة الاختبار للتشغيل.

حدود
testClassName String

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

يمكّن أو يعطل وضع مجموعة الاختبار

setCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

هذه الطريقة مهملة.
هذه الطريقة غير عملية

اضبط الحد الأقصى للوقت بالمللي ثانية للسماح بـ "الحد الأقصى للوقت لاستجابة استجابة الإخراج" عند تجميع الاختبارات.

حدود
timeout int

setConfiguration

public void setConfiguration (IConfiguration config)

يُحقن رمز IConfiguration قيد الاستخدام.

حدود
config IConfiguration

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

حدد هدف التغطية لهذا الاختبار.

غير مستخدم حاليا. هذه الطريقة موجودة فقط لذا يمكن استرداد CoverTarget لاحقًا عبر getCoverageTarget()

حدود
coverageTarget String

setDebug

public void setDebug (boolean debug)

اضبط إعداد تصحيح أخطاء الأجهزة.

حدود
debug قيمة boolean : قيمة منطقية لتعيين إعداد تصحيح أخطاء الأجهزة على.

setDevice

public void setDevice (ITestDevice device)

احقن الجهاز قيد الاختبار.

حدود
device ITestDevice : جهاز ITestDevice المطلوب استخدامه

setEnforceFormat

public void setEnforceFormat (boolean enforce)

اضبط True إذا فرضنا تنسيق إخراج AJUR للأجهزة.

حدود
enforce boolean

setForceAbi

public void setForceAbi (String abi)

يضبط خيار Force-abi.

setInstallFile

public void setInstallFile (File installFile)

قم بتعيين الملف الاختياري المراد تثبيته والذي يحتوي على الاختبارات.

حدود
installFile File : ERROR(/File)

مجموعة معزولة التخزين

public void setIsolatedStorage (boolean isolatedStorage)

اضبط الطقس أو لا تستخدم التخزين المعزول.

حدود
isolatedStorage boolean

setMethodName

public void setMethodName (String testMethodName)

اختياريًا ، قم بتعيين طريقة الاختبار للتشغيل.

حدود
testMethodName String

setMetricCollectors

public void setMetricCollectors ( collectors)

يضبط قائمة IMetricCollector s المحددة للتشغيل التجريبي.

حدود
collectors

setPackageName

public void setPackageName (String packageName)

قم بتعيين حزمة بيان Android للتشغيل.

حدود
packageName String

setReRunUsingTestFile

public void setReRunUsingTestFile (boolean reRunUsingTestFile)

يضبط الخيار --rerun-from-file.

حدود
reRunUsingTestFile boolean

وضع setRerunMode

public void setRerunMode (boolean rerun)

اختياريًا ، قم بتعيين وضع إعادة التشغيل.

حدود
rerun boolean

setRunName

public void setRunName (String runName)

قم بتعيين اسم التشغيل التجريبي المخصص الذي سيتم توفيره للمستمع

حدود
runName String

setRunnerName

public void setRunnerName (String runnerName)

اختياريًا ، قم بتعيين عداء أجهزة Android للاستخدام.

حدود
runnerName String

setShellTimeout

public void setShellTimeout (long timeout)

اختياريًا ، قم بتعيين الحد الأقصى للوقت (بالمللي ثانية) لتوقع إخراج shell من الجهاز.

حدود
timeout long

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

اختياريًا ، قم بتعيين المسار إلى ملف موجود على الجهاز الذي يجب أن يحتوي على قائمة بفئات وأساليب الاختبار المفصولة عن الأسطر (التنسيق: أسلوب com.foo.Class #) ليتم تشغيله. في حالة الضبط ، ستحاول تلقائيًا إعادة تشغيل الاختبارات باستخدام ملف الاختبار هذا عبر InstrumentationFileTest بدلاً من تنفيذ أوامر adb منفصلة لكل اختبار متبقي عبر إعادة التشغيل.

حدود
testFilePathOnDevice String

setTestPackageName

public void setTestPackageName (String testPackageName)

يضبط مرشح حزمة الاختبار.

إذا لم يكن فارغًا ، فسيتم تنفيذ الاختبارات داخل حزمة جافا المحددة فقط.

سيتم تجاهله إذا تم توفير قيمة غير فارغة لـ setClassName(String)

حدود
testPackageName String

setTestSize

public void setTestSize (String size)

اختياريًا ، قم بتعيين حجم الاختبار للتشغيل.

حدود
size String

setTestTimeout

public void setTestTimeout (long timeout)

اختياريًا ، قم بتعيين الحد الأقصى للوقت (بالمللي ثانية) لكل تشغيل اختباري فردي.

حدود
timeout long

setTestsToRun

public void setTestsToRun ( tests)

قم بتعيين مجموعة الاختبارات التي يجب تنفيذها بواسطة اختبار الأجهزة هذا.

حدود
tests : الاختبارات للتشغيل

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

حدود
windowAnimation boolean

الطرق المحمية

استبعاد غير مُنفَّذ

protected static  excludeNonExecuted (TestRunResult results)

تصفية "NOT_EXECUTED" لغرض تتبع ما يجب إعادة تشغيله.

حدود
results TestRunResult

عائدات

getClassName

protected String getClassName ()

احصل على اسم الفصل للتشغيل.

عائدات
String

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

احصل على ListInstrumentationParser المستخدمة لتحليل استعلامات "أدوات قائمة pm".

عائدات
ListInstrumentationParser

getMethodName

protected String getMethodName ()

احصل على طريقة الاختبار للتشغيل.

عائدات
String

getTestPackageName

protected String getTestPackageName ()

احصل على حزمة جافا التجريبية للتشغيل.

عائدات
String

الاستعلام

protected String queryRunnerName ()

استعلم عن الجهاز لاستخدام عداء اختبار.

عائدات
String اسم عداء الاختبار الأول الذي يطابق الحزمة أو فارغًا إذا لم نعثر على أي منها.

رميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

حدود
runner IRemoteAndroidTestRunner