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

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

برمی گرداند

بایدModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

پارامترها
module ModuleDefinition

برمی گرداند
boolean