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

الفئات الفرعية المباشرة المعروفة JarHostTest JarHostTest أداة لتشغيل اختبارات JUnit من جهة المضيف

---

أداة لتشغيل الاختبارات المستندة إلى مضيف 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) مساعد لمستخدمي Device Runners لضبط الخيارات بالطريقة نفسها التي يستخدمها HostTest، من set-option.
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

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  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) الحالي لفلاتر التضمين

المرتجعات

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

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

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

setTestInformation

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

getBuild

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

setClassName

protected void setClassName (String className)

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

المعلمات
className	String

shouldTestRun

protected boolean shouldTestRun (AnnotatedElement annotatedElement)

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

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