ITestSuite

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

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 BUILD_ATTRIBUTE_FLAG_OVERRIDES_KEY

public static final String ENABLE_RESOLVE_SYM_LINKS

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 STAGE_MODULE_ARTIFACTS

public static final String TEST_TYPE_KEY

public static final String TEST_TYPE_VALUE_PERFORMANCE

public static final String TOKEN_KEY

protected boolean mEnableResolveSymlinks

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 setSkipContext ( SkipContext skipContext)
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 ماشین میزبان را برمی گرداند.

void setPrioritizeHostConfig (boolean prioritizeHostConfig)

تنظیم گزینه prioritize-host-config.

boolean shouldModuleRun ( ModuleDefinition module)

فیلدها

ABI_OPTION 

public static final String ABI_OPTION

ACTIVE_MAINLINE_PARAMETER_KEY 

public static final String ACTIVE_MAINLINE_PARAMETER_KEY

BUILD_ATTRIBUTE_FLAG_OVERRIDES_KEY 

public static final String BUILD_ATTRIBUTE_FLAG_OVERRIDES_KEY

public static final String ENABLE_RESOLVE_SYM_LINKS

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

STAGE_MODULE_ARTIFACTS 

public static final String STAGE_MODULE_ARTIFACTS

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

protected boolean mEnableResolveSymlinks

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

setSkipContext 

public void setSkipContext (SkipContext skipContext)

پارامترها
skipContext SkipContext

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 ماشین میزبان را برمی گرداند.

برمی گرداند

setPrioritizeHostConfig 

protected void setPrioritizeHostConfig (boolean prioritizeHostConfig)

تنظیم گزینه prioritize-host-config.

پارامترها
prioritizeHostConfig boolean : برای اولویت بندی پیکربندی میزبان درست است، یعنی در صورت امکان تست میزبان را اجرا کنید.

بایدModuleRun 

protected boolean shouldModuleRun (ModuleDefinition module)

پارامترها
module ModuleDefinition

برمی گرداند
boolean