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

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

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

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

---

اختبار يقوم بتشغيل حزمة اختبار الأجهزة على جهاز معين.

ملخص

مجالات
public static final String	RUN_TESTS_AS_USER_KEY
public static final String	RUN_TESTS_ON_SDK_SANDBOX
protected boolean	mDebug

المقاولين العامة
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

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

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

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	اسم عداء الاختبار الأول الذي يطابق الحزمة أو فارغًا إذا لم نجد أيًا منها.

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

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

حدود
runner	IRemoteAndroidTestRunner