HostTest

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

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

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

ملخّص

الثوابت

String SET_OPTION_DESC

String SET_OPTION_NAME

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

HostTest()

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

void addAllExcludeAnnotation(Set<String> notAnnotations)

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

void addAllExcludeFilters(Set<String> filters)

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

void addAllIncludeAnnotation(Set<String> annotations)

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

void addAllIncludeFilters(Set<String> filters)

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

Set<String> getClassNames()
ITestDevice getDevice()

احصل على الجهاز الخاضع للاختبار.

Set<String> getExcludeAnnotations()

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

Set<String> getExcludeFilters()

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

Set<String> getIncludeAnnotations()

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

Set<String> getIncludeFilters()

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

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

void setTestInformation(TestInformation testInfo)
Collection<IRemoteTest> split(Integer shardCount, TestInformation testInfo)

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

طُرق محمية

HostTest createHostTest(Class<?> classObj)

فئة مساعدة لإنشاء مثيل HostTest عند التقسيم.

IBuildInfo getBuild()

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

ClassLoader getClassLoader()

تعرض هذه الطريقة أداة تحميل الفئات التلقائية.

final List<Class<?>> getClasses()
File getJarFile(String jarName, TestInformation testInfo)

افحص عدة مواقع جغرافية يتواجد فيها عادةً العنصر المستخرَج لحالات استخدام مختلفة للعثور على ملف JAR.

boolean hasJUnit4Annotation(Class<?> classObj)

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

Object loadObject(Class<?> classObj)

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

void setClassName(String className)

محو اسم الفئة المطلوب تشغيلها ثم ضبطه

void setMethodName(String methodName)

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

boolean shouldTestRun(AnnotatedElement annotatedElement)

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

الثوابت

SET_OPTION_DESC

public static final String SET_OPTION_DESC

القيمة الثابتة: "خيارات سيتم تمريرها إلى الفئة قيد الاختبار، يجب فصل المفتاح والقيمة بنقطتين رأسيتين ":"؛ على سبيل المثال، إذا كانت الفئة قيد الاختبار تتوافق مع "--iteration 1" من سطر الأوامر، يجب تمريرها على النحو التالي: "--set-option iteration:1" أو "--set-option iteration:key=value" لتمرير الخيارات إلى الخريطة. يمكن إلغاء القيم التي تحتوي على ":" أو "=" باستخدام شرطة مائلة عكسية. يمكن استهداف فئة معيّنة من خلال تحديدها. " --set-option :

SET_OPTION_NAME

public static final String SET_OPTION_NAME

Constant Value: "set-option"

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

HostTest

public HostTest ()

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

addAllExcludeAnnotation

public void addAllExcludeAnnotation (Set<String> notAnnotations)

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

المعلَمات
notAnnotations 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 notAnnotation)

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

المعلَمات
notAnnotation 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 ()

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

countTestCases

public int countTestCases ()

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

المرتجعات
int

getAbi

public IAbi getAbi ()

المرتجعات
IAbi

getClassNames

public Set<String> getClassNames ()

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

getDevice

public ITestDevice getDevice ()

احصل على الجهاز الخاضع للاختبار.

المرتجعات
ITestDevice ITestDevice

getExcludeAnnotations

public Set<String> getExcludeAnnotations ()

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

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

getExcludeFilters

public Set<String> getExcludeFilters ()

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

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

getIncludeAnnotations

public Set<String> getIncludeAnnotations ()

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

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

getIncludeFilters

public Set<String> getIncludeFilters ()

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

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

getRuntimeHint

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

setBuild

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, 
                List<String> keyValueOptions)

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

المعلَمات
testObj Object: الكائن الذي سيتلقّى الخيارات.
keyValueOptions List: قائمة الخيارات المنسّقة على النحو المطلوب في HostTest set-option.

setTestInformation

public void setTestInformation (TestInformation testInfo)

المعلَمات
testInfo TestInformation

تقسيم

public Collection<IRemoteTest> split (Integer shardCount, 
                TestInformation testInfo)

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

المعلَمات
shardCount Integer: عدد الأجزاء التي تمت محاولة إنشائها.
testInfo TestInformation: الفئة الرئيسية TestInformation
المرتجعات
Collection<IRemoteTest> مجموعة من الاختبارات الفرعية التي سيتم تنفيذها بشكل منفصل أو null إذا كان الاختبار غير قابل للتجزئة حاليًا

طُرق محمية

createHostTest

protected HostTest createHostTest (Class<?> classObj)

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

المعلَمات
classObj Class

المرتجعات
HostTest

getBuild

protected IBuildInfo getBuild ()

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

المرتجعات
IBuildInfo IBuildInfo

getClassLoader

protected ClassLoader getClassLoader ()

تعرض هذه الطريقة أداة تحميل الفئات التلقائية.

المرتجعات
ClassLoader

getClasses

protected final List<Class<?>> getClasses ()

المرتجعات
List<Class<?>>

عمليات الطرح
IllegalArgumentException

getJarFile

protected File getJarFile (String jarName, 
                TestInformation testInfo)

افحص عدة مواقع جغرافية يتواجد فيها عادةً العنصر المستخرَج لحالات استخدام مختلفة للعثور على ملف JAR.

المعلَمات
jarName String

testInfo TestInformation

القيم المُعادة
File

عمليات الطرح
FileNotFoundException

hasJUnit4Annotation

protected boolean hasJUnit4Annotation (Class<?> classObj)

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

المعلَمات
classObj Class

المرتجعات
boolean

loadObject

protected Object loadObject (Class<?> classObj)

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

المعلَمات
classObj Class

المرتجعات
Object

setClassName

protected void setClassName (String className)

محو اسم الفئة المطلوب تشغيلها ثم ضبطه

المعلَمات
className String

setMethodName

protected void setMethodName (String methodName)

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

يُستخدَم هذا الخيار لتشغيل طريقة اختبار معيّنة من فئة اختبار.

المعلَمات
methodName String

shouldTestRun

protected boolean shouldTestRun (AnnotatedElement annotatedElement)

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

المرتجعات
boolean يتم ضبط القيمة على "false" إذا كان من المفترض عدم تنفيذ الاختبار.