ITestSuite

public abstract class ITestSuite
توسعه extends Object implements IRemoteTest , IDeviceTest , IBuildReceiver , ISystemStatusCheckerReceiver , IShardableTest , ITestCollector , IInvocationContextReceiver , IRuntimeHintProvider , IMetricCollectorReceiver , IConfigurationReceiver , IReportNotExecuted , ITokenRequest , ITestLoggerReceiver

java.lang.object
com.android.tradefed.testtype.suite.ITestSuite


کلاس Abstract برای اجرای Test Suite استفاده می شود. این کلاس اساس نحوه اجرای Suite را ارائه می دهد. هر پیاده سازی می تواند لیستی از تست ها را از طریق loadTests() تعریف کند.

خلاصه

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

enum ITestSuite.MultiDeviceModuleStrategy

زمینه های

public static final String ABI_OPTION

public static final String ACTIVE_MAINLINE_PARAMETER_KEY

public static final String MAINLINE_PARAMETER_KEY

public static final String MODULE_CHECKER_POST

public static final String MODULE_CHECKER_PRE

public static final String MODULE_METADATA_EXCLUDE_FILTER

public static final String MODULE_METADATA_INCLUDE_FILTER

public static final String PARAMETER_KEY

public static final String PREPARER_WHITELIST

public static final String PRIMARY_ABI_RUN

public static final String RANDOM_SEED

public static final String RUNNER_WHITELIST

public static final String SKIP_HOST_ARCH_CHECK

public static final String SKIP_SYSTEM_STATUS_CHECKER

public static final String TOKEN_KEY

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

ITestSuite ()

روش های عمومی

void addModuleMetadataExcludeFilters ( MultiMap <String, String> filters)
void addModuleMetadataIncludeFilters ( MultiMap <String, String> filters)
getAbis ( ITestDevice device)

مجموعه ای از ABI های پشتیبانی شده توسط تست سازگاری AbiUtils.getAbisSupportedByCompatibility() و دستگاه تحت آزمایش را دریافت می کند.

static getAbisForBuildTargetArchFromSuite ()

abis احتمالی را از TestSuiteInfo برمی‌گرداند.

IBuildInfo getBuildInfo ()

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

final IConfiguration getConfiguration ()

پیکربندی IC فراخوان را IConfiguration .

ITestLogger getCurrentTestLogger ()
ITestDevice getDevice ()

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

ModuleDefinition getDirectModule ()

ModuleDefinition را برمی‌گرداند تا مستقیماً اجرا شود، یا اگر هنوز هیچکدام از آن‌ها اجرا نشده باشد (زمانی که ITestSuite هنوز خرد نشده باشد) آن را برمی‌گرداند.

IInvocationContext getInvocationContext ()

زمینه فراخوانی را برمی‌گرداند.

final String getRequestedAbi ()

abi درخواست شده را با گزینه -a یا --abi برمی گرداند.

getRequiredTokens ( TestInformation testInfo)

لیست نشانه های مورد نیاز توسط آزمون را برمی گرداند.

long getRuntimeHint ()

زمان اجرای مورد انتظار آزمایش را بر حسب میلی ثانیه برگردانید.

File getTestsDir ()
boolean isSplitting ()

اگر در حال حاضر در IShardableTest.split(int) باشیم، مقدار true را برمی‌گرداند.

abstract loadTests ()

روش انتزاعی برای بارگذاری تنظیمات آزمایشی که اجرا خواهد شد.

void reportNotExecuted ( ITestInvocationListener listener, String message)

تست های اجرا نشده را به شنونده اصلی ارائه شده گزارش دهید.

void reportNotExecuted ( ITestInvocationListener listener)

تست های اجرا نشده را به شنونده اصلی ارائه شده گزارش دهید.

final void run ( TestInformation testInfo, ITestInvocationListener listener)

روش اجرای عمومی برای تمام تست های بارگیری شده از loadTests() .

void setAbiName (String abiName)

مقدار mAbiName را تنظیم کنید

final void setAbis ( abis) setAbis ( abis)
void setBuild ( IBuildInfo buildInfo)

void setCollectTestsOnly (boolean shouldCollectTest)

مجموعه آزمایشی را در حالت فقط جمع‌آوری اجرا کنید، برای پیاده‌سازی این رابط نیز به تمام آزمون‌های فرعی نیاز دارد.

void setConfiguration ( IConfiguration configuration)

IConfiguration در حال استفاده را تزریق می کند.

void setDevice ( ITestDevice device)

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

void setDirectModule ( ModuleDefinition module)
void setInvocationContext ( IInvocationContext invocationContext)

void setMetricCollectors ( collectors) setMetricCollectors ( collectors)

لیست IMetricCollector های تعریف شده برای اجرای آزمایشی را تنظیم می کند.

void setPrimaryAbiRun (boolean primaryAbiRun)

مقدار mPrimaryAbiRun را تنظیم کنید

void setShouldMakeDynamicModule (boolean dynamicModule)

هنگام انجام اشتراک‌گذاری توزیع‌شده، نمی‌توانیم ModuleDefinition داشته باشیم که آزمایش‌ها را در یک استخر به اشتراک بگذارد، در غیر این صورت اشتراک‌گذاری درون ماژول کار نخواهد کرد، بنابراین اجازه می‌دهیم آن را غیرفعال کنیم.

void setSystemStatusChecker ( systemCheckers) setSystemStatusChecker ( systemCheckers)

ISystemStatusChecker s را از پیکربندی برای آزمایش تنظیم می کند.

void setTestLogger ( ITestLogger testLogger)

نمونه ITestLogger را تزریق می کند

split (Integer shardCountHint, TestInformation testInfo)

نسخه جایگزین split(int) که همچنین یک TestInformation را ارائه می دهد که حاوی اطلاعات اولیه از والد ایجاد خرده ها است.

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

createModuleListeners ()

لیست ITestInvocationListener قابل اجرا در سطح ModuleListener را برمی گرداند.

boolean filterByConfigMetadata ( IConfiguration config, MultiMap <String, String> include, MultiMap <String, String> exclude)

فیلتر ابرداده را روی پیکربندی اعمال کنید و ببینید آیا پیکربندی باید اجرا شود یا خیر.

boolean filterByRunnerType ( IConfiguration config, allowedRunners) filterByRunnerType ( IConfiguration config, allowedRunners)

فیلتر لیست سفید Runner را اعمال کنید و هر دونده ای را که در لیست سفید قرار نگرفته اند حذف کنید.

getAbisForBuildTargetArch ()

abis پشتیبانی شده توسط معماری هدف ساخت Host را برگردانید.

getHostAbis ()

abis ماشین میزبان را برمی گرداند.

void setMultiDeviceStrategy ( ITestSuite.MultiDeviceModuleStrategy strategy)
boolean shouldModuleRun ( ModuleDefinition module)

زمینه های

ABI_OPTION

public static final String ABI_OPTION

ACTIVE_MAINLINE_PARAMETER_KEY

public static final String ACTIVE_MAINLINE_PARAMETER_KEY

MAINLINE_PARAMETER_KEY

public static final String MAINLINE_PARAMETER_KEY

MODULE_CHECKER_POST

public static final String MODULE_CHECKER_POST

MODULE_CHECKER_PRE

public static final String MODULE_CHECKER_PRE

MODULE_METADATA_EXCLUDE_FILTER

public static final String MODULE_METADATA_EXCLUDE_FILTER

MODULE_METADATA_INCLUDE_FILTER

public static final String MODULE_METADATA_INCLUDE_FILTER

PARAMETER_KEY

public static final String PARAMETER_KEY

PREPARER_WHITELIST

public static final String PREPARER_WHITELIST

PRIMARY_ABI_RUN

public static final String PRIMARY_ABI_RUN

RANDOM_SEED

public static final String RANDOM_SEED

RUNNER_WHITELIST

public static final String RUNNER_WHITELIST

SKIP_HOST_ARCH_CHECK

public static final String SKIP_HOST_ARCH_CHECK

SKIP_SYSTEM_STATUS_CHECKER

public static final String SKIP_SYSTEM_STATUS_CHECKER

TOKEN_KEY

public static final String TOKEN_KEY

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

ITestSuite

public ITestSuite ()

روش های عمومی

addModuleMetadataExcludeFilters

public void addModuleMetadataExcludeFilters (MultiMap<String, String> filters)

مولفه های
filters MultiMap

addModuleMetadataIncludeFilters

public void addModuleMetadataIncludeFilters (MultiMap<String, String> filters)

مولفه های
filters MultiMap

getAbis

public  getAbis (ITestDevice device)

مجموعه ای از ABI های پشتیبانی شده توسط تست سازگاری AbiUtils.getAbisSupportedByCompatibility() و دستگاه تحت آزمایش را دریافت می کند.

مولفه های
device ITestDevice

برمی گرداند
مجموعه ای از ABI ها برای اجرای آزمایش ها

پرتاب می کند
DeviceNotAvailableException

getAbisForBuildTargetArchFromSuite

public static  getAbisForBuildTargetArchFromSuite ()

abis احتمالی را از TestSuiteInfo برمی‌گرداند.

برمی گرداند

getBuildInfo

public IBuildInfo getBuildInfo ()

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

برمی گرداند
IBuildInfo

getConfiguration

public final IConfiguration getConfiguration ()

پیکربندی IC فراخوان را IConfiguration .

برمی گرداند
IConfiguration

getCurrentTestLogger

public ITestLogger getCurrentTestLogger ()

برمی گرداند
ITestLogger

getDevice

public ITestDevice getDevice ()

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

برمی گرداند
ITestDevice دستگاه ITestDevice

getDirectModule

public ModuleDefinition getDirectModule ()

ModuleDefinition را برمی‌گرداند تا مستقیماً اجرا شود، یا اگر هنوز هیچکدام از آن‌ها اجرا نشده باشد (زمانی که ITestSuite هنوز خرد نشده باشد) آن را برمی‌گرداند.

برمی گرداند
ModuleDefinition

getInvocationContext

public IInvocationContext getInvocationContext ()

زمینه فراخوانی را برمی‌گرداند.

برمی گرداند
IInvocationContext

getRequestedAbi

public final String getRequestedAbi ()

abi درخواست شده را با گزینه -a یا --abi برمی گرداند.

برمی گرداند
String

getRequiredTokens

public  getRequiredTokens (TestInformation testInfo)

لیست نشانه های مورد نیاز توسط آزمون را برمی گرداند. در صورت عدم پشتیبانی رمز، پوچ برمی‌گرداند.

مولفه های
testInfo TestInformation

برمی گرداند

getRuntimeHint

public long getRuntimeHint ()

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

برمی گرداند
long

getTestsDir

public File getTestsDir ()

برمی گرداند
File

تقسیم می شود

public boolean isSplitting ()

اگر در حال حاضر در IShardableTest.split(int) باشیم، مقدار true را برمی‌گرداند.

برمی گرداند
boolean

loadTests

public abstract  loadTests ()

روش انتزاعی برای بارگذاری تنظیمات آزمایشی که اجرا خواهد شد. هر آزمون با یک IConfiguration و یک نام منحصر به فرد تعریف می شود که تحت آن نتایج را گزارش می دهد.

برمی گرداند

ReportNotExecuted

public void reportNotExecuted (ITestInvocationListener listener, 
                String message)

تست های اجرا نشده را به شنونده اصلی ارائه شده گزارش دهید. آنها باید با پیام NOT_EXECUTED_FAILURE به عنوان ناموفق گزارش شوند.

مولفه های
listener ITestInvocationListener : شنونده اصلی جایی که نتایج اجرا نشده را گزارش کند.

message String : پیامی که با شکست اجرا نشده مرتبط است.

ReportNotExecuted

public void reportNotExecuted (ITestInvocationListener listener)

تست های اجرا نشده را به شنونده اصلی ارائه شده گزارش دهید. آنها باید با پیام NOT_EXECUTED_FAILURE به عنوان ناموفق گزارش شوند.

مولفه های
listener ITestInvocationListener : شنونده اصلی جایی که نتایج اجرا نشده را گزارش کند.

اجرا کن

public final void run (TestInformation testInfo, 
                ITestInvocationListener listener)

روش اجرای عمومی برای تمام تست های بارگیری شده از loadTests() .

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

listener ITestInvocationListener : ITestInvocationListener نتایج آزمون

پرتاب می کند
DeviceNotAvailableException

setAbiName

public void setAbiName (String abiName)

مقدار mAbiName را تنظیم کنید

مولفه های
abiName String

setAbis

public final void setAbis ( abis)

مولفه های
abis

setBuild

public void setBuild (IBuildInfo buildInfo)

مولفه های
buildInfo IBuildInfo

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

مجموعه آزمایشی را در حالت فقط جمع‌آوری اجرا کنید، برای پیاده‌سازی این رابط نیز به تمام آزمون‌های فرعی نیاز دارد.

پیکربندی set

public void setConfiguration (IConfiguration configuration)

IConfiguration در حال استفاده را تزریق می کند.

مولفه های
configuration IConfiguration

setDevice

public void setDevice (ITestDevice device)

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

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

setDirectModule

public void setDirectModule (ModuleDefinition module)

مولفه های
module ModuleDefinition

setInvocationContext

public void setInvocationContext (IInvocationContext invocationContext)

مولفه های
invocationContext IInvocationContext

setMetricCollectors

public void setMetricCollectors ( collectors)

لیست IMetricCollector های تعریف شده برای اجرای آزمایشی را تنظیم می کند.

مولفه های
collectors

setPrimaryAbiRun

public void setPrimaryAbiRun (boolean primaryAbiRun)

مقدار mPrimaryAbiRun را تنظیم کنید

مولفه های
primaryAbiRun boolean

setShouldMakeDynamicModule

public void setShouldMakeDynamicModule (boolean dynamicModule)

هنگام انجام اشتراک‌گذاری توزیع‌شده، نمی‌توانیم ModuleDefinition داشته باشیم که آزمایش‌ها را در یک استخر به اشتراک بگذارد، در غیر این صورت اشتراک‌گذاری درون ماژول کار نخواهد کرد، بنابراین اجازه می‌دهیم آن را غیرفعال کنیم.

مولفه های
dynamicModule boolean

setSystemStatusChecker

public void setSystemStatusChecker ( systemCheckers)

ISystemStatusChecker s را از پیکربندی برای آزمایش تنظیم می کند.

مولفه های
systemCheckers

setTestLogger

public void setTestLogger (ITestLogger testLogger)

نمونه ITestLogger را تزریق می کند

مولفه های
testLogger ITestLogger

شکاف

public  split (Integer shardCountHint, 
                TestInformation testInfo)

نسخه جایگزین split(int) که همچنین یک TestInformation را ارائه می دهد که حاوی اطلاعات اولیه از والد ایجاد خرده ها است. اگر در حین به اشتراک گذاری نیاز به دسترسی به اطلاعات دستگاه یا ساختنی باشد، مفید است.

مولفه های
shardCountHint Integer : تعداد قطعات تلاش شده.

testInfo TestInformation : TestInformation مادر

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

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

createModuleListeners

protected  createModuleListeners ()

لیست ITestInvocationListener قابل اجرا در سطح ModuleListener را برمی گرداند. این شنوندگان برای هر ماژول مجدداً استفاده خواهند شد، آنها مجدداً نمونه سازی نمی شوند، بنابراین آنها نباید یک حالت داخلی را در نظر بگیرند.

برمی گرداند

filterByConfigMetadata

protected boolean filterByConfigMetadata (IConfiguration config, 
                MultiMap<String, String> include, 
                MultiMap<String, String> exclude)

فیلتر ابرداده را روی پیکربندی اعمال کنید و ببینید آیا پیکربندی باید اجرا شود یا خیر.

مولفه های
config IConfiguration : IConfiguration در حال ارزیابی است.

include MultiMap : ابرداده شامل فیلتر است

exclude MultiMap : فیلتر حذف ابرداده

برمی گرداند
boolean اگر ماژول باید اجرا شود درست است، در غیر این صورت نادرست است.

filterByRunnerType

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

فیلتر لیست سفید Runner را اعمال کنید و هر دونده ای را که در لیست سفید قرار نگرفته اند حذف کنید. اگر یک پیکربندی دارای چندین اجراکننده باشد، ممکن است برخی از آنها حذف شوند و پیکربندی همچنان اجرا شود.

مولفه های
config IConfiguration : IConfiguration در حال ارزیابی است.

allowedRunners : لیست سفید دونده فعلی.

برمی گرداند
boolean اگر ماژول پیکربندی اجازه اجرا داشته باشد درست است، در غیر این صورت نادرست است.

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

abis پشتیبانی شده توسط معماری هدف ساخت Host را برگردانید. در معرض آزمایش قرار گرفته است.

برمی گرداند

getHostAbis

protected  getHostAbis ()

abis ماشین میزبان را برمی گرداند.

برمی گرداند

setMultiDeviceStrategy

protected void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)

مولفه های
strategy ITestSuite.MultiDeviceModuleStrategy

بایدModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

مولفه های
module ModuleDefinition

برمی گرداند
boolean