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() تعریف کند.

خلاصه

زمینه های

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_END_TIME

public static final String MODULE_METADATA_EXCLUDE_FILTER

public static final String MODULE_METADATA_INCLUDE_FILTER

public static final String MODULE_START_TIME

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_STAGING_ARTIFACTS

public static final String SKIP_SYSTEM_STATUS_CHECKER

public static final String TEST_TYPE_KEY

public static final String TEST_TYPE_VALUE_PERFORMANCE

public static final String TOKEN_KEY

protected boolean mRecoverDeviceByCvd

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

ITestSuite ()

روش های عمومی

void addModuleMetadataExcludeFilters ( MultiMap <String, String> filters)
void addModuleMetadataIncludeFilters ( MultiMap <String, String> filters)
void cleanUpSuiteSetup ()

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

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

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

getAbis ( ITestDevice device)

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

static getAbisForBuildTargetArchFromSuite ()

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

IBuildInfo getBuildInfo ()

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

final IConfiguration getConfiguration ()

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

ITestLogger getCurrentTestLogger ()
ITestDevice getDevice ()

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

ModuleDefinition getDirectModule ()

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

boolean getIntraModuleSharding ()
IInvocationContext getInvocationContext ()

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

MultiMap <String, String> getModuleMetadataIncludeFilters ()
ITestSuite.MultiDeviceModuleStrategy getMultiDeviceStrategy ()
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 setIntraModuleSharding (boolean intraModuleSharding)
void setInvocationContext ( IInvocationContext invocationContext)

void setMetricCollectors ( collectors) setMetricCollectors ( collectors)

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

void setMultiDeviceStrategy ( ITestSuite.MultiDeviceModuleStrategy strategy)
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 filterByRunnerType ( IConfiguration config, allowedRunners) filterByRunnerType ( IConfiguration config, allowedRunners)

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

getAbisForBuildTargetArch ()

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

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_END_TIME

public static final String MODULE_END_TIME

MODULE_METADATA_EXCLUDE_FILTER

public static final String MODULE_METADATA_EXCLUDE_FILTER

MODULE_METADATA_INCLUDE_FILTER

public static final String MODULE_METADATA_INCLUDE_FILTER

MODULE_START_TIME

public static final String MODULE_START_TIME

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_STAGING_ARTIFACTS

public static final String SKIP_STAGING_ARTIFACTS

SKIP_SYSTEM_STATUS_CHECKER

public static final String SKIP_SYSTEM_STATUS_CHECKER

TEST_TYPE_KEY

public static final String TEST_TYPE_KEY

TEST_TYPE_VALUE_PERFORMANCE

public static final String TEST_TYPE_VALUE_PERFORMANCE

TOKEN_KEY

public static final String TOKEN_KEY

mRecoverDeviceByCvd

protected boolean mRecoverDeviceByCvd

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

ITestSuite

public ITestSuite ()

روش های عمومی

addModuleMetadataExcludeFilters

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

مولفه های
filters MultiMap

addModuleMetadataIncludeFilters

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

مولفه های
filters MultiMap

cleanUpSuiteSetup

public void cleanUpSuiteSetup ()

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

filterByConfigMetadata

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

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

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

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

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

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

getAbis

public  getAbis (ITestDevice device)

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

مولفه های
device ITestDevice

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

پرتاب می کند
com.android.tradefed.device.DeviceNotAvailableException
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 را برمی‌گرداند تا مستقیماً اجرا شود، یا اگر هنوز هیچکدام از آن‌ها اجرا نشده باشد (زمانی که ITestSuite هنوز خرد نشده باشد) آن را برمی‌گرداند.

برمی گرداند
ModuleDefinition

getIntraModuleSharding

public boolean getIntraModuleSharding ()

برمی گرداند
boolean

getInvocationContext

public IInvocationContext getInvocationContext ()

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

برمی گرداند
IInvocationContext

getModuleMetadataIncludeFilters

public MultiMap<String, String> getModuleMetadataIncludeFilters ()

برمی گرداند
MultiMap <String, String>

getMultiDeviceStrategy

public ITestSuite.MultiDeviceModuleStrategy getMultiDeviceStrategy ()

برمی گرداند
ITestSuite.MultiDeviceModuleStrategy

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

setIntraModuleSharding

public void setIntraModuleSharding (boolean intraModuleSharding)

مولفه های
intraModuleSharding boolean

setInvocationContext

public void setInvocationContext (IInvocationContext invocationContext)

مولفه های
invocationContext IInvocationContext

setMetricCollectors

public void setMetricCollectors ( collectors)

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

مولفه های
collectors

setMultiDeviceStrategy

public void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)

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

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 را برمی گرداند. این شنوندگان برای هر ماژول مجدداً استفاده خواهند شد، آنها مجدداً نمونه سازی نمی شوند، بنابراین آنها نباید یک حالت داخلی را در نظر بگیرند.

برمی گرداند

filterByRunnerType

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

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

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

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

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

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

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

برمی گرداند

getHostAbis

protected  getHostAbis ()

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

برمی گرداند

بایدModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

مولفه های
module ModuleDefinition

برمی گرداند
boolean