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 của Suite. Mỗi triển khai có thể xác định danh sách các bài kiểm tra thông qua phương thức loadTests()
.
Bản tóm tắt
Các lớp lồng nhau | |
---|---|
enum | ITestSuite.MultiDeviceModuleStrategy
|
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_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 | RUNNER_WHITELIST |
public static final String | SKIP_HOST_ARCH_CHECK |
public static final String | SKIP_SYSTEM_STATUS_CHECKER |
public static final String | TOKEN_KEY
|
Các nhà xây dựng công cộng | |
---|---|
ITestSuite () |
Phương pháp công khai | |
---|---|
void | addModuleMetadataExcludeFilters ( MultiMap <String, String> filters) |
void | addModuleMetadataIncludeFilters ( MultiMap <String, String> filters) |
getAbis ( ITestDevice device) Nhận tập hợp các ABI được hỗ trợ bởi cả Kiểm tra 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ề cấu hình biểu tượng |
ITestLogger | getCurrentTestLogger () |
ITestDevice | getDevice () Lấy thiết bị đang kiểm tra. |
ModuleDefinition | getDirectModule () Trả về |
IInvocationContext | getInvocationContext () Trả về ngữ cảnh lời 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 dự kiến của bài kiểm tra tính bằng mili giây. |
File | getTestsDir () |
boolean | isSplitting () Trả về true nếu chúng ta hiện đang ở trong |
abstract | loadTests () Phương thức trừu tượng để tải cấu hình kiểm tra 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 pháp 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) |
void | setDevice ( ITestDevice device) Tiêm thiết bị đang thử nghiệm. |
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 sharding phân tán, chúng tôi không thể có ModuleDefinition chia sẻ các bài kiểm tra trong một nhóm, nếu không, sharding trong mô-đun sẽ không hoạt động, vì vậy chúng tôi cho phép vô hiệu hóa nó. |
void | setSystemStatusChecker ( systemCheckers) setSystemStatusChecker ( systemCheckers) Đặt các |
void | setTestLogger ( ITestLogger testLogger) Chèn phiên bản |
split (Integer shardCountHint, TestInformation testInfo) Phiên bản thay thế của |
Các phương pháp được bảo vệ | |
---|---|
createModuleListeners () Trả về danh sách | |
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ó chạy hay không. |
boolean | filterByRunnerType ( IConfiguration config, allowedRunners) filterByRunnerType ( IConfiguration config, allowedRunners) Áp dụng bộ lọc danh sách cho phép của Người chạy, loại bỏ bất kỳ người chạy nào không có trong danh sách cho phép. |
getAbisForBuildTargetArch () Trả lại abis được hỗ trợ bởi kiến trúc mục tiêu xây dựng Máy chủ. | |
getHostAbis () Trả về abis máy chủ. | |
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_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
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_SYSTEM_STATUS_CHECKER
public static final String SKIP_SYSTEM_STATUS_CHECKER
TOKEN_KEY
public static final String TOKEN_KEY
Các nhà xây dựng công cộng
ITestSuite
public ITestSuite ()
Phương pháp 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 |
getAbis
publicgetAbis (ITestDevice device)
Nhận tập hợp các ABI được hỗ trợ bởi cả Kiểm tra khả năng tương thích AbiUtils.getAbisSupportedByCompatibility()
và thiết bị đang được kiểm tra.
Thông số | |
---|---|
device | ITestDevice |
Lợi nhuận | |
---|---|
Tập hợp các ABI để chạy các bài kiểm tra |
Ném | |
---|---|
DeviceNotAvailableException |
getAbisForBuildTargetArchFromSuite
public staticgetAbisForBuildTargetArchFromSuite ()
Trả về abis có thể có từ TestSuiteInfo.
Lợi nhuận | |
---|---|
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.
Lợi nhuận | |
---|---|
IBuildInfo |
getConfiguration
public final IConfiguration getConfiguration ()
Trả về cấu hình biểu tượng IConfiguration
gọi.
Lợi nhuận | |
---|---|
IConfiguration |
getDevice
public ITestDevice getDevice ()
Lấy thiết bị đang kiểm tra.
Lợi nhuận | |
---|---|
ITestDevice | ITestDevice |
getDirectModule
public ModuleDefinition getDirectModule ()
Trả về ModuleDefinition
sẽ đượ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).
Lợi nhuận | |
---|---|
ModuleDefinition |
getInvocationContext
public IInvocationContext getInvocationContext ()
Trả về ngữ cảnh lời gọi.
Lợi nhuận | |
---|---|
IInvocationContext |
getModuleMetadataIncludeFilters
public MultiMap<String, String> getModuleMetadataIncludeFilters ()
Lợi nhuận | |
---|---|
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.
Lợi nhuận | |
---|---|
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 có mã thông báo hỗ trợ.
Thông số | |
---|---|
testInfo | TestInformation |
Lợi nhuận | |
---|---|
getRuntimeH Gợi ý
public long getRuntimeHint ()
Trả về thời gian chạy dự kiến của bài kiểm tra tính bằng mili giây. Thời gian được sử dụng để tải thực thi phân đoạn số dư
Lợi nhuận | |
---|---|
long |
getTestsDir
public File getTestsDir ()
Lợi nhuận | |
---|---|
File |
isSplitting
public boolean isSplitting ()
Trả về true nếu chúng ta hiện đang ở trong IShardableTest.split(int)
.
Lợi nhuận | |
---|---|
boolean |
loadTests
public abstractloadTests ()
Phương thức trừu tượng để tải cấu hình kiểm tra 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à nó sẽ báo cáo kết quả.
Lợi nhuận | |
---|---|
reportNotExecuted
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 lắng nghe chính nơi báo cáo kết quả không được thực thi. |
message | String : thông báo được liên kết với lỗi không được thực thi. |
reportNotExecuted
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 lắng nghe chính nơi báo cáo kết quả không được thực thi. |
chạy
public final void run (TestInformation testInfo, ITestInvocationListener listener)
Phương pháp 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 các bài kiểm tra. |
listener | ITestInvocationListener : ITestInvocationListener 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.
setConfiguration
public void setConfiguration (IConfiguration configuration)
IConfiguration
đang sử dụng.
Thông số | |
---|---|
configuration | IConfiguration |
setDevice
public void setDevice (ITestDevice device)
Tiêm thiết bị đang thử nghiệm.
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 |
setMetricCollectors
public void setMetricCollectors (collectors)
Đặt danh sách IMetricCollector
được xác định để 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 sharding phân tán, chúng tôi không thể có ModuleDefinition chia sẻ các bài kiểm tra trong một nhóm, nếu không, sharding trong mô-đun sẽ không hoạt động, vì vậy chúng tôi cho phép vô hiệu hóa nó.
Thông số | |
---|---|
dynamicModule | boolean |
setSystemStatusChecker
public void setSystemStatusChecker (systemCheckers)
Đặt các ISystemStatusChecker
từ cấu hình để kiểm tra.
Thông số | |
---|---|
systemCheckers |
setTestLogger
public void setTestLogger (ITestLogger testLogger)
Chèn 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 ban đầu từ cha mẹ tạo ra các phân đoạn. Sẽ rất hữu ích nếu những thứ như thông tin về thiết bị hoặc công trình cần được truy cập trong quá trình sharding.
Thông số | |
---|---|
shardCountHint | Integer : số lượng phân đoạn đã cố gắng. |
testInfo | TestInformation : TestInformation mẹ |
Lợi nhuận | |
---|---|
một bộ sưu tập các bài kiểm tra phụ sẽ được thực hiện riêng biệt hoặc null nếu kiểm tra hiện không thể phân mảnh được |
Các phương pháp được bảo vệ
createModuleListists
protectedcreateModuleListeners ()
Trả về danh sách ITestInvocationListener
áp dụng cho cấp ModuleListener
. Các trình lắng nghe này sẽ được sử dụng lại cho mỗi mô-đun, chúng sẽ không được khởi tạo lại vì vậy chúng không nên giả định trạng thái bên trong.
Lợi nhuận | |
---|---|
filterByConfigMetadata
protected 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ó chạy hay không.
Thông số | |
---|---|
config | IConfiguration : Cấu IConfiguration đang được đánh giá. |
include | MultiMap : bộ lọc bao gồm siêu dữ liệu |
exclude | MultiMap : bộ lọc loại trừ siêu dữ liệu |
Lợi nhuận | |
---|---|
boolean | Đúng nếu mô-đun sẽ chạy, nếu không thì sai. |
filterByRunnerType
protected boolean filterByRunnerType (IConfiguration config,allowedRunners)
Áp dụng bộ lọc danh sách cho phép của Người chạy, loại bỏ bất kỳ người chạy nào không có trong danh sách cho phép. Nếu cấu hình có nhiều trình chạy, một số có thể bị xóa và cấu hình vẫn chạy.
Thông số | |
---|---|
config | IConfiguration : Cấu IConfiguration đang được đánh giá. |
allowedRunners |
Lợi nhuận | |
---|---|
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 hỗ trợ bởi kiến trúc mục tiêu xây dựng Máy chủ. Phơi để thử nghiệm.
Lợi nhuận | |
---|---|
getHostAbis
protectedgetHostAbis ()
Trả về abis máy chủ.
Lợi nhuận | |
---|---|
setMultiDeviceStrategy
protected void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)
Thông số | |
---|---|
strategy | ITestSuite.MultiDeviceModuleStrategy |
shouldModuleRun
protected boolean shouldModuleRun (ModuleDefinition module)
Thông số | |
---|---|
module | ModuleDefinition |
Lợi nhuận | |
---|---|
boolean |
Nội dung và mã mẫu trên trang này phải tuân thủ các giấy phép như mô tả trong phần Giấy phép nội dung. Java và OpenJDK là nhãn hiệu hoặc nhãn hiệu đã đăng ký của Oracle và/hoặc đơn vị liên kết của Oracle.
Cập nhật lần gần đây nhất: 2022-11-07 UTC.