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_METADATA_EXCLUDE_FILTER |
public static final String | MODULE_METADATA_INCLUDE_FILTER |
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 | REBOOT_BEFORE_TEST |
public static final String | RUNNER_WHITELIST |
public static final String | SKIP_HOST_ARCH_CHECK |
public static final String | SKIP_SYSTEM_STATUS_CHECKER |
public static final String | TOKEN_KEY
|
سازندگان عمومی | |
---|---|
ITestSuite () |
روش های عمومی | |
---|---|
void | addModuleMetadataExcludeFilters (MultiMap<String, String> filters) |
void | addModuleMetadataIncludeFilters (MultiMap<String, String> filters) |
final void | enableRebootBeforeTest () راه اندازی مجدد قبل از تست را روی true تنظیم می کند. |
getAbis (ITestDevice device) مجموعه ای از ABI های پشتیبانی شده توسط تست سازگاری | |
static | getAbisForBuildTargetArchFromSuite () abis احتمالی را از TestSuiteInfo برمیگرداند. |
IBuildInfo | getBuildInfo () پیادهسازی |
final IConfiguration | getConfiguration () |
ITestLogger | getCurrentTestLogger () |
ITestDevice | getDevice () دستگاه را تحت آزمایش قرار دهید. |
ModuleDefinition | getDirectModule () |
IInvocationContext | getInvocationContext () زمینه فراخوانی را برمیگرداند. |
final String | getRequestedAbi () abi درخواست شده را با گزینه -a یا --abi برمی گرداند. |
getRequiredTokens () | |
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 | setInvocationContext (IInvocationContext invocationContext) |
void | setInvocationInjector (Injector injector) Guice |
void | setMetricCollectors ( collectors) setMetricCollectors ( collectors) لیست |
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 | filterByConfigMetadata ( IConfiguration config, MultiMap<String, String> include, MultiMap<String, String> exclude) فیلتر ابرداده را روی پیکربندی اعمال کنید و ببینید آیا پیکربندی باید اجرا شود یا خیر. |
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_METADATA_EXCLUDE_FILTER
public static final String MODULE_METADATA_EXCLUDE_FILTER
MODULE_METADATA_INCLUDE_FILTER
public static final String MODULE_METADATA_INCLUDE_FILTER
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
REBOOT_BEFORE_TEST
public static final String REBOOT_BEFORE_TEST
RUNNER_WHITELIST
public static final String RUNNER_WHITELIST
SKIP_HOST_ARCH_CHECK
public static final String SKIP_HOST_ARCH_CHECK
SKIP_SYSTEM_STATUS_CHECKER
public static final String SKIP_SYSTEM_STATUS_CHECKER
TOKEN_KEY
public static final String TOKEN_KEY
سازندگان عمومی
ITestSuite
public ITestSuite ()
روش های عمومی
addModuleMetadataExcludeFilters
public void addModuleMetadataExcludeFilters (MultiMap<String, String> filters)
پارامترها | |
---|---|
filters | MultiMap |
addModuleMetadataIncludeFilters
public void addModuleMetadataIncludeFilters (MultiMap<String, String> filters)
پارامترها | |
---|---|
filters | MultiMap |
RebootBeforeTest را فعال کنید
public final void enableRebootBeforeTest ()
راه اندازی مجدد قبل از تست را روی true تنظیم می کند.
getAbis
publicgetAbis (ITestDevice device)
مجموعه ای از ABI های پشتیبانی شده توسط تست سازگاری AbiUtils.getAbisSupportedByCompatibility()
و دستگاه تحت آزمایش را دریافت می کند.
پارامترها | |
---|---|
device | ITestDevice |
برمی گرداند | |
---|---|
مجموعه ای از ABI ها برای اجرای آزمایش ها |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getAbisForBuildTargetArchFromSuite
public staticgetAbisForBuildTargetArchFromSuite ()
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 |
getInvocationContext
public IInvocationContext getInvocationContext ()
زمینه فراخوانی را برمیگرداند.
برمی گرداند | |
---|---|
IInvocationContext |
getRequestedAbi
public final String getRequestedAbi ()
abi درخواست شده را با گزینه -a یا --abi برمی گرداند.
برمی گرداند | |
---|---|
String |
getRequiredTokens
publicgetRequiredTokens ()
برمی گرداند | |
---|---|
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 |
listener | 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 مورد استفاده |
setInvocationContext
public void setInvocationContext (IInvocationContext invocationContext)
پارامترها | |
---|---|
invocationContext | IInvocationContext |
setInvocationInjector
public void setInvocationInjector (Injector injector)
Guice Injector
فعلی را از فراخوانی دریافت کنید. باید به ما اجازه دهد تا تزریق شی ماژول ها را ادامه دهیم.
پارامترها | |
---|---|
injector | Injector |
setMetricCollectors
public void setMetricCollectors (collectors)
لیست IMetricCollector
های تعریف شده برای اجرای آزمایشی را تنظیم می کند.
پارامترها | |
---|---|
collectors |
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)
پارامترها | |
---|---|
testLogger | ITestLogger |
تقسیم
publicsplit (Integer shardCountHint, TestInformation testInfo)
نسخه جایگزین split(int)
که همچنین یک TestInformation
ارائه می دهد که حاوی اطلاعات اولیه از والد ایجاد خرده ها است. اگر در حین به اشتراک گذاری نیاز به دسترسی به اطلاعات دستگاه یا ساختنی باشد، مفید است.
پارامترها | |
---|---|
shardCountHint | Integer : تعداد قطعات تلاش شده. |
testInfo | TestInformation : TestInformation مادر |
برمی گرداند | |
---|---|
مجموعهای از آزمونهای فرعی که به صورت جداگانه اجرا میشوند یا اگر آزمون در حال حاضر قابل تجزیه نیست، null |
روش های محافظت شده
createModuleListeners
protectedcreateModuleListeners ()
لیست ITestInvocationListener
قابل اجرا در سطح ModuleListener
را برمی گرداند. این شنوندگان برای هر ماژول مجدداً استفاده خواهند شد، آنها مجدداً نمونه سازی نمی شوند، بنابراین آنها نباید یک حالت داخلی را در نظر بگیرند.
برمی گرداند | |
---|---|
filterByConfigMetadata
protected boolean filterByConfigMetadata (IConfiguration config, MultiMap<String, String> include, MultiMap<String, String> exclude)
فیلتر ابرداده را روی پیکربندی اعمال کنید و ببینید آیا پیکربندی باید اجرا شود یا خیر.
پارامترها | |
---|---|
config | IConfiguration : IConfiguration در حال ارزیابی است. |
include | MultiMap : ابرداده شامل فیلتر است |
exclude | MultiMap : فیلتر حذف ابرداده |
برمی گرداند | |
---|---|
boolean | اگر ماژول باید اجرا شود درست است، در غیر این صورت نادرست است. |
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 |