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


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

خلاصه

زمینه های

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 REBOOT_BEFORE_TEST

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)
final void enableRebootBeforeTest ()

راه اندازی مجدد قبل از آزمایش را بر روی true تنظیم می کند.

getAbis (ITestDevice device)

می شود مجموعه ای از ABIS با حمایت هر دو آزمایش سازگاری AbiUtils.getAbisSupportedByCompatibility() و دستگاه تحت آزمون.

static getAbisForBuildTargetArchFromSuite ()

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

IBuildInfo getBuildInfo ()

اجرای ITestSuite ممکن است اطلاعات ساخت نیاز به بارگذاری آزمون.

final IConfiguration getConfiguration ()

را برمی گرداند نیایش IConfiguration .

ITestLogger getCurrentTestLogger ()
ITestDevice getDevice ()

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

ModuleDefinition getDirectModule ()

را برمی گرداند ModuleDefinition به طور مستقیم اجرا شود، یا null در صورتی هنوز (زمانی که ITestSuite هنوز sharded داده نشده است).

IInvocationContext getInvocationContext ()

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

final String getRequestedAbi ()

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

getRequiredTokens ()
long getRuntimeHint ()

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

File getTestsDir ()
boolean isSplitting ()

درست میشود اگر ما در حال حاضر در IShardableTest.split(int) .

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 setInvocationContext (IInvocationContext invocationContext)

void setInvocationInjector (Injector injector)

مطلع جریان Guice Injector از نیایش.

void setMetricCollectors ( collectors) setMetricCollectors ( collectors)

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

void setPrimaryAbiRun (boolean primaryAbiRun)

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

void setShouldMakeDynamicModule (boolean dynamicModule)

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

void setSystemStatusChecker ( systemCheckers) setSystemStatusChecker ( systemCheckers)

تنظیم می ISystemStatusChecker بازدید کنندگان از پیکربندی برای تست.

void setTestLogger (ITestLogger testLogger)

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 پشتیبانی شده توسط معماری هدف ساخت میزبان را بازگردانید.

getHostAbis ()

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

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

تصادفی_ SEED

public static final String RANDOM_SEED

REBOOT_BEFORE_TEST

public static final String REBOOT_BEFORE_TEST

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

enableRebootBeforeTest

public final void enableRebootBeforeTest ()

راه اندازی مجدد قبل از آزمایش را بر روی true تنظیم می کند.

getAbis

public  getAbis (ITestDevice device)

می شود مجموعه ای از ABIS با حمایت هر دو آزمایش سازگاری AbiUtils.getAbisSupportedByCompatibility() و دستگاه تحت آزمون.

مولفه های
device ITestDevice

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

پرتاب می کند
DeviceNotAvailableException

getAbisForBuildTargetArchFromSuite

public static  getAbisForBuildTargetArchFromSuite ()

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

برمی گردد

getBuildInfo

public IBuildInfo getBuildInfo ()

اجرای ITestSuite ممکن است اطلاعات ساخت نیاز به بارگذاری آزمون.

برمی گردد
IBuildInfo

getConfiguration

public final IConfiguration getConfiguration ()

را برمی گرداند نیایش IConfiguration .

برمی گردد
IConfiguration

getCurrentTestLogger

public ITestLogger getCurrentTestLogger ()

برمی گردد
ITestLogger

getDevice

public ITestDevice getDevice ()

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

برمی گردد
ITestDevice ITestDevice

getDirectModule

public ModuleDefinition getDirectModule ()

را برمی گرداند ModuleDefinition به طور مستقیم اجرا شود، یا null در صورتی هنوز (زمانی که ITestSuite هنوز sharded داده نشده است).

برمی گردد
ModuleDefinition

getInvocationContext

public IInvocationContext getInvocationContext ()

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

برمی گردد
IInvocationContext

getRequestedAbi

public final String getRequestedAbi ()

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

برمی گردد
String

getRequiredTokens

public  getRequiredTokens ()

برمی گردد

getRuntimeHint

public long getRuntimeHint ()

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

برمی گردد
long

getTestsDir

public File getTestsDir ()

برمی گردد
File

isSplitting

public boolean isSplitting ()

درست میشود اگر ما در حال حاضر در IShardableTest.split(int) .

برمی گردد
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

listener 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

setCollectTests فقط

public void setCollectTestsOnly (boolean shouldCollectTest)

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

setConfiguration

public void setConfiguration (IConfiguration configuration)

تزریق IConfiguration استفاده شده است.

مولفه های
configuration IConfiguration

setDevice

public void setDevice (ITestDevice device)

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

مولفه های
device ITestDevice است: ITestDevice به استفاده از

setInvocationContext

public void setInvocationContext (IInvocationContext invocationContext)

مولفه های
invocationContext IInvocationContext

setInvocationInjector

public void setInvocationInjector (Injector injector)

مطلع جریان Guice Injector از نیایش. این باید به ما اجازه دهد تزریق شیء ماژول ها را ادامه دهیم.

مولفه های
injector Injector

setMetricCollectors

public void setMetricCollectors ( collectors)

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

مولفه های
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 بازدید کنندگان از پیکربندی برای تست.

مولفه های
systemCheckers

setTestLogger

public void setTestLogger (ITestLogger testLogger)

مولفه های
testLogger ITestLogger

شکاف

public  split (Integer shardCountHint, 
                TestInformation testInfo)

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

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

testInfo TestInformation : پدر و مادر TestInformation

برمی گردد
مجموعه ای از خرده آزمون به طور جداگانه و یا اعدام می شود null اگر آزمون در حال حاضر shardable نیست

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

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 پشتیبانی شده توسط معماری هدف ساخت میزبان را بازگردانید. در معرض آزمایش قرار گرفته است.

برمی گردد

getHostAbis

protected  getHostAbis ()

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

برمی گردد

shouldModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

مولفه های
module ModuleDefinition

برمی گردد
boolean