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 های پشتیبانی شده توسط تست سازگاری | |
static | getAbisForBuildTargetArchFromSuite () abis احتمالی را از TestSuiteInfo برمیگرداند. |
IBuildInfo | getBuildInfo () پیادهسازی |
final IConfiguration | getConfiguration () |
ITestLogger | getCurrentTestLogger () |
ITestDevice | getDevice () دستگاه را تحت آزمایش قرار دهید. |
ModuleDefinition | getDirectModule () |
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 () اگر در حال حاضر در |
abstract | loadTests () روش انتزاعی برای بارگذاری پیکربندی تست هایی که اجرا می شود. |
void | reportNotExecuted ( ITestInvocationListener listener, String message) تست های اجرا نشده را به شنونده اصلی ارائه شده گزارش دهید. |
void | reportNotExecuted ( ITestInvocationListener listener) تست های اجرا نشده را به شنونده اصلی ارائه شده گزارش دهید. |
final void | run ( TestInformation testInfo, ITestInvocationListener listener) روش اجرای عمومی برای تمام تست های بارگیری شده از |
void | setAbiName (String abiName) مقدار mAbiName را تنظیم کنید |
final void | setAbis ( abis) setAbis ( abis) |
void | setBuild ( IBuildInfo buildInfo) |
void | setCollectTestsOnly (boolean shouldCollectTest) مجموعه آزمایشی را در حالت فقط جمعآوری اجرا کنید، برای پیادهسازی این رابط نیز به تمام آزمونهای فرعی نیاز دارد. |
void | setConfiguration ( IConfiguration configuration) |
void | setDevice ( ITestDevice device) دستگاه تحت آزمایش را تزریق کنید. |
void | setDirectModule ( ModuleDefinition module) |
void | setIntraModuleSharding (boolean intraModuleSharding) |
void | setInvocationContext ( IInvocationContext invocationContext) |
void | setMetricCollectors ( collectors) setMetricCollectors ( collectors) لیست |
void | setMultiDeviceStrategy ( ITestSuite.MultiDeviceModuleStrategy strategy) |
void | setPrimaryAbiRun (boolean primaryAbiRun) مقدار mPrimaryAbiRun را تنظیم کنید |
void | setShouldMakeDynamicModule (boolean dynamicModule) هنگام انجام اشتراکگذاری توزیعشده، نمیتوانیم ModuleDefinition داشته باشیم که آزمایشها را در یک استخر به اشتراک بگذارد، در غیر این صورت اشتراکگذاری درون ماژول کار نخواهد کرد، بنابراین اجازه میدهیم آن را غیرفعال کنیم. |
void | setSkipContext ( SkipContext skipContext) |
void | setSystemStatusChecker ( systemCheckers) setSystemStatusChecker ( systemCheckers) |
void | setTestLogger ( ITestLogger testLogger) نمونه |
split (Integer shardCountHint, TestInformation testInfo) نسخه جایگزین |
روش های محافظت شده | |
---|---|
createModuleListeners () لیست | |
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
ENABLE_RESOLVE_SYM_LINKS
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
mEnableResolveSymlinks
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
publicgetAbis (ITestDevice device)
مجموعه ای از ABI های پشتیبانی شده توسط تست سازگاری AbiUtils.getAbisSupportedByCompatibility()
و دستگاه تحت آزمایش را دریافت می کند.
پارامترها | |
---|---|
device | ITestDevice |
برمی گرداند | |
---|---|
مجموعه ای از ABI ها برای اجرای آزمایش ها |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getAbisForBuildTargetArchFromSuite
public staticgetAbisForBuildTargetArchFromSuite ()
abis احتمالی را از TestSuiteInfo برمیگرداند.
برمی گرداند | |
---|---|
getBuildInfo
public IBuildInfo getBuildInfo ()
پیادهسازی ITestSuite
ممکن است برای بارگیری آزمایشها به اطلاعات ساخت نیاز داشته باشد.
برمی گرداند | |
---|---|
IBuildInfo |
getConfiguration
public final IConfiguration getConfiguration ()
IConfiguration
فراخوان را برمیگرداند.
برمی گرداند | |
---|---|
IConfiguration |
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
publicgetRequiredTokens (TestInformation testInfo)
لیست نشانه های مورد نیاز توسط آزمون را برمی گرداند. در صورت عدم پشتیبانی رمز، پوچ برمیگرداند.
پارامترها | |
---|---|
testInfo | TestInformation |
برمی گرداند | |
---|---|
getRuntimeHint
public long getRuntimeHint ()
زمان اجرای مورد انتظار آزمایش را بر حسب میلی ثانیه برگردانید. از زمان برای بارگذاری اجرای قطعه قطعه شده تعادل استفاده می شود
برمی گرداند | |
---|---|
long |
getTestsDir
public File getTestsDir ()
برمی گرداند | |
---|---|
File |
تقسیم می شود
public boolean isSplitting ()
اگر در حال حاضر در IShardableTest.split(int)
باشیم، true برمیگرداند.
برمی گرداند | |
---|---|
boolean |
loadTests
public abstractloadTests ()
روش انتزاعی برای بارگذاری پیکربندی تست هایی که اجرا می شود. هر آزمون با یک 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 |
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 |
تقسیم
publicsplit (Integer shardCountHint, TestInformation testInfo)
نسخه جایگزین split(int)
که همچنین یک TestInformation
را ارائه می دهد که حاوی اطلاعات اولیه از والد ایجاد خرده ها است. اگر در حین به اشتراک گذاری نیاز به دسترسی به اطلاعات دستگاه یا ساختنی باشد، مفید است.
پارامترها | |
---|---|
shardCountHint | Integer : تعداد قطعات تلاش شده. |
testInfo | TestInformation : TestInformation مادر |
برمی گرداند | |
---|---|
مجموعهای از آزمونهای فرعی که به صورت جداگانه اجرا میشوند یا اگر آزمون در حال حاضر قابل تجزیه نیست، null |
روش های محافظت شده
createModuleListeners
protectedcreateModuleListeners ()
لیست ITestInvocationListener
قابل اجرا در سطح ModuleListener
را برمی گرداند. این شنوندگان برای هر ماژول مجدداً استفاده خواهند شد، آنها مجدداً نمونه سازی نمی شوند، بنابراین آنها نباید یک حالت داخلی را در نظر بگیرند.
برمی گرداند | |
---|---|
filterByRunnerType
protected boolean filterByRunnerType (IConfiguration config,allowedRunners)
فیلتر کردن لیست سفید Runner را اعمال کنید، هر دونده ای را که در لیست سفید قرار نگرفته اند حذف کنید. اگر یک پیکربندی دارای چندین اجراکننده باشد، ممکن است برخی از آنها حذف شوند و پیکربندی همچنان اجرا شود.
پارامترها | |
---|---|
config | IConfiguration : IConfiguration در حال ارزیابی است. |
allowedRunners |
برمی گرداند | |
---|---|
boolean | درست است اگر ماژول پیکربندی اجازه اجرا داشته باشد، در غیر این صورت نادرست است. |
getAbisForBuildTargetArch
protectedgetAbisForBuildTargetArch ()
Abis پشتیبانی شده توسط معماری هدف ساخت Host را برگردانید. در معرض آزمایش قرار گرفته است.
برمی گرداند | |
---|---|
getHostAbis
protectedgetHostAbis ()
abis ماشین میزبان را برمی گرداند.
برمی گرداند | |
---|---|
بایدModuleRun
protected boolean shouldModuleRun (ModuleDefinition module)
پارامترها | |
---|---|
module | ModuleDefinition |
برمی گرداند | |
---|---|
boolean |