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( 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() توفّر أيضًا 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 ( 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 الذي تتم محاولة تنفيذه. ويكون ذلك مفيدًا لبعض أدوات تشغيل الاختبار التي لا يمكنها اتخاذ قرار بشكل عشوائي في بعض الأحيان.

المعلمات
shardCount int: عدد الأجزاء التي تمت محاولة إنشائها
المرتجعات
مجموعة من الاختبارات الفرعية التي سيتم تنفيذها بشكل منفصل أو null إذا كان الاختبار غير قابل للتجزئة حاليًا

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

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

المعلمات
runner IRemoteAndroidTestRunner