InstrumentationTest

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

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)

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

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)

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

void setForceAbi(String abi)

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

void setInstallFile(File installFile)

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

void setIsolatedStorage(boolean isolatedStorage)

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

void setMethodName(String testMethodName)

يمكنك اختياريًا ضبط طريقة الاختبار لتشغيلها.

void setMetricCollectors( collectors)

تُستخدَم لضبط قائمة IMetricCollector المحدّدة لتشغيل الاختبار.

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 المستخدَمة لتحليل طلبات البحث عن "أدوات قياس أداء قائمة pm".

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_ON_SDK_SANDBOX

public static final String 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)

تم إيقاف هذه الطريقة نهائيًا.
هذه الطريقة لا تؤدي إلى أي إجراء

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

المعلمات
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)

اضبط القيمة على True إذا فرضنا تنسيق إخراج 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)

تُستخدَم لضبط قائمة IMetricCollector المحدّدة لتشغيل الاختبار.

المعلمات
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 اسم مشغّل الاختبار الأول الذي يتطابق مع الحزمة أو القيمة null إذا لم نعثر على أيّ مشغّل اختبار
عمليات الرمي
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

المعلمات
runner IRemoteAndroidTestRunner