اختبار HostTest

public class HostTest
extends Object implements IAbiReceiver, IBuildReceiver, IConfigurationReceiver, IDeviceTest, IRemoteTest, IRuntimeHintProvider, IShardableTest, ITestAnnotationFilterReceiver, ITestCollector, ITestFilterReceiver

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

أداة تشغيل اختبار الاختبارات المستندة إلى مضيف JUnit. إذا كان الاختبار الذي سيتم تنفيذه ينفِّذ IDeviceTest ، سيُرسِل هذا المشغِّل مرجعًا إلى الجهاز.

ملخّص

الحقول

public static final String SET_OPTION_DESC

public static final String SET_OPTION_NAME

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

HostTest()

الطرق العامة

void addAllExcludeAnnotation( notAnnotations)

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

void addAllExcludeFilters( filters)

تتم إضافة ERROR(/Set) لفلاتر الاختبارات المطلوب استبعادها.

void addAllIncludeAnnotation( annotations)

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

void addAllIncludeFilters( filters)

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

void addExcludeAnnotation(String notAnnotation)

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

void addExcludeFilter(String filter)

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

void addIncludeAnnotation(String annotation)

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

void addIncludeFilter(String filter)

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

void clearExcludeAnnotations()

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

void clearExcludeFilters()

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

void clearIncludeAnnotations()

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

void clearIncludeFilters()

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

int countTestCases()

عرض عدد حالات الاختبار في جميع الفئات التي تشكّل جزءًا من الاختبارات

IAbi getAbi()

getClassNames()
ITestDevice getDevice()

افحص الجهاز.

getExcludeAnnotations()

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

getExcludeFilters()

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

getIncludeAnnotations()

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

getIncludeFilters()

لعرض ERROR(/Set) الحالي لفلترة البيانات.

long getRuntimeHint()

عرض وقت التشغيل المتوقّع للاختبار بالملي ثانية

void run(TestInformation testInfo, ITestInvocationListener listener)

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

void setAbi(IAbi abi)

void setBuild(IBuildInfo buildInfo)

void setCollectTestsOnly(boolean shouldCollectTest)

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

void setConfiguration(IConfiguration configuration)

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

void setDevice(ITestDevice device)

ضخ الجهاز الذي يتم اختباره

static void setOptionToLoadedObject(Object testObj, keyValueOptions)

يمكن استخدام هذه الأداة لمساعدة برامج تشغيل الأجهزة في ضبط الخيارات بالطريقة نفسها المتّبعة مع HostTest، وذلك من خلال الخيار set.

void setTestInformation(TestInformation testInfo)
split(Integer shardCount, TestInformation testInfo)

نقسم البيانات حسب الفرد إما حسب فئة الاختبار أو الطريقة.

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

HostTest createHostTest(Class<?> classObj)

مساعد لإنشاء مثيل HostTest عند التجزئة

IBuildInfo getBuild()

يمكنك الحصول على معلومات الإصدار التي تم تلقّيها من خلال HostTest.

ClassLoader getClassLoader()

عرض أداة تحميل الفئات التلقائية

final getClasses()
File getJarFile(String jarName, TestInformation testInfo)

تحقّق من عدة مواقع جغرافية يُحتمَل أن يكون فيها العنصر في حالات استخدام مختلفة لمحاولة العثور على الحزمة.

boolean hasJUnit4Annotation(Class<?> classObj)

مساعد لتحديد ما إذا كنا نتعامل مع فئة اختبار تتضمّن تعليقات توضيحية في Junit4

Object loadObject(Class<?> classObj)

تحميل عنصر الفئة وضبط معلومات الاختبار (الجهاز والإصدار)

void setClassName(String className)

امسح اسم الصف ثم اضبطه ليتم تشغيله.

boolean shouldTestRun(AnnotatedElement annotatedElement)

التحقّق مما إذا كان العنصر الذي يحتوي على تعليق توضيحي يجتاز الفلتر

الحقول

SET_OPTION_DESC

public static final String SET_OPTION_DESC

SET_OPTION_NAME

public static final String SET_OPTION_NAME

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

HostTest

public HostTest ()

الطرق العامة

addAllExcludeAnnotation

public void addAllExcludeAnnotation ( notAnnotations)

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

المعلمات
notAnnotations

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 notAnnotation)

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

المعلمات
notAnnotation String

addExcludeFilter

public void addExcludeFilter (String filter)

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

المعلمات
filter String

إضافة تضمينتعليق توضيحي

public void addIncludeAnnotation (String annotation)

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

المعلمات
annotation String

addIncludeFilter

public void addIncludeFilter (String filter)

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

المعلمات
filter String

clearExcludeAnnotations

public void clearExcludeAnnotations ()

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

محو الفلاتر

public void clearExcludeFilters ()

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

clearIncludeAnnotations

public void clearIncludeAnnotations ()

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

clearIncludeFilters

public void clearIncludeFilters ()

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

countTestCases

public int countTestCases ()

عرض عدد حالات الاختبار في جميع الفئات التي تشكّل جزءًا من الاختبارات

المرتجعات
int

getAbi

public IAbi getAbi ()

المرتجعات
IAbi

getClassNames

public  getClassNames ()

المرتجعات

getDevice

public ITestDevice getDevice ()

احصل على الجهاز الذي يتم اختباره.

المرتجعات
ITestDevice ITestDevice

getExcludeAnnotations

public  getExcludeAnnotations ()

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

المرتجعات

getExcludeFilters

public  getExcludeFilters ()

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

المرتجعات

getIncludeAnnotations

public  getIncludeAnnotations ()

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

المرتجعات

getIncludeFilters

public  getIncludeFilters ()

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

المرتجعات

الحصول على تلميح وقت التشغيل

public long getRuntimeHint ()

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

المرتجعات
long

ضربة طويلة

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

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

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

setAbi

public void setAbi (IAbi abi)

المعلمات
abi IAbi

إنشاء مجموعة

public void setBuild (IBuildInfo buildInfo)

المعلمات
buildInfo IBuildInfo

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

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

setConfiguration

public void setConfiguration (IConfiguration configuration)

تحقِّق من استخدام IConfiguration.

المعلمات
configuration IConfiguration

setDevice

public void setDevice (ITestDevice device)

ضخ الجهاز الذي يتم اختباره

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

setOptionToLoadedObject

public static void setOptionToLoadedObject (Object testObj, 
                 keyValueOptions)

مساعد لمستخدمي Device Runners لضبط الخيارات بالطريقة نفسها المستخدَمة في HostTest، من set-option

المعلمات
testObj Object: العنصر الذي سيتلقى الخيارات
keyValueOptions : قائمة الخيارات بالتنسيق الذي يتطلبه HostTest set-option

setTestInfo

public void setTestInformation (TestInformation testInfo)

المعلمات
testInfo TestInformation

تقسيم

public  split (Integer shardCount, 
                TestInformation testInfo)

ونقسم العدد حسب الفئة الفردية إما حسب فئة الاختبار أو الطريقة.

المعلمات
shardCount ‫Integer: عدد الشرائح التي تمّت محاولة إنشائها
testInfo TestInformation: حساب أحد الوالدَين TestInformation
المرتجعات
مجموعة من الاختبارات الفرعية التي سيتم تنفيذها بشكل منفصل أو null إذا لم يكن الاختبار قابلاً للتقسيم في الوقت الحالي

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

createHostTest

protected HostTest createHostTest (Class<?> classObj)

المساعدة في إنشاء مثيل HostTest عند التقسيم على أجزاء يمكنك إلغاء الإعدادات لعرض أي عنصر فرعي من HostTest.

المعلمات
classObj Class

المرتجعات
HostTest

إنشاء

protected IBuildInfo getBuild ()

الحصول على معلومات الإصدار التي تلقّاها HostTest

المرتجعات
IBuildInfo IBuildInfo

getClassLoader

protected ClassLoader getClassLoader ()

عرض أداة تحميل الفئات التلقائية

المرتجعات
ClassLoader

getClasses

protected final  getClasses ()

المرتجعات

getJarFile

protected File getJarFile (String jarName, 
                TestInformation testInfo)

تحقّق من عدة مواقع جغرافية يُحتمَل أن يكون العنصر فيها في حالات استخدام مختلفة لمحاولة العثور على الحزمة.

المعلمات
jarName String

testInfo TestInformation

المرتجعات
File

hasJUnit4Annotation

protected boolean hasJUnit4Annotation (Class<?> classObj)

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

المعلمات
classObj Class

المرتجعات
boolean

loadObject

protected Object loadObject (Class<?> classObj)

تحميل عنصر الفئة وضبط معلومات الاختبار (الجهاز والإصدار)

المعلمات
classObj Class

المرتجعات
Object

اسم الصف

protected void setClassName (String className)

امسح اسم الصف ثم اضبطه ليتم تشغيله.

المعلمات
className String

shouldTestRun

protected boolean shouldTestRun (AnnotatedElement annotatedElement)

التحقّق مما إذا كان العنصر الذي يحتوي على تعليق توضيحي يجتاز الفلتر تمّ عرضها لاختبار الوحدة.

المرتجعات
boolean false إذا كان لا يجب تنفيذ الاختبار.