اختبار قياس حالة التطبيق

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

---

يشير ذلك المصطلح إلى اختبار يشغِّل حزمة اختبار أدوات على جهاز معيّن.

ملخّص

الحقول
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() يمكنك الحصول على ميزة "تغطية التغطية" التي تم ضبطها سابقًا من خلال "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) تحدِّد هذه السياسة قائمة 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) يمكنك اختياريًا ضبط الحد الأقصى للوقت (بالمللي ثانية) الذي يمكن أن يتم فيه عرض واجهة الأوامر من الجهاز.
void	setTestFilePathOnDevice(String testFilePathOnDevice) اختياريًا، يمكنك ضبط المسار إلى ملف موجود على الجهاز الذي يجب أن يحتوي على قائمة من الأسطر فئات الاختبار وطرقه المنفصلة (التنسيق: com.foo.Class#method) المطلوب تشغيلها.
void	setTestPackageName(String testPackageName) تضبط هذه السياسة فلتر حزمة الاختبار.
void	setTestSize(String size) اختياريًا، يمكنك ضبط حجم الاختبار المطلوب تنفيذه.
void	setTestTimeout(long timeout) يمكنك اختياريًا ضبط الحدّ الأقصى للوقت (بالمللي ثانية) لكلّ عملية اختبار على حدة.
void	setTestsToRun( tests) حدِّد مجموعة الاختبارات التي يجب تنفيذها بواسطة اختبار قياس حالة التطبيق.
void	setWindowAnimation(boolean windowAnimation)

الطرق المحمية
static	excludeNonExecuted(TestRunResult results) تصفية "NOT_EXECUTED" وتخطيها بهدف تتبُّع ما يجب إعادة تشغيله.
String	getClassName() احصل على اسم الفئة لتنفيذه.
ListInstrumentationParser	getListInstrumentationParser() الحصول على ListInstrumentationParser المستخدم في تحليل "أداة قائمة مساءً" طلبات البحث.
String	getMethodName() احصل على طريقة الاختبار للتشغيل.
String	getTestPackageName() احصل على حزمة test 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

شركة إنشاءات عامة

اختبار قياس حالة التطبيق

public InstrumentationTest ()

الطرق العامة

addDeviceListeners

public void addDeviceListeners ( extraListeners)

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

المعلمات
extraListeners

متوسط مقياس الإعلانات

public void addInstrumentationArg (String key, 
                String value)

إضافة وسيطة لتقديمها عند إجراء اختبارات الأدوات.

المعلمات
key	String: اسم الوسيطة
value	String: قيمة الوسيطة

جيت آبي

public IAbi getAbi ()

المرتجعات
IAbi

getConfiguration

public IConfiguration getConfiguration ()

الحصول على IConfiguration لهذا الاختبار.

المرتجعات
IConfiguration

هدف التغطية

public String getCoverageTarget ()

يمكنك الحصول على ميزة "تغطية التغطية" التي تم ضبطها سابقًا من خلال "setCoverageTarget(String)".

المرتجعات
String

الحصول على تصحيح الأخطاء

public boolean getDebug ()

الحصول على إعداد تصحيح أخطاء الأدوات.

المرتجعات
boolean	إعداد تصحيح الأخطاء المنطقي.

الحصول على جهاز

public ITestDevice getDevice ()

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

المرتجعات
ITestDevice	ITestDevice

GetForceAbi

public String getForceAbi ()

المرتجعات
String

الحصول على الحد الأقصى للمهلة

public long getMaxTimeout ()

تعرض الحد الأقصى للمهلة المحددة للأداة.

المرتجعات
long

الحصول على اسم الحزمة

public String getPackageName ()

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

المرتجعات
String

الحصول على RunName

public String getRunName ()

الحصول على الاسم المخصّص لعملية الاختبار الذي سيتم تقديمه للمستمِع

المرتجعات
String

الحصول على RunnerName

public String getRunnerName ()

يتيح هذا الإعداد استخدام عدّاء أدوات Android.

المرتجعات
String

منسّق

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

ضبط آبي

public void setAbi (IAbi abi)

المعلمات
abi	IAbi

اسم الصف

public void setClassName (String testClassName)

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

المعلمات
testClassName	String

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

تفعيل وضع جمع الاختبارات أو إيقافه

setCollectsTestsShellمهلة

public void setCollectsTestsShellTimeout (int timeout)

تم إيقاف هذه الطريقة نهائيًا.
لا يمكن تنفيذ هذه الطريقة

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

المعلمات
timeout	int

ضبط الإعدادات

public void setConfiguration (IConfiguration config)

إدخال IConfiguration قيد الاستخدام.

المعلمات
config	IConfiguration

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

يمكنك إعداد التغطية المستهدفة لهذا الاختبار.

غير مُستخدَم حاليًا. هذه الطريقة متاحة فقط بحيث يمكن استرداد تغطيةTarget لاحقًا عبر getCoverageTarget()

المعلمات
coverageTarget	String

ضبط تصحيح الأخطاء

public void setDebug (boolean debug)

ضبط إعداد تصحيح أخطاء الأدوات.

المعلمات
debug	boolean: قيمة منطقية لضبط إعداد تصحيح أخطاء الأدوات على

ضبط الجهاز

public void setDevice (ITestDevice device)

أدخِل الجهاز تحت الاختبار.

المعلمات
device	ITestDevice: السمة ITestDevice المطلوب استخدامها

تعيين فرض التنسيق

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) القابل للتثبيت

وحدة تخزين معزولة

public void setIsolatedStorage (boolean isolatedStorage)

يمكنك ضبط الإعدادات على استخدام وحدة التخزين المعزولة أو عدم استخدامها.

المعلمات
isolatedStorage	boolean

setMethodName

public void setMethodName (String testMethodName)

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

المعلمات
testMethodName	String

مجموعة مقاييسي

public void setMetricCollectors ( collectors)

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

المعلمات
collectors

مجموعة الأوركسترا

public void setOrchestrator (boolean useOrchestrator)

تعيين خيار --orchestrator

المعلمات
useOrchestrator	boolean

اسم الحزمة set

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

اسم المجموعة

public void setRunName (String runName)

ضبط اسم إجراء الاختبار المخصّص الذي سيتم تقديمه للمستمِع

المعلمات
runName	String

اسم المجموعة

public void setRunnerName (String runnerName)

يمكنك اختياريًا ضبط عدّاد أدوات Android لاستخدامه.

المعلمات
runnerName	String

المهلة المحددة

public void setShellTimeout (long timeout)

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

المعلمات
timeout	long

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

اختياريًا، يمكنك ضبط المسار إلى ملف موجود على الجهاز الذي يجب أن يحتوي على قائمة من الأسطر فئات الاختبار وطرقه المنفصلة (التنسيق: com.foo.Class#method) المطلوب تشغيلها. في حال تعيينها، محاولة إعادة إجراء الاختبارات تلقائيًا باستخدام ملف الاختبار هذا عبر أداة instrumentationFileTest بدلاً من تنفيذ أوامر منفصلة باستخدام adb لكل اختبار متبقي عبر إعادة تشغيله.

المعلمات
testFilePathOnDevice	String

اسم المجموعة التجريبية

public void setTestPackageName (String testPackageName)

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

إذا لم تكن قيمة خالية، فسيتم تنفيذ الاختبارات فقط داخل حزمة جافا المحددة.

سيتم تجاهله إذا تم تقديم قيمة غير فارغة إلى setClassName(String).

المعلمات
testPackageName	String

تعيين حجم الاختبار

public void setTestSize (String size)

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

المعلمات
size	String

ضبط المهلة

public void setTestTimeout (long timeout)

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

المعلمات
timeout	long

ضبط عمليات الاختبار

public void setTestsToRun ( tests)

حدِّد مجموعة الاختبارات التي يجب تنفيذها بواسطة اختبار قياس حالة التطبيق.

المعلمات
tests	: الاختبارات المطلوب إجراؤها

صورة متحركة لـ setWindow

public void setWindowAnimation (boolean windowAnimation)

المعلمات
windowAnimation	boolean

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

استثناء غير تنفيذي

protected static  excludeNonExecuted (TestRunResult results)

تصفية "NOT_EXECUTED" وتخطيها بهدف تتبُّع ما يجب إعادة تشغيله.

المعلمات
results	TestRunResult

المرتجعات

الحصول على كل فئة

protected String getClassName ()

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

المرتجعات
String

المحلِّل الخاص بـ getListinstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

الحصول على ListInstrumentationParser المستخدم في تحليل "أداة قائمة مساءً" طلبات البحث.

المرتجعات
ListInstrumentationParser

الطريقة getMethodName

protected String getMethodName ()

احصل على طريقة الاختبار للتشغيل.

المرتجعات
String

الحصول على اسم الحزمة

protected String getTestPackageName ()

احصل على حزمة test java لتشغيلها.

المرتجعات
String

اسم الاستعلام RunnerName

protected String queryRunnerName ()

يمكن إرسال طلب بحث إلى الجهاز عن مشغِّل اختبار لاستخدامه.

المرتجعات
String	اسم عدّاء الاختبار الأول الذي يطابق الحزمة أو فارغ إذا لم نعثر على أي منها.

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

مجموعة RunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

المعلمات
runner	IRemoteAndroidTestRunner