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

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

---

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

ملخّص

الثوابت
String	SET_OPTION_DESC
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) افحص عدة مواقع جغرافية يتواجد فيها عادةً العنصر المستخدَم في حالات الاستخدام المختلفة للعثور على ملف jar.
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

القيمة الثابتة: "خيارات سيتم تمريرها إلى الفئة قيد الاختبار، ويجب الفصل بين المفتاح والقيمة بنقطتين رأسيتين ":"؛ على سبيل المثال، إذا كانت الفئة قيد الاختبار تتوافق مع "--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 ( 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)

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

المعلمات
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 إذا كان من المفترض عدم تنفيذ الاختبار.