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.

ملخّص

الثوابت

String EXCLUDE_COLLECTOR_FILTER_KEY

String INCLUDE_COLLECTOR_FILTER_KEY

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

String NEW_RUN_LISTENER_ORDER_KEY

وسيطة مشغّل اختبار لقياس حالة التطبيق المستخدمة لتفعيل ترتيب RunListener الجديد على الجهاز

String USE_TEST_STORAGE_SERVICE

طُرق وضع التصميم العامة

AndroidJUnitTest()

الإجراءات العامة

void addAllExcludeAnnotation(Set<String> excludeAnnotations)

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

void addAllExcludeFilters(Set<String> filters)

تضيف هذه السمة Set الفلاتر التي يجب استبعاد الاختبارات التي تتضمّنها.

void addAllIncludeAnnotation(Set<String> annotations)

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

void addAllIncludeFilters(Set<String> filters)

تضيف هذه السمة 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()

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

Set<String> getExcludeAnnotations()

تعرض هذه السمة Set التعليقات التوضيحية المطلوب استبعادها.

Set<String> getExcludeFilters()

تعرِض هذه السمة عدد فلاتر الاستبعاد الحالية.Set

File getExcludeTestFile()

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

Set<String> getIncludeAnnotations()

تعرض هذه السمة Set التعليقات التوضيحية الحالية التي سيتم تضمينها.

Set<String> getIncludeFilters()

تعرِض هذه السمة 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)

تضبط هذه السمة ملف الاختبار الخاص بعمليات التضمين.

Collection<IRemoteTest> split(int shardCount)

نسخة بديلة من split() توفّر أيضًا shardCount الذي تتم محاولة تنفيذه.

طُرق محمية

void setRunnerArgs(IRemoteAndroidTestRunner runner)

الثوابت

EXCLUDE_COLLECTOR_FILTER_KEY

public static final String EXCLUDE_COLLECTOR_FILTER_KEY

القيمة الثابتة: "exclude-filter-group"

INCLUDE_COLLECTOR_FILTER_KEY

public static final String INCLUDE_COLLECTOR_FILTER_KEY

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

القيمة الثابتة: "include-filter-group"

NEW_RUN_LISTENER_ORDER_KEY

public static final String NEW_RUN_LISTENER_ORDER_KEY

وسيطة مشغّل اختبار لقياس حالة التطبيق المستخدمة لتفعيل ترتيب RunListener الجديد على الجهاز

القيمة الثابتة: "newRunListenerMode"

USE_TEST_STORAGE_SERVICE

public static final String USE_TEST_STORAGE_SERVICE

القيمة الثابتة: "useTestStorageService"

طُرق وضع التصميم العامة

AndroidJUnitTest

public AndroidJUnitTest ()

الإجراءات العامة

addAllExcludeAnnotation

public void addAllExcludeAnnotation (Set<String> excludeAnnotations)

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

المعلَمات
excludeAnnotations Set

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

تضيف هذه السمة Set الفلاتر التي يجب استبعاد الاختبارات التي تتضمّنها.

المعلَمات
filters Set

addAllIncludeAnnotation

public void addAllIncludeAnnotation (Set<String> annotations)

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

المعلَمات
annotations Set

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

تضيف هذه السمة Set فلاتر الاختبارات التي سيتم تضمينها.

المعلَمات
filters Set

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 Set<String> getExcludeAnnotations ()

تعرض هذه السمة Set التعليقات التوضيحية المطلوب استبعادها.

المرتجعات
Set<String>

getExcludeFilters

public Set<String> getExcludeFilters ()

تعرِض هذه السمة عدد فلاتر الاستبعاد الحالية.Set

المرتجعات
Set<String>

getExcludeTestFile

public File getExcludeTestFile ()

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

المرتجعات
File

getIncludeAnnotations

public Set<String> getIncludeAnnotations ()

تعرض هذه السمة Set التعليقات التوضيحية الحالية التي سيتم تضمينها.

المرتجعات
Set<String>

getIncludeFilters

public Set<String> getIncludeFilters ()

تعرِض هذه السمة Set فلاتر التضمين الحالية.

المرتجعات
Set<String>

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 Collection<IRemoteTest> split (int shardCount)

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

المعلَمات
shardCount int: عدد الأجزاء التي تمت محاولة إنشائها.

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

طُرق محمية

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

المعلَمات
runner IRemoteAndroidTestRunner