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 | 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 های پشتیبانی شده توسط تست سازگاری | |
static | getAbisForBuildTargetArchFromSuite () abis احتمالی را از TestSuiteInfo برمیگرداند. |
IBuildInfo | getBuildInfo () پیادهسازی |
final IConfiguration | getConfiguration () |
ITestLogger | getCurrentTestLogger () |
ITestDevice | getDevice () دستگاه را تحت آزمایش قرار دهید. |
ModuleDefinition | getDirectModule () |
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 | 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
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
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
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 |
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 |
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 |