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 |
کلاس انتزاعی برای اجرای 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) می شود مجموعه ای از ABIS با حمایت هر دو آزمایش سازگاری | |
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 پشتیبانی شده توسط معماری هدف ساخت میزبان را بازگردانید. | |
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
تصادفی_ 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 |
enableRebootBeforeTest
public final void enableRebootBeforeTest ()
راه اندازی مجدد قبل از آزمایش را بر روی true تنظیم می کند.
getAbis
publicgetAbis (ITestDevice device)
می شود مجموعه ای از ABIS با حمایت هر دو آزمایش سازگاری 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
به طور مستقیم اجرا شود، یا null در صورتی هنوز (زمانی که ITestSuite هنوز sharded داده نشده است).
برمی گردد | |
---|---|
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 |
isSplitting
public boolean isSplitting ()
درست میشود اگر ما در حال حاضر در IShardableTest.split(int)
.
برمی گردد | |
---|---|
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 |
setCollectTests فقط
public void setCollectTestsOnly (boolean shouldCollectTest)
مجموعه آزمایشی را فقط در حالت جمع کننده اجرا کنید ، برای پیاده سازی این رابط نیز لازم است همه آزمایش های فرعی انجام شود.
setConfiguration
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
S برای اجرای این آزمون را تعریف می شود.
مولفه های | |
---|---|
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
بازدید کنندگان از پیکربندی برای تست.
مولفه های | |
---|---|
systemCheckers |
setTestLogger
public void setTestLogger (ITestLogger testLogger)
مولفه های | |
---|---|
testLogger | ITestLogger |
شکاف
publicsplit (Integer shardCountHint, TestInformation testInfo)
نسخه جایگزین از split(int)
ذکر شده است که TestInformation
که شامل اطلاعات اولیه از پدر و مادر ایجاد تکه. اگر مواردی مانند دستگاه یا اطلاعات ساختمانی در حین خرد کردن نیاز به دسترسی داشته باشند مفید است.
مولفه های | |
---|---|
shardCountHint | Integer : تعداد سفال تلاش. |
testInfo | TestInformation : پدر و مادر TestInformation |
برمی گردد | |
---|---|
مجموعه ای از خرده آزمون به طور جداگانه و یا اعدام می شود null اگر آزمون در حال حاضر shardable نیست |
روشهای حفاظت شده
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 پشتیبانی شده توسط معماری هدف ساخت میزبان را بازگردانید. در معرض آزمایش قرار گرفته است.
برمی گردد | |
---|---|
getHostAbis
protectedgetHostAbis ()
abis ماشین میزبان را برمی گرداند.
برمی گردد | |
---|---|
shouldModuleRun
protected boolean shouldModuleRun (ModuleDefinition module)
مولفه های | |
---|---|
module | ModuleDefinition |
برمی گردد | |
---|---|
boolean |