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

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

protected boolean mInstrumentSdkInSandbox

protected boolean mInstrumentSdkSandbox

المقاولين العامة

InstrumentationTest ()

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

void addDeviceListeners ( extraListeners) addDeviceListeners ( extraListeners)

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

void addInstrumentationArg (String key, String value)

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

IAbi getAbi ()
IConfiguration getConfiguration ()

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

String getCoverageTarget ()

احصل على CoverTarget الذي تم تعيينه مسبقًا عبر 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 المحددة للتشغيل التجريبي.

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)

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

void setTestFilePathOnDevice (String testFilePathOnDevice)

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

void setTestPackageName (String testPackageName)

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

void setTestSize (String size)

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

void setTestTimeout (long timeout)

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

void setTestsToRun ( tests) setTestsToRun ( tests)

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

void setWindowAnimation (boolean windowAnimation)

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

static excludeNonExecuted ( TestRunResult results)

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

String getClassName ()

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

ListInstrumentationParser getListInstrumentationParser ()

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

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

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

المقاولين العامة

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

public InstrumentationTest ()

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

addDeviceListeners

public void addDeviceListeners ( extraListeners)

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

حدود
extraListeners

addInstrumentationArg

public void addInstrumentationArg (String key, 
                String value)

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

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

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

com.getAbi

public IAbi getAbi ()

عائدات
IAbi

getConfiguration

public IConfiguration getConfiguration ()

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

عائدات
IConfiguration

getCoverageTarget

public String getCoverageTarget ()

احصل على CoverTarget الذي تم تعيينه مسبقًا عبر setCoverageTarget(String) .

عائدات
String

getDebug

public boolean getDebug ()

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

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

com.getDevice

public ITestDevice getDevice ()

قم بإخضاع الجهاز للاختبار.

عائدات
ITestDevice جهاز ITestDevice

com.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

com.setForceAbi

public void setForceAbi (String abi)

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

setInstallFile

public void setInstallFile (File installFile)

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

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

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

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

حدود
isolatedStorage boolean

setMethodName

public void setMethodName (String testMethodName)

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

حدود
testMethodName String

setMetricCollectors

public void setMetricCollectors ( collectors)

يقوم بتعيين قائمة IMetricCollector المحددة للتشغيل التجريبي.

حدود
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)

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

حدود
timeout long

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

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

حدود
testFilePathOnDevice String

setTestPackageName

public void setTestPackageName (String testPackageName)

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

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

سيتم تجاهله إذا تم توفير قيمة غير فارغة إلى 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)

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

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

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

حدود
windowAnimation boolean

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

excludeNonExecuted

protected static  excludeNonExecuted (TestRunResult results)

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

حدود
results TestRunResult

عائدات

getClassName

protected String getClassName ()

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

عائدات
String

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

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

عائدات
ListInstrumentationParser

getMethodName

protected String getMethodName ()

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

عائدات
String

getTestPackageName

protected String getTestPackageName ()

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

عائدات
String

queryRunnerName

protected String queryRunnerName ()

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

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

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

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

حدود
runner IRemoteAndroidTestRunner