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 mInstrumentInPcc

protected boolean mInstrumentSdkInSandbox

protected boolean mInstrumentSdkSandbox

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

InstrumentationTest()

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

void addDeviceListeners(Set<String> 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 isCollectTestsOnly()
boolean isOrchestrator()

لعرض قيمة ERROR(InstrumentationTest.mOrchestrator/#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(List<IMetricCollector> collectors)

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

void setOrchestrator(boolean useOrchestrator)

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

void setPackageName(String packageName)

اضبط حزمة ملف بيان Android لتشغيلها.

void setReRunUsingTestFile(boolean reRunUsingTestFile)

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

void setRerunMode(boolean rerun)

يمكنك اختياريًا ضبط وضع إعادة العرض.

void setRetryAttemptNumber(int attemptNumber)

تضبط هذه السمة عدد محاولات إعادة الاختبار.

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

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(Collection<TestDescription> tests)

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

void setWindowAnimation(boolean windowAnimation)

طُرق محمية

static Set<TestDescription> 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

mInstrumentInPcc

protected boolean mInstrumentInPcc

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

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

InstrumentationTest

public InstrumentationTest ()

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

addDeviceListeners

public void addDeviceListeners (Set<String> extraListeners)

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

المعلَمات
extraListeners Set

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

isCollectTestsOnly

public boolean isCollectTestsOnly ()

المرتجعات
boolean ما إذا كان هذا الاختبار في وضع جمع الاختبارات فقط.

isOrchestrator

public boolean isOrchestrator ()

لعرض قيمة ERROR(InstrumentationTest.mOrchestrator/#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: File القابل للتثبيت

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

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

المعلَمات
isolatedStorage boolean

setMethodName

public void setMethodName (String testMethodName)

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

المعلَمات
testMethodName String

setMetricCollectors

public void setMetricCollectors (List<IMetricCollector> collectors)

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

المعلَمات
collectors List

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

setRetryAttemptNumber

public void setRetryAttemptNumber (int attemptNumber)

تضبط هذه السمة عدد محاولات إعادة الاختبار. لا يفعل الإعداد التلقائي أي شيء.

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

المعلَمات
attemptNumber int

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 (Collection<TestDescription> tests)

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

المعلَمات
tests ‫Collection: الاختبارات التي سيتم إجراؤها

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

المعلَمات
windowAnimation boolean

طُرق محمية

excludeNonExecuted

protected static Set<TestDescription> excludeNonExecuted (TestRunResult results)

إزالة القيم "NOT_EXECUTED" و"تم تخطّيها" بغرض تتبُّع ما يجب إعادة تنفيذه

المعلَمات
results TestRunResult

المرتجعات
Set<TestDescription>

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