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 |
Lớp trừu tượng được sử dụng để chạy Test Suite. Lớp này cung cấp cơ sở về cách chạy Suite. Mỗi lần triển khai có thể xác định danh sách kiểm tra thông qua phương thức loadTests()
.
Bản tóm tắt
Lĩnh vực | |
---|---|
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
|
nhà thầu công cộng | |
---|---|
ITestSuite () |
Phương thức công khai | |
---|---|
void | addModuleMetadataExcludeFilters ( MultiMap <String, String> filters) |
void | addModuleMetadataIncludeFilters ( MultiMap <String, String> filters) |
boolean | filterByConfigMetadata ( IConfiguration config, MultiMap <String, String> include, MultiMap <String, String> exclude) Áp dụng bộ lọc siêu dữ liệu cho cấu hình và xem liệu cấu hình có nên chạy hay không. |
getAbis ( ITestDevice device) Lấy tập hợp ABI được hỗ trợ bởi cả thử nghiệm Khả năng tương thích | |
static | getAbisForBuildTargetArchFromSuite () Trả về abis có thể có từ TestSuiteInfo. |
IBuildInfo | getBuildInfo () Việc triển khai |
final IConfiguration | getConfiguration () Trả về lời gọi |
ITestLogger | getCurrentTestLogger () |
ITestDevice | getDevice () Nhận thiết bị được kiểm tra. |
ModuleDefinition | getDirectModule () Trả về |
IInvocationContext | getInvocationContext () Trả về bối cảnh gọi. |
MultiMap <String, String> | getModuleMetadataIncludeFilters () |
final String | getRequestedAbi () Trả về abi được yêu cầu với tùy chọn -a hoặc --abi. |
getRequiredTokens ( TestInformation testInfo) Trả về danh sách các mã thông báo được yêu cầu bằng bài kiểm tra. | |
long | getRuntimeHint () Trả về thời gian chạy thử nghiệm dự kiến tính bằng mili giây. |
File | getTestsDir () |
boolean | isSplitting () Trả về true nếu chúng tôi hiện đang ở |
abstract | loadTests () Phương pháp trừu tượng để tải cấu hình thử nghiệm sẽ được chạy. |
void | reportNotExecuted ( ITestInvocationListener listener, String message) Báo cáo các bài kiểm tra không được thực hiện cho người nghe chính được cung cấp. |
void | reportNotExecuted ( ITestInvocationListener listener) Báo cáo các bài kiểm tra không được thực hiện cho người nghe chính được cung cấp. |
final void | run ( TestInformation testInfo, ITestInvocationListener listener) Phương thức chạy chung cho tất cả thử nghiệm được tải từ |
void | setAbiName (String abiName) Đặt giá trị của mAbiName |
final void | setAbis ( abis) setAbis ( abis) |
void | setBuild ( IBuildInfo buildInfo) |
void | setCollectTestsOnly (boolean shouldCollectTest) Chạy bộ thử nghiệm ở chế độ chỉ bộ sưu tập, điều này yêu cầu tất cả các thử nghiệm phụ cũng phải triển khai giao diện này. |
void | setConfiguration ( IConfiguration configuration) Tiêm |
void | setDevice ( ITestDevice device) Tiêm thiết bị được kiểm tra. |
void | setDirectModule ( ModuleDefinition module) |
void | setInvocationContext ( IInvocationContext invocationContext) |
void | setMetricCollectors ( collectors) setMetricCollectors ( collectors) Đặt danh sách |
void | setPrimaryAbiRun (boolean primaryAbiRun) Đặt giá trị của mPrimaryAbiRun |
void | setShouldMakeDynamicModule (boolean dynamicModule) Khi thực hiện bảo vệ phân tán, chúng tôi không thể có ModuleDefinition chia sẻ các bài kiểm tra trong nhóm nếu không bảo vệ nội bộ mô-đun sẽ không hoạt động, vì vậy chúng tôi cho phép tắt tính năng này. |
void | setSystemStatusChecker ( systemCheckers) setSystemStatusChecker ( systemCheckers) Đặt |
void | setTestLogger ( ITestLogger testLogger) Tiêm phiên bản |
split (Integer shardCountHint, TestInformation testInfo) Phiên bản thay thế của |
phương pháp được bảo vệ | |
---|---|
createModuleListeners () Trả về danh sách | |
boolean | filterByRunnerType ( IConfiguration config, allowedRunners) filterByRunnerType ( IConfiguration config, allowedRunners) Áp dụng bộ lọc danh sách trắng Người chạy, loại bỏ bất kỳ người chạy nào không có trong danh sách trắng. |
getAbisForBuildTargetArch () Trả lại abis được kiến trúc mục tiêu xây dựng Máy chủ hỗ trợ. | |
getHostAbis () Trả về máy chủ abis. | |
void | setMultiDeviceStrategy ( ITestSuite.MultiDeviceModuleStrategy strategy) |
boolean | shouldModuleRun ( ModuleDefinition module) |
Lĩnh vực
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
THAM SỐ_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
HẠT GIỐNG NGẪU NHIÊN
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
nhà thầu công cộng
ITestSuite
public ITestSuite ()
Phương thức công khai
addModuleMetadataExcludeFilters
public void addModuleMetadataExcludeFilters (MultiMap<String, String> filters)
Thông số | |
---|---|
filters | MultiMap |
addModuleMetadataIncludeFilters
public void addModuleMetadataIncludeFilters (MultiMap<String, String> filters)
Thông số | |
---|---|
filters | MultiMap |
filterByConfigSiêu dữ liệu
public boolean filterByConfigMetadata (IConfiguration config, MultiMap<String, String> include, MultiMap<String, String> exclude)
Áp dụng bộ lọc siêu dữ liệu cho cấu hình và xem liệu cấu hình có nên chạy hay không.
Thông số | |
---|---|
config | IConfiguration : IConfiguration đang được đánh giá. |
include | MultiMap : siêu dữ liệu bao gồm bộ lọc |
exclude | MultiMap : bộ lọc loại trừ siêu dữ liệu |
trả lại | |
---|---|
boolean | Đúng nếu mô-đun sẽ chạy, sai nếu không. |
getAbis
publicgetAbis (ITestDevice device)
Lấy tập hợp ABI được hỗ trợ bởi cả thử nghiệm Khả năng tương thích AbiUtils.getAbisSupportedByCompatibility()
và thiết bị được thử nghiệm.
Thông số | |
---|---|
device | ITestDevice |
trả lại | |
---|---|
Bộ ABI để chạy thử nghiệm trên |
ném | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getAbisForBuildTargetArchFromSuite
public staticgetAbisForBuildTargetArchFromSuite ()
Trả về abis có thể có từ TestSuiteInfo.
trả lại | |
---|---|
getBuildInfo
public IBuildInfo getBuildInfo ()
Việc triển khai ITestSuite
có thể yêu cầu thông tin bản dựng để tải các bài kiểm tra.
trả lại | |
---|---|
IBuildInfo |
nhận cấu hình
public final IConfiguration getConfiguration ()
Trả về lời gọi IConfiguration
.
trả lại | |
---|---|
IConfiguration |
getDevice
public ITestDevice getDevice ()
Nhận thiết bị được kiểm tra.
trả lại | |
---|---|
ITestDevice | ITestDevice |
getDirectModule
public ModuleDefinition getDirectModule ()
Trả về ModuleDefinition
để được thực thi trực tiếp hoặc null nếu chưa có (khi ITestSuite chưa được phân đoạn).
trả lại | |
---|---|
ModuleDefinition |
getInvocationContext
public IInvocationContext getInvocationContext ()
Trả về bối cảnh gọi.
trả lại | |
---|---|
IInvocationContext |
getModuleMetadataIncludeFilters
public MultiMap<String, String> getModuleMetadataIncludeFilters ()
trả lại | |
---|---|
MultiMap <String, String> |
getRequestedAbi
public final String getRequestedAbi ()
Trả về abi được yêu cầu với tùy chọn -a hoặc --abi.
trả lại | |
---|---|
String |
getRequiredTokens
publicgetRequiredTokens (TestInformation testInfo)
Trả về danh sách các mã thông báo được yêu cầu bằng bài kiểm tra. Trả về null nếu không hỗ trợ mã thông báo.
Thông số | |
---|---|
testInfo | TestInformation |
trả lại | |
---|---|
getRuntimeHint
public long getRuntimeHint ()
Trả về thời gian chạy thử nghiệm dự kiến tính bằng mili giây. Thời gian được sử dụng để thực thi phân đoạn cân bằng tải
trả lại | |
---|---|
long |
getTestsDir
public File getTestsDir ()
trả lại | |
---|---|
File |
isSplit
public boolean isSplitting ()
Trả về true nếu chúng tôi hiện đang ở IShardableTest.split(int)
.
trả lại | |
---|---|
boolean |
tải thử nghiệm
public abstractloadTests ()
Phương pháp trừu tượng để tải cấu hình thử nghiệm sẽ được chạy. Mỗi bài kiểm tra được xác định bởi một IConfiguration
và một tên duy nhất mà theo đó nó sẽ báo cáo kết quả.
trả lại | |
---|---|
báo cáoChưa thực hiện
public void reportNotExecuted (ITestInvocationListener listener, String message)
Báo cáo các bài kiểm tra không được thực hiện cho người nghe chính được cung cấp. Chúng sẽ được báo cáo là không thành công với thông báo NOT_EXECUTED_FAILURE
.
Thông số | |
---|---|
listener | ITestInvocationListener : trình nghe chính để báo cáo các kết quả không được thực hiện. |
message | String : thông báo được liên kết với lỗi không được thực thi. |
báo cáoChưa thực hiện
public void reportNotExecuted (ITestInvocationListener listener)
Báo cáo các bài kiểm tra không được thực hiện cho người nghe chính được cung cấp. Chúng sẽ được báo cáo là không thành công với thông báo NOT_EXECUTED_FAILURE
.
Thông số | |
---|---|
listener | ITestInvocationListener : trình nghe chính để báo cáo các kết quả không được thực thi. |
chạy
public final void run (TestInformation testInfo, ITestInvocationListener listener)
Phương thức chạy chung cho tất cả thử nghiệm được tải từ loadTests()
.
Thông số | |
---|---|
testInfo | TestInformation : Đối tượng TestInformation chứa thông tin hữu ích để chạy thử nghiệm. |
listener | ITestInvocationListener : ITestInvocationListener của kết quả kiểm tra |
ném | |
---|---|
DeviceNotAvailableException |
setAbiName
public void setAbiName (String abiName)
Đặt giá trị của mAbiName
Thông số | |
---|---|
abiName | String |
setAbis
public final void setAbis (abis)
Thông số | |
---|---|
abis |
setCollectTestsOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
Chạy bộ thử nghiệm ở chế độ chỉ bộ sưu tập, điều này yêu cầu tất cả các thử nghiệm phụ cũng phải triển khai giao diện này.
thiết lập cấu hình
public void setConfiguration (IConfiguration configuration)
Tiêm IConfiguration
đang sử dụng.
Thông số | |
---|---|
configuration | IConfiguration |
thiết bị
public void setDevice (ITestDevice device)
Tiêm thiết bị được kiểm tra.
Thông số | |
---|---|
device | ITestDevice : ITestDevice để sử dụng |
setDirectModule
public void setDirectModule (ModuleDefinition module)
Thông số | |
---|---|
module | ModuleDefinition |
setInvocationContext
public void setInvocationContext (IInvocationContext invocationContext)
Thông số | |
---|---|
invocationContext | IInvocationContext |
setMetricCollector
public void setMetricCollectors (collectors)
Đặt danh sách IMetricCollector
s được xác định cho lần chạy thử nghiệm.
Thông số | |
---|---|
collectors |
setPrimaryAbiRun
public void setPrimaryAbiRun (boolean primaryAbiRun)
Đặt giá trị của mPrimaryAbiRun
Thông số | |
---|---|
primaryAbiRun | boolean |
setShouldMakeDynamicModule
public void setShouldMakeDynamicModule (boolean dynamicModule)
Khi thực hiện bảo vệ phân tán, chúng tôi không thể có ModuleDefinition chia sẻ các bài kiểm tra trong nhóm nếu không bảo vệ nội bộ mô-đun sẽ không hoạt động, vì vậy chúng tôi cho phép tắt tính năng này.
Thông số | |
---|---|
dynamicModule | boolean |
setSystemStatusChecker
public void setSystemStatusChecker (systemCheckers)
Đặt ISystemStatusChecker
s từ cấu hình cho thử nghiệm.
Thông số | |
---|---|
systemCheckers |
setTestLogger
public void setTestLogger (ITestLogger testLogger)
Tiêm phiên bản ITestLogger
Thông số | |
---|---|
testLogger | ITestLogger |
tách ra
publicsplit (Integer shardCountHint, TestInformation testInfo)
Phiên bản thay thế của split(int)
cũng cung cấp TestInformation
chứa thông tin sớm từ cấp độ gốc tạo phân đoạn. Sẽ rất hữu ích nếu những thứ như thiết bị hoặc thông tin bản dựng cần được truy cập trong quá trình phân mảnh.
Thông số | |
---|---|
shardCountHint | Integer : số lượng phân đoạn đã thử. |
testInfo | TestInformation : TestInformation gốc |
trả lại | |
---|---|
một tập hợp các bài kiểm tra con sẽ được thực hiện riêng biệt hoặc null giá trị nếu bài kiểm tra hiện không thể chia nhỏ |
phương pháp được bảo vệ
tạoModuleListeners
protectedcreateModuleListeners ()
Trả về danh sách ITestInvocationListener
áp dụng cho cấp độ ModuleListener
. Những bộ lắng nghe này sẽ được sử dụng lại cho từng mô-đun, chúng sẽ không được khởi tạo lại nên chúng không nên ở trạng thái bên trong.
trả lại | |
---|---|
lọcByRunnerType
protected boolean filterByRunnerType (IConfiguration config,allowedRunners)
Áp dụng bộ lọc danh sách trắng Người chạy, loại bỏ bất kỳ người chạy nào không có trong danh sách trắng. Nếu một cấu hình có nhiều trình chạy, một số có thể bị xóa và cấu hình sẽ vẫn chạy.
Thông số | |
---|---|
config | IConfiguration : IConfiguration đang được đánh giá. |
allowedRunners |
trả lại | |
---|---|
boolean | Đúng nếu mô-đun cấu hình được phép chạy, ngược lại là sai. |
getAbisForBuildTargetArch
protectedgetAbisForBuildTargetArch ()
Trả lại abis được kiến trúc mục tiêu xây dựng Máy chủ hỗ trợ. Tiếp xúc để thử nghiệm.
trả lại | |
---|---|
getHostAbis
protectedgetHostAbis ()
Trả về máy chủ abis.
trả lại | |
---|---|
setMultiDeviceStrategy
protected void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)
Thông số | |
---|---|
strategy | ITestSuite.MultiDeviceModuleStrategy |
nênModuleRun
protected boolean shouldModuleRun (ModuleDefinition module)
Thông số | |
---|---|
module | ModuleDefinition |
trả lại | |
---|---|
boolean |