AndroidJUnitTest

public class AndroidJUnitTest
extends InstrumentationTest implements IRuntimeHintProvider, IShardableTest, ITestAnnotationFilterReceiver, ITestFileFilterReceiver, ITestFilterReceiver

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

---

اختبار يُشغِّل حِزمة اختبار أداة قياس الأداء على جهاز معيّن باستخدام العنصر android.support.test.runner.AndroidJUnitRunner

ملخّص

الحقول
public static final String	EXCLUDE_COLLECTOR_FILTER_KEY
public static final String	INCLUDE_COLLECTOR_FILTER_KEY خيارات من مكتبة المساعدة من جهة المجمع
public static final String	NEW_RUN_LISTENER_ORDER_KEY وسيطة أداة تشغيل اختبارات الأدوات المستخدَمة لتفعيل طلب RunListener الجديد على جانب الجهاز
public static final String	USE_TEST_STORAGE_SERVICE

وظائف الإنشاء العامة
AndroidJUnitTest()

الطرق العامة
void	addAllExcludeAnnotation( excludeAnnotations) تُضيف ERROR(/Set) من التعليقات التوضيحية لاستبعادها إذا تم وضع علامة عليها في الاختبارات.
void	addAllExcludeFilters( filters) تُضيف ERROR(/Set) الفلاتر التي يجب استبعاد الاختبارات منها.
void	addAllIncludeAnnotation( annotations) تضيف ERROR(/Set) من التعليقات التوضيحية لتضمينها إذا تم وضع علامة عليها في الاختبارات.
void	addAllIncludeFilters( filters) تُضيف ERROR(/Set) الفلاتر التي يجب تضمين الاختبارات فيها.
void	addExcludeAnnotation(String excludeAnnotation) تُضيف تعليقًا توضيحيًا لاستبعاده إذا تم وضع علامة عليه في الاختبارات.
void	addExcludeFilter(String filter) تُضيف فلترًا للاختبارات المطلوب استبعادها.
void	addIncludeAnnotation(String annotation) تُضيف تعليقًا توضيحيًا لتضمينه إذا تم وضع علامة عليه في الاختبارات.
void	addIncludeFilter(String filter) تُضيف فلترًا للاختبارات التي تريد تضمينها.
void	clearExcludeAnnotations() حذف جميع التعليقات التوضيحية المُستبعدة التي يتم تتبُّعها حاليًا
void	clearExcludeFilters() حذف جميع فلاتر الاستبعاد التي يتم تتبُّعها حاليًا
void	clearIncludeAnnotations() حذف جميع التعليقات التوضيحية المضمّنة التي يتم تتبُّعها حاليًا
void	clearIncludeFilters() حذف جميع فلاتر التضمين التي يتم تتبُّعها حاليًا
	getExcludeAnnotations() لعرض ERROR(/Set) الحالي للتعليقات التوضيحية المطلوب استبعادها.
	getExcludeFilters() عرض ERROR(/Set) الحالي لفلاتر الاستبعاد
File	getExcludeTestFile() عرض الملف الذي يحتوي على الاختبارات المستبعَدة
	getIncludeAnnotations() لعرض ERROR(/Set) الحالي للتعليقات التوضيحية المطلوب تضمينها.
	getIncludeFilters() عرض ERROR(/Set) الحالي لفلاتر التضمين
File	getIncludeTestFile() عرض الملف الذي يحتوي على الاختبارات المضمّنة
long	getRuntimeHint() عرض وقت التشغيل المتوقّع للاختبار بالملي ثانية
boolean	isClassOrMethod(String filter) عرض ما إذا كانت السلسلة هي اسم فئة أو طريقة
boolean	isParameterizedTest(String filter) عرض ما إذا كانت السلسلة اختبارًا مُحدَّدًا بالمَعلمات
boolean	isRegex(String filter) عرض ما إذا كانت السلسلة عبارة عن تعبير عادي للفلتر
void	run(TestInformation testInfo, ITestInvocationListener listener) يُجري الاختبارات ويُبلغ المستمع بالنتيجة.
void	setExcludeTestFile(File testFile) لضبط ملف الاختبار الخاص بالمستبعدات
void	setIncludeTestFile(File testFile) لضبط ملف الاختبار الذي يتضمّن.
	split(int shardCount) نسخة بديلة من split() تقدّم أيضًا عدد الأجزاء التي تتم محاولة تشغيلها.

الطرق المحمية
void	setRunnerArgs(IRemoteAndroidTestRunner runner)

الحقول

EXCLUDE_COLLECTOR_FILTER_KEY

public static final String EXCLUDE_COLLECTOR_FILTER_KEY

INCLUDE_COLLECTOR_FILTER_KEY

public static final String INCLUDE_COLLECTOR_FILTER_KEY

خيارات من مكتبة المساعدة من جهة المجمع

NEW_RUN_LISTENER_ORDER_KEY

public static final String NEW_RUN_LISTENER_ORDER_KEY

وسيطة أداة تشغيل اختبارات الأدوات المستخدَمة لتفعيل طلب RunListener الجديد على جانب الجهاز

USE_TEST_STORAGE_SERVICE

public static final String USE_TEST_STORAGE_SERVICE

وظائف الإنشاء العامة

AndroidJUnitTest

public AndroidJUnitTest ()

الطرق العامة

addAllExcludeAnnotation

public void addAllExcludeAnnotation ( excludeAnnotations)

تُضيف ERROR(/Set) من التعليقات التوضيحية لاستبعادها إذا تم وضع علامة عليها في الاختبارات.

المعلمات
excludeAnnotations

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

تُضيف ERROR(/Set) الفلاتر التي يجب استبعاد الاختبارات منها.

المعلمات
filters

addAllIncludeAnnotation

public void addAllIncludeAnnotation ( annotations)

تضيف ERROR(/Set) من التعليقات التوضيحية لتضمينها إذا تم وضع علامة عليها في الاختبارات.

المعلمات
annotations

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

تُضيف ERROR(/Set) الفلاتر التي يجب تضمين الاختبارات فيها.

المعلمات
filters

addExcludeAnnotation

public void addExcludeAnnotation (String excludeAnnotation)

تُضيف تعليقًا توضيحيًا لاستبعاده إذا تم وضع علامة عليه في الاختبارات.

المعلمات
excludeAnnotation	String

addExcludeFilter

public void addExcludeFilter (String filter)

تُضيف فلترًا للاختبارات المطلوب استبعادها.

المعلمات
filter	String

addIncludeAnnotation

public void addIncludeAnnotation (String annotation)

تُضيف تعليقًا توضيحيًا لتضمينه إذا تم وضع علامة عليه في الاختبارات.

المعلمات
annotation	String

addIncludeFilter

public void addIncludeFilter (String filter)

تُضيف فلترًا للاختبارات التي تريد تضمينها.

المعلمات
filter	String

clearExcludeAnnotations

public void clearExcludeAnnotations ()

حذف جميع التعليقات التوضيحية المُستبعدة التي يتم تتبُّعها حاليًا

clearExcludeFilters

public void clearExcludeFilters ()

حذف جميع فلاتر الاستبعاد التي يتم تتبُّعها حاليًا

clearIncludeAnnotations

public void clearIncludeAnnotations ()

حذف جميع التعليقات التوضيحية المضمّنة التي يتم تتبُّعها حاليًا

clearIncludeFilters

public void clearIncludeFilters ()

حذف جميع فلاتر التضمين التي يتم تتبُّعها حاليًا

getExcludeAnnotations

public  getExcludeAnnotations ()

لعرض ERROR(/Set) الحالي للتعليقات التوضيحية المطلوب استبعادها.

المرتجعات

getExcludeFilters

public  getExcludeFilters ()

عرض ERROR(/Set) الحالي لفلاتر الاستبعاد

المرتجعات

getExcludeTestFile

public File getExcludeTestFile ()

عرض الملف الذي يحتوي على الاختبارات المستبعَدة

المرتجعات
File

getIncludeAnnotations

public  getIncludeAnnotations ()

لعرض ERROR(/Set) الحالي للتعليقات التوضيحية المطلوب تضمينها.

المرتجعات

getIncludeFilters

public  getIncludeFilters ()

عرض ERROR(/Set) الحالي لفلاتر التضمين

المرتجعات

getIncludeTestFile

public File getIncludeTestFile ()

عرض الملف الذي يحتوي على الاختبارات المضمّنة

المرتجعات
File

getRuntimeHint

public long getRuntimeHint ()

عرض وقت التشغيل المتوقّع للاختبار بالملي ثانية يتم استخدام الوقت لموازنة التنفيذ المجزّأ.

المرتجعات
long

isClassOrMethod

public boolean isClassOrMethod (String filter)

عرض ما إذا كانت السلسلة هي اسم فئة أو طريقة

المعلمات
filter	String

المرتجعات
boolean

isParameterizedTest

public boolean isParameterizedTest (String filter)

عرض ما إذا كانت السلسلة اختبارًا مُحدَّدًا بالمَعلمات

المعلمات
filter	String

المرتجعات
boolean

isRegex

public boolean isRegex (String filter)

عرض ما إذا كانت السلسلة عبارة عن تعبير عادي للفلتر

المعلمات
filter	String

المرتجعات
boolean

ضربة طويلة

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

يُجري الاختبارات ويُبلغ المستمع بالنتيجة.

المعلمات
testInfo	TestInformation: عنصر TestInformation الذي يحتوي على معلومات مفيدة لإجراء الاختبارات
listener	ITestInvocationListener: ITestInvocationListener من نتائج الفحص

عمليات الرمي
DeviceNotAvailableException

setExcludeTestFile

public void setExcludeTestFile (File testFile)

لضبط ملف الاختبار الخاص بالمستبعدات لا تضمن هذه الطريقة توفّر ملف testFile أو أنّه ملف.

المعلمات
testFile	File

setIncludeTestFile

public void setIncludeTestFile (File testFile)

لضبط ملف الاختبار الذي يتضمّن. لا تضمن هذه الطريقة توفّر ملف testFile أو أنّه ملف.

المعلمات
testFile	File

تقسيم

public  split (int shardCount)

نسخة بديلة من split() تقدّم أيضًا عدد الأجزاء التي تتم محاولة تشغيلها. ويُعدّ ذلك مفيدًا لبعض مشغّلات الاختبارات التي لا يمكنها اتخاذ قرار عشوائي في بعض الأحيان.

المعلمات
shardCount	‫int: عدد الشرائح التي تمّت محاولة إنشائها

المرتجعات
	مجموعة من الاختبارات الفرعية التي سيتم تنفيذها بشكل منفصل أو null إذا كان الاختبار غير قابل للتقسيم حاليًا

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

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

المعلمات
runner	IRemoteAndroidTestRunner