میزبان تست

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

شیء جاوا
↳ com.android.tradefed.testtype.HostTest

یک اجراکننده‌ی تست برای تست‌های مبتنی بر میزبان 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 ()

تمام حاشیه‌نویسی‌های include که در حال حاضر ردیابی می‌شوند را حذف کنید.

void clearIncludeFilters ()

تمام فیلترهای موجود که در حال حاضر ردیابی می‌شوند را حذف کنید.

int countTestCases ()

تعداد موارد آزمون را در تمام کلاس‌های بخشی از آزمون‌ها برمی‌گرداند.

IAbi getAbi ()

getClassNames ()
ITestDevice getDevice ()

دستگاه را تحت آزمایش قرار دهید.

getExcludeAnnotations ()

مقدار ERROR(/Set) فعلی حاشیه‌نویسی‌هایی که باید حذف شوند را برمی‌گرداند.

getExcludeFilters ()

مقدار ERROR(/Set) فعلی فیلترهای مستثنی شده را برمی‌گرداند.

getIncludeAnnotations ()

مقدار ERROR(/Set) فعلی حاشیه‌نویسی‌هایی که باید لحاظ شوند را برمی‌گرداند.

getIncludeFilters ()

مقدار ERROR(/Set) فعلی فیلترهای include شده را برمی‌گرداند.

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-option، استفاده می‌شود.

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

ما بر اساس کلاس یا متد تست، به صورت جداگانه تقسیم‌بندی می‌کنیم.

روش‌های محافظت‌شده

HostTest createHostTest (Class<?> classObj)

کمکی برای ایجاد یک نمونه HostTest هنگام شاردینگ.

IBuildInfo getBuild ()

اطلاعات ساخت دریافت شده توسط HostTest را دریافت کنید.

ClassLoader getClassLoader ()

classloader پیش‌فرض را برمی‌گرداند.

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

برای یافتن شیشه مورد نظر، چندین مکان را که معمولاً مصنوعات در آنها قرار دارند، برای موارد استفاده مختلف بررسی کنید.

boolean hasJUnit4Annotation (Class<?> classObj)

کمکی برای تعیین اینکه آیا با یک کلاس Test با حاشیه‌نویسی‌های Junit4 سر و کار داریم یا خیر.

Object loadObject (Class<?> classObj)

شیء کلاس را بارگذاری کنید و اطلاعات تست (دستگاه، ساخت) را تنظیم کنید.

void setClassName (String className)

پاک کن و سپس نام کلاسی که قرار است اجرا شود را تعیین کن.

boolean shouldTestRun (AnnotatedElement annotatedElement)

بررسی کنید که آیا عناصری که حاشیه‌نویسی دارند از فیلتر عبور می‌کنند یا خیر.

ثابت‌ها

تنظیم_گزینه_حذف 

public static final String SET_OPTION_DESC

مقدار ثابت: «گزینه‌هایی که قرار است به کلاس تحت آزمایش ارسال شوند، کلید و مقدار باید با علامت دو نقطه ":" از هم جدا شوند؛ برای مثال، اگر کلاس تحت آزمایش از "--iteration 1" از خط فرمان پشتیبانی می‌کند، باید برای ارسال گزینه‌ها به map، به صورت "--set-option iteration:1" یا "--set-option iteration:key=value" ارسال شود. مقادیری که شامل ":" یا "=" هستند را می‌توان با یک بک‌اسلش escape کرد. یک کلاس خاص را می‌توان با مشخص کردن آن هدف قرار داد.» --set-option :

نام_گزینه_تنظیم 

public static final String SET_OPTION_NAME

مقدار ثابت: "تنظیم-گزینه"

سازندگان عمومی

میزبان تست 

public HostTest ()

روش‌های عمومی

حاشیه‌نویسی addAllExclude 

public void addAllExcludeAnnotation ( notAnnotations)

یک ERROR(/Set) از حاشیه‌نویسی‌ها را اضافه می‌کند تا در صورت علامت‌گذاری تست‌ها با آن، آن‌ها را حذف کند.

پارامترها
notAnnotations

فیلترهای addAllExclude 

public void addAllExcludeFilters ( filters)

ERROR(/Set) فیلترهایی را که تست‌هایشان باید حذف شوند، اضافه می‌کند.

پارامترها
filters

حاشیه‌نویسی addAllInclude 

public void addAllIncludeAnnotation ( annotations)

اگر تستی با این علامت مشخص شده باشد، یک ERROR(/Set) از حاشیه‌نویسی‌ها را اضافه می‌کند تا شامل شود.

پارامترها
annotations

فیلترهای addAllInclude 

public void addAllIncludeFilters ( filters)

ERROR(/Set) فیلترهایی که تست‌هایشان باید لحاظ شوند را اضافه می‌کند.

پارامترها
filters

حاشیه‌نویسی addExclude 

public void addExcludeAnnotation (String notAnnotation)

یک حاشیه‌نویسی اضافه می‌کند تا در صورت علامت‌گذاری تست‌ها با آن، آن‌ها را حذف کند.

پارامترها
notAnnotation String

فیلتر addExclude 

public void addExcludeFilter (String filter)

فیلتری اضافه می‌کند که کدام تست‌ها باید حذف شوند.

پارامترها
filter String

حاشیه‌نویسی addInclude 

public void addIncludeAnnotation (String annotation)

اگر تستی با حاشیه‌نویسی علامت‌گذاری شده باشد، یک حاشیه‌نویسی اضافه می‌کند تا شامل آن شود.

پارامترها
annotation String

فیلتر addInclude 

public void addIncludeFilter (String filter)

فیلتری اضافه می‌کند که کدام تست‌ها باید لحاظ شوند.

پارامترها
filter String

حاشیه‌نویسی‌های clearExclude 

public void clearExcludeAnnotations ()

تمام حاشیه‌نویسی‌های مستثنی که در حال حاضر ردیابی می‌شوند را حذف کنید.

فیلترهای clearExclude 

public void clearExcludeFilters ()

تمام فیلترهای حذف‌شده‌ای که در حال حاضر ردیابی می‌شوند را حذف کنید.

حاشیه‌نویسی‌های clearInclude 

public void clearIncludeAnnotations ()

تمام حاشیه‌نویسی‌های include که در حال حاضر ردیابی می‌شوند را حذف کنید.

فیلترهای clearInclude 

public void clearIncludeFilters ()

تمام فیلترهای موجود که در حال حاضر ردیابی می‌شوند را حذف کنید.

تعداد موارد تست 

public int countTestCases ()

تعداد موارد آزمون را در تمام کلاس‌های بخشی از آزمون‌ها برمی‌گرداند.

بازگشت‌ها
int

دریافت ابی 

public IAbi getAbi ()

بازگشت‌ها
IAbi

دریافت نام کلاس‌ها 

public  getClassNames ()

بازگشت‌ها

دریافت دستگاه 

public ITestDevice getDevice ()

دستگاه را تحت آزمایش قرار دهید.

بازگشت‌ها
ITestDevice ITestDevice

حاشیه‌نویسی‌های getExclude 

public  getExcludeAnnotations ()

مقدار ERROR(/Set) فعلی حاشیه‌نویسی‌هایی که باید حذف شوند را برمی‌گرداند.

بازگشت‌ها

فیلترهای getExclude 

public  getExcludeFilters ()

مقدار ERROR(/Set) فعلی فیلترهای مستثنی شده را برمی‌گرداند.

بازگشت‌ها

حاشیه‌نویسی‌های getInclude 

public  getIncludeAnnotations ()

مقدار ERROR(/Set) فعلی حاشیه‌نویسی‌هایی که باید لحاظ شوند را برمی‌گرداند.

بازگشت‌ها

فیلترهای getInclude 

public  getIncludeFilters ()

مقدار ERROR(/Set) فعلی فیلترهای include شده را برمی‌گرداند.

بازگشت‌ها

getRuntimeHint 

public long getRuntimeHint ()

زمان اجرای مورد انتظار تست را بر حسب میلی‌ثانیه برمی‌گرداند. این زمان برای بارگذاری تعادل اجرای تکه‌تکه شده استفاده می‌شود.

بازگشت‌ها
long

دویدن 

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

تست‌ها را اجرا می‌کند و نتایج را به شنونده گزارش می‌دهد.

پارامترها
testInfo TestInformation : شیء TestInformation که حاوی اطلاعات مفیدی برای اجرای تست‌ها است.

listener ITestInvocationListener : ITestInvocationListener از نتایج تست

پرتاب‌ها
DeviceNotAvailableException

ست ابی 

public void setAbi (IAbi abi)

پارامترها
abi IAbi

مجموعه ساخت 

public void setBuild (IBuildInfo buildInfo)

پارامترها
buildInfo IBuildInfo

فقط تست‌های جمع‌آوری‌شده 

public void setCollectTestsOnly (boolean shouldCollectTest)

حالت جمع‌آوری تست را فعال یا غیرفعال می‌کند

پیکربندی set 

public void setConfiguration (IConfiguration configuration)

IConfiguration مورد استفاده را تزریق می‌کند.

پارامترها
configuration IConfiguration

دستگاه تنظیم‌شده 

public void setDevice (ITestDevice device)

دستگاه تحت آزمایش را تزریق کنید.

پارامترها
device ITestDevice : دستگاه ITestDevice مورد استفاده

شیء setOptionToLoadedObject 

public static void setOptionToLoadedObject (Object testObj, 
                 keyValueOptions)

کمکی برای اجراکنندگان دستگاه که برای تنظیم گزینه‌ها به همان روش HostTest، از set-option، استفاده می‌شود.

پارامترها
testObj Object : شیء‌ای که گزینه‌ها را دریافت خواهد کرد.

keyValueOptions : لیست گزینه‌های قالب‌بندی شده به صورت HostTest set-option requires.

اطلاعات آزمون تنظیم‌شده 

public void setTestInformation (TestInformation testInfo)

پارامترها
testInfo TestInformation

تقسیم شده 

public  split (Integer shardCount, 
                TestInformation testInfo)

ما بر اساس کلاس یا متد تست، به صورت جداگانه تقسیم‌بندی می‌کنیم.

پارامترها
shardCount Integer : تعداد دفعات تلاش برای ایجاد خرده ریز.

testInfo TestInformation : کلاس والد TestInformation

بازگشت‌ها
مجموعه‌ای از زیرآزمون‌ها که باید جداگانه اجرا شوند یا اگر آزمون در حال حاضر قابل تقسیم‌بندی نیست، null

روش‌های محافظت‌شده

ایجادHostTest 

protected HostTest createHostTest (Class<?> classObj)

کمکی برای ایجاد یک نمونه HostTest هنگام شاردینگ. برای بازگرداندن هر فرزندی از HostTest، آن را لغو کنید.

پارامترها
classObj Class

بازگشت‌ها
HostTest

دریافت کنید 

protected IBuildInfo getBuild ()

اطلاعات ساخت دریافت شده توسط HostTest را دریافت کنید.

بازگشت‌ها
IBuildInfo IBuildInfo

دریافت کلاس لودر 

protected ClassLoader getClassLoader ()

classloader پیش‌فرض را برمی‌گرداند.

بازگشت‌ها
ClassLoader

کلاس‌های دریافت 

protected final  getClasses ()

بازگشت‌ها

دریافت فایل Jar 

protected File getJarFile (String jarName, 
                TestInformation testInfo)

برای یافتن شیشه مورد نظر، چندین مکان را که معمولاً مصنوعات در آنها قرار دارند، برای موارد استفاده مختلف بررسی کنید.

پارامترها
jarName String

testInfo TestInformation

بازگشت‌ها
File

hasJUnit4Annotation 

protected boolean hasJUnit4Annotation (Class<?> classObj)

کمکی برای تعیین اینکه آیا با یک کلاس Test با حاشیه‌نویسی‌های Junit4 سر و کار داریم یا خیر.

پارامترها
classObj Class

بازگشت‌ها
boolean

بارگذاری شیء 

protected Object loadObject (Class<?> classObj)

شیء کلاس را بارگذاری کنید و اطلاعات تست (دستگاه، ساخت) را تنظیم کنید.

پارامترها
classObj Class

بازگشت‌ها
Object

نام کلاس را تنظیم کنید 

protected void setClassName (String className)

پاک کن و سپس نام کلاسی که قرار است اجرا شود را تعیین کن.

پارامترها
className String

shouldTestRun 

protected boolean shouldTestRun (AnnotatedElement annotatedElement)

بررسی کنید که آیا عنصری که حاشیه‌نویسی دارد از فیلتر عبور می‌کند یا خیر. برای تست واحد در معرض نمایش قرار گرفته است.

بازگشت‌ها
boolean اگر تست نباید اجرا شود، false می‌شود.