InstrumentationTest

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

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

الفئات الفرعية المباشرة المعروفة ‫AndroidJUnitTest وCodeCoverageTest AndroidJUnitTest اختبار يشغّل حزمة اختبار أدوات على جهاز معيّن باستخدام android.support.test.runner.AndroidJUnitRunner.  CodeCoverageTest اختبار ينفِّذ حزمة اختبار أدوات على جهاز معيّن وينشئ تقرير تغطية الرمز البرمجي.

---

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

ملخّص

الثوابت
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