InstrumentationTest

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

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

اختبار ينفّذ حزمة اختبار أدوات على جهاز معيّن.

ملخّص

الثوابت

String RUN_TESTS_AS_USER_KEY

String RUN_TESTS_ON_SDK_SANDBOX

الحقول

protected boolean mDebug

protected boolean mInstrumentSdkInSandbox

protected boolean mInstrumentSdkSandbox

الإنشاءات العامة

InstrumentationTest()

الطُرق العامة

void addDeviceListeners( extraListeners)

تتيح إضافة المزيد من أدوات الاستماع المخصّصة إلى أداة التنفيذ

void addInstrumentationArg(String key, String value)

أضِف وسيطًا لتوفيره عند تنفيذ اختبارات الأجهزة.

IAbi getAbi()
IConfiguration getConfiguration()

تعرض هذه السمة IConfiguration لهذا الاختبار.

String getCoverageTarget()

احصل على coverageTarget الذي تم ضبطه سابقًا من خلال setCoverageTarget(String).

boolean getDebug()

الحصول على إعداد تصحيح الأخطاء في أداة القياس

ITestDevice getDevice()

احصل على الجهاز الخاضع للاختبار.

String getForceAbi()
long getMaxTimeout()

تعرض هذه السمة الحد الأقصى للمهلة المضبوطة لأدوات القياس.

String getPackageName()

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

String getRunName()

الحصول على اسم التشغيل التجريبي المخصّص الذي سيتم تقديمه إلى المستمع

String getRunnerName()

تعرض هذه السمة أداة تشغيل أدوات Android.

boolean isOrchestrator()

لعرض قيمة ERROR(InstrumentationTest.mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest.mOrchestrator)

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)

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

void setForceAbi(String abi)

تضبط هذه السمة الخيار force-abi.

void setInstallFile(File installFile)

اضبط الملف الاختياري الذي سيتم تثبيته والذي يحتوي على الاختبارات.

void setIsolatedStorage(boolean isolatedStorage)

تحديد ما إذا كان سيتم استخدام مساحة التخزين المعزولة أم لا

void setMethodName(String testMethodName)

يمكنك اختياريًا ضبط طريقة الاختبار التي سيتم تنفيذها.

void setMetricCollectors( collectors)

تضبط هذه السمة قائمة IMetricCollectors المحدّدة لتشغيل الاختبار.

void setOrchestrator(boolean useOrchestrator)

تضبط هذه السمة الخيار ‎--orchestrator

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#method) ليتم تنفيذها.

void setTestPackageName(String testPackageName)

تضبط هذه السمة فلتر حِزم الاختبار.

void setTestSize(String size)

يمكنك اختياريًا ضبط حجم الاختبار الذي تريد تنفيذه.

void setTestTimeout(long timeout)

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

void setTestsToRun( tests)

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

void setWindowAnimation(boolean windowAnimation)

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

static excludeNonExecuted(TestRunResult results)

يمكنك فلترة النتائج حسب "NOT_EXECUTED" و"تم التخطّي" لتتبُّع ما يجب إعادة تنفيذه.

String getClassName()

احصل على اسم الفئة المطلوب تنفيذها.

ListInstrumentationParser getListInstrumentationParser()

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

String getMethodName()

احصل على طريقة الاختبار التي سيتم تنفيذها.

String getTestPackageName()

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

String queryRunnerName()

طلب برنامج تشغيل اختبار من الجهاز

void setRunnerArgs(IRemoteAndroidTestRunner runner)

الثوابت

RUN_TESTS_AS_USER_KEY

public static final String RUN_TESTS_AS_USER_KEY

القيمة الثابتة: "RUN_TESTS_AS_USER"

RUN_TESTS_ON_SDK_SANDBOX

public static final String RUN_TESTS_ON_SDK_SANDBOX

القيمة الثابتة: "RUN_TESTS_ON_SDK_SANDBOX"

الحقول

mDebug

protected boolean mDebug

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

الإنشاءات العامة

InstrumentationTest

public InstrumentationTest ()

الطُرق العامة

addDeviceListeners

public void addDeviceListeners ( extraListeners)

تتيح إضافة المزيد من أدوات الاستماع المخصّصة إلى أداة التنفيذ

المعلمات
extraListeners

addInstrumentationArg

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 ()

احصل على coverageTarget الذي تم ضبطه سابقًا من خلال 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

isOrchestrator

public boolean isOrchestrator ()

لعرض قيمة ERROR(InstrumentationTest.mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest.mOrchestrator)

المرتجعات
boolean

ضربة طويلة

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)

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

هذا الحقل غير مستخدَم حاليًا. تتوفّر هذه الطريقة فقط حتى يمكن استرداد coverageTarget لاحقًا من خلال 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)

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

المعلمات
enforce boolean

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)

تضبط هذه السمة قائمة IMetricCollectors المحدّدة لتشغيل الاختبار.

المعلمات
collectors

setOrchestrator

public void setOrchestrator (boolean useOrchestrator)

تضبط هذه السمة الخيار --orchestrator.

المعلمات
useOrchestrator boolean

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#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 ()

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

المرتجعات
String

queryRunnerName

protected String queryRunnerName ()

طلب برنامج تشغيل اختبار من الجهاز

المرتجعات
String اسم أول أداة اختبار تتطابق مع الحزمة أو قيمة فارغة إذا لم نعثر على أي أداة.
الرميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

المعلمات
runner IRemoteAndroidTestRunner