ModuleDefinition

public class ModuleDefinition
extends Object implements Comparable<ModuleDefinition>, ITestCollector

java.lang.Object
↳	com.android.tradefed.testtype.suite.ModuleDefinition

---

Vùng chứa cho cấu hình chạy thử nghiệm. Lớp này là một lớp hỗ trợ để chuẩn bị và chạy các kiểm thử.

Tóm tắt

Hằng số
String	ISOLATION_COST
String	MODULE_ABI
String	MODULE_CACHED Thuộc tính này được đặt thành true nếu kết quả của mô-đun kiểm thử được lưu vào bộ nhớ đệm.
String	MODULE_CONTROLLER
String	MODULE_EXTERNAL_DEPENDENCIES
String	MODULE_ID Mã nhận dạng mô-đun là tên sẽ được dùng để xác định riêng từng mô-đun trong quá trình testRunStart.
String	MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY
String	MODULE_ISOLATED Thuộc tính này được đặt thành true nếu mô-đun đang chạy trên một thiết bị mới chuẩn bị.
String	MODULE_NAME Tên mô-đun là tên cơ sở được liên kết với mô-đun, thường lấy từ tệp cấu hình Xml TF mà mô-đun được tải.
String	MODULE_PARAMETERIZATION
String	MODULE_SKIPPED Thuộc tính này được đặt thành true nếu mô-đun kiểm thử bị bỏ qua
String	MODULE_TEST_COUNT
String	PREPARATION_TIME
String	RETRY_FAIL_COUNT
String	RETRY_SUCCESS_COUNT
String	RETRY_TIME
String	SPARSE_MODULE Thuộc tính này được đặt thành true nếu chỉ các sự kiện ở cấp mô-đun được báo cáo.
String	TEAR_DOWN_TIME
String	TEST_TIME

Hàm khởi tạo công khai
ModuleDefinition()
ModuleDefinition(String name, Collection<IRemoteTest> tests, Map<String, List<ITargetPreparer>> preparersPerDevice, List<IMultiTargetPreparer> multiPreparers, IConfiguration moduleConfig) Hàm dựng
ModuleDefinition(String name, Collection<IRemoteTest> tests, Map<String, List<ITargetPreparer>> preparersPerDevice, Map<String, List<ITargetPreparer>> suitePreparersPerDevice, List<IMultiTargetPreparer> multiPreparers, IConfiguration moduleConfig) Hàm dựng

Phương thức công khai
int	compareTo(ModuleDefinition moduleDef)
Set<Digest>	getFilterDigests() Trả về các bản tóm tắt của bộ lọc được liên kết với các kiểm thử.
String	getId() Trả về tên mô-đun riêng biệt.
Integer	getIntraModuleShardCount()
Integer	getIntraModuleShardIndex()
IConfiguration	getModuleConfiguration()
IInvocationContext	getModuleInvocationContext() Trả về IInvocationContext được liên kết với mô-đun.
TestInformation	getModuleTestInformation()
Set<TokenProperty>	getRequiredTokens(TestInformation testInfo)
long	getRuntimeHint() Trả về thời gian ước tính để chạy tất cả các bài kiểm thử trong mô-đun.
boolean	hasModuleFailed() Trả về True nếu testRunFailure đã được gọi trên mô-đun *
int	neededDevices() Trả về số lượng thiết bị dự kiến sẽ chạy thử nghiệm này.
int	numTests() Trả về số lượng IRemoteTest hiện tại đang chờ được thực thi.
final void	reportNotExecuted(ITestInvocationListener listener, String message) Báo cáo các mô-đun chưa được thực thi hoàn toàn.
final void	run(TestInformation moduleInfo, ITestInvocationListener listener, int maxRunLimit) Chạy tất cả IRemoteTest có trong mô-đun và sử dụng tất cả các trình chuẩn bị trước và sau để thiết lập cũng như dọn dẹp thiết bị.
final void	run(TestInformation moduleInfo, ITestInvocationListener listener) Chạy tất cả IRemoteTest có trong mô-đun và sử dụng tất cả các trình chuẩn bị trước và sau để thiết lập cũng như dọn dẹp thiết bị.
Throwable	runPreparation(boolean includeSuitePreparers) Chạy các trình chuẩn bị của kiểm thử, bao gồm cả trình chuẩn bị ở cấp bộ nếu được chỉ định.
void	setBuild(IBuildInfo build) Chèn IBuildInfo sẽ được dùng trong quá trình kiểm thử.
void	setCollectKernelLog(boolean collectKernelLog)
void	setCollectTestsOnly(boolean collectTestsOnly) Bật hoặc tắt chế độ thu thập dữ liệu thử nghiệm
void	setDefaultLogCollectors(List<IMetricCollector> collectors)
void	setDevice(ITestDevice device) Chèn ITestDevice sẽ được dùng trong quá trình kiểm thử.
void	setEnableDynamicDownload(boolean enableDynamicDownload) Có bật tính năng tải xuống linh hoạt ở cấp mô-đun hay không.
void	setIntraModuleInformation(int shardCount, int shardIndex)
void	setLogSaver(ILogSaver logSaver) Truyền trình lưu nhật ký lệnh gọi đến mô-đun để mô-đun có thể dùng trình lưu này nếu cần.
final void	setMergeAttemps(boolean mergeAttempts) Đặt xem chúng ta có nên hợp nhất kết quả hay không.
void	setMetricCollectors(List<IMetricCollector> collectors) Chèn Danh sách IMetricCollector mà mô-đun sẽ dùng.
void	setRecoverVirtualDevice(boolean recoverVirtualDevice) Các tập hợp sẽ khôi phục thiết bị ảo.
void	setRemoveModuleBuffering(boolean removeModuleBuffering)
void	setReportModuleEnd(boolean shouldReportModuleEnd)
void	setReportModuleStart(boolean shouldReportModuleStart)
final void	setRetryDecision(IRetryDecision decision) Đặt IRetryDecision sẽ được dùng cho hoạt động thử lại trong mô-đun.
void	setUseModuleResultsForwarder(boolean useModuleResultsForwarder)
boolean	shouldRecoverVirtualDevice() Trả về nếu chúng ta nên khôi phục thiết bị ảo.
String	toString()
void	transferSuiteLevelOptions(IConfiguration mSuiteConfiguration) Sao chép một số cấu hình ở cấp bộ

Phương thức được bảo vệ
boolean	hasTests() Trả về True nếu Mô-đun vẫn còn IRemoteTest để chạy trong nhóm của mô-đun.

Hằng số

ISOLATION_COST

public static final String ISOLATION_COST

Giá trị không đổi: "ISOLATION_COST"

MODULE_ABI

public static final String MODULE_ABI

Giá trị không đổi: "module-abi"

MODULE_CACHED

public static final String MODULE_CACHED

Thuộc tính này được đặt thành true nếu kết quả của mô-đun kiểm thử được lưu vào bộ nhớ đệm.

Giá trị không đổi: "module-cached"

MODULE_CONTROLLER

public static final String MODULE_CONTROLLER

Giá trị không đổi: "module_controller"

MODULE_EXTERNAL_DEPENDENCIES

public static final String MODULE_EXTERNAL_DEPENDENCIES

Giá trị không đổi: "module-external-dependencies"

MODULE_ID

public static final String MODULE_ID

Mã nhận dạng mô-đun là tên sẽ được dùng để xác định riêng từng mô-đun trong quá trình testRunStart. Đây thường là sự kết hợp của MODULE_ABI + MODULE_NAME.

Giá trị không đổi: "module-id"

MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

public static final String MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

Giá trị không đổi: "module-flag-overrides"

MODULE_ISOLATED

public static final String MODULE_ISOLATED

Thuộc tính này được đặt thành true nếu mô-đun đang chạy trên một thiết bị mới chuẩn bị.

Giá trị không đổi: "module-isolated"

MODULE_NAME

public static final String MODULE_NAME

Tên mô-đun là tên cơ sở được liên kết với mô-đun, thường lấy từ tệp cấu hình Xml TF mà mô-đun được tải.

Giá trị không đổi: "module-name"

MODULE_PARAMETERIZATION

public static final String MODULE_PARAMETERIZATION

Giá trị không đổi: "module-param"

MODULE_SKIPPED

public static final String MODULE_SKIPPED

Thuộc tính này được đặt thành true nếu mô-đun kiểm thử bị bỏ qua

Giá trị không đổi: "module-skipped"

MODULE_TEST_COUNT

public static final String MODULE_TEST_COUNT

Giá trị không đổi: "MODULE_TEST_COUNT"

PREPARATION_TIME

public static final String PREPARATION_TIME

Giá trị không đổi: "PREP_TIME"

RETRY_FAIL_COUNT

public static final String RETRY_FAIL_COUNT

Giá trị không đổi: "MODULE_RETRY_FAILED"

RETRY_SUCCESS_COUNT

public static final String RETRY_SUCCESS_COUNT

Giá trị không đổi: "MODULE_RETRY_SUCCESS"

RETRY_TIME

public static final String RETRY_TIME

Giá trị không đổi: "MODULE_RETRY_TIME"

SPARSE_MODULE

public static final String SPARSE_MODULE

Thuộc tính này được đặt thành true nếu chỉ các sự kiện ở cấp mô-đun được báo cáo.

Giá trị không đổi: "sparse-module"

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

Giá trị không đổi: "TEARDOWN_TIME"

TEST_TIME

public static final String TEST_TIME

Giá trị không đổi: "TEST_TIME"

Hàm khởi tạo công khai

ModuleDefinition

public ModuleDefinition ()

ModuleDefinition

public ModuleDefinition (String name, 
                Collection<IRemoteTest> tests, 
                Map<String, List<ITargetPreparer>> preparersPerDevice, 
                List<IMultiTargetPreparer> multiPreparers, 
                IConfiguration moduleConfig)

Hàm dựng

Tham số
name	String: tên duy nhất của cấu hình kiểm thử.
tests	Collection: danh sách IRemoteTest cần chạy.
preparersPerDevice	Map: danh sách ITargetPreparer sẽ được dùng để thiết lập thiết bị.
multiPreparers	List
moduleConfig	IConfiguration: IConfiguration của cấu hình mô-đun cơ bản.

ModuleDefinition

public ModuleDefinition (String name, 
                Collection<IRemoteTest> tests, 
                Map<String, List<ITargetPreparer>> preparersPerDevice, 
                Map<String, List<ITargetPreparer>> suitePreparersPerDevice, 
                List<IMultiTargetPreparer> multiPreparers, 
                IConfiguration moduleConfig)

Hàm dựng

Tham số
name	String: tên duy nhất của cấu hình kiểm thử.
tests	Collection: danh sách IRemoteTest cần chạy.
preparersPerDevice	Map: danh sách ITargetPreparer sẽ được dùng để thiết lập thiết bị.
suitePreparersPerDevice	Map
multiPreparers	List
moduleConfig	IConfiguration: IConfiguration của cấu hình mô-đun cơ bản.

Phương thức công khai

compareTo

public int compareTo (ModuleDefinition moduleDef)

Tham số
moduleDef	ModuleDefinition

Giá trị trả về
int

getFilterDigests

public Set<Digest> getFilterDigests ()

Trả về các bản tóm tắt của bộ lọc được liên kết với các kiểm thử.

Giá trị trả về
Set<Digest>

Gửi
IOException

getId

public String getId ()

Trả về tên mô-đun riêng biệt.

Giá trị trả về
String

getIntraModuleShardCount

public Integer getIntraModuleShardCount ()

Giá trị trả về
Integer

getIntraModuleShardIndex

public Integer getIntraModuleShardIndex ()

Giá trị trả về
Integer

getModuleConfiguration

public IConfiguration getModuleConfiguration ()

Giá trị trả về
IConfiguration

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

Trả về IInvocationContext được liên kết với mô-đun.

Giá trị trả về
IInvocationContext

getModuleTestInformation

public TestInformation getModuleTestInformation ()

Giá trị trả về
TestInformation

getRequiredTokens

public Set<TokenProperty> getRequiredTokens (TestInformation testInfo)

Tham số
testInfo	TestInformation

Giá trị trả về
Set<TokenProperty>

getRuntimeHint

public long getRuntimeHint ()

Trả về thời gian ước tính để chạy tất cả các bài kiểm thử trong mô-đun.

Giá trị trả về
long

hasModuleFailed

public boolean hasModuleFailed ()

Trả về True nếu testRunFailure đã được gọi trên mô-đun *

Giá trị trả về
boolean

neededDevices

public int neededDevices ()

Trả về số lượng thiết bị dự kiến sẽ chạy thử nghiệm này.

Giá trị trả về
int

numTests

public int numTests ()

Trả về số lượng IRemoteTest hiện tại đang chờ được thực thi.

Giá trị trả về
int

reportNotExecuted

public final void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Báo cáo các mô-đun chưa được thực thi hoàn toàn.

Tham số
listener	ITestInvocationListener
message	String

chạy

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener, 
                int maxRunLimit)

Chạy tất cả IRemoteTest có trong mô-đun và sử dụng tất cả các trình chuẩn bị trước và sau để thiết lập cũng như dọn dẹp thiết bị.

Tham số
moduleInfo	TestInformation: TestInformation cho mô-đun.
listener	ITestInvocationListener: ITestInvocationListener nơi báo cáo kết quả.
maxRunLimit	int: số lần chạy tối đa cho mỗi trường hợp kiểm thử.

Gửi
DeviceNotAvailableException	trong trường hợp thiết bị không có kết nối mạng.

chạy

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener)

Chạy tất cả IRemoteTest có trong mô-đun và sử dụng tất cả các trình chuẩn bị trước và sau để thiết lập cũng như dọn dẹp thiết bị.

Tham số
moduleInfo	TestInformation
listener	ITestInvocationListener: ITestInvocationListener nơi báo cáo kết quả.

Gửi
DeviceNotAvailableException	trong trường hợp thiết bị không có kết nối mạng.

runPreparation

public Throwable runPreparation (boolean includeSuitePreparers)

Chạy các trình chuẩn bị của kiểm thử, bao gồm cả trình chuẩn bị ở cấp bộ nếu được chỉ định.

Tham số
includeSuitePreparers	boolean: Đặt thành true để chạy cả trình chuẩn bị cấp bộ.

Giá trị trả về
Throwable	Throwable của mọi ngoại lệ phát sinh khi chạy trình chuẩn bị.

setBuild

public void setBuild (IBuildInfo build)

Chèn IBuildInfo sẽ được dùng trong quá trình kiểm thử.

Tham số
build	IBuildInfo

setCollectKernelLog

public void setCollectKernelLog (boolean collectKernelLog)

Tham số
collectKernelLog	boolean

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

Bật hoặc tắt chế độ thu thập dữ liệu thử nghiệm

setDefaultLogCollectors

public void setDefaultLogCollectors (List<IMetricCollector> collectors)

Tham số
collectors	List

setDevice

public void setDevice (ITestDevice device)

Chèn ITestDevice sẽ được dùng trong quá trình kiểm thử.

Tham số
device	ITestDevice

setEnableDynamicDownload

public void setEnableDynamicDownload (boolean enableDynamicDownload)

Có bật tính năng tải xuống linh hoạt ở cấp mô-đun hay không.

Tham số
enableDynamicDownload	boolean

setIntraModuleInformation

public void setIntraModuleInformation (int shardCount, 
                int shardIndex)

Tham số
shardCount	int
shardIndex	int

setLogSaver

public void setLogSaver (ILogSaver logSaver)

Truyền trình lưu nhật ký lệnh gọi đến mô-đun để mô-đun có thể dùng trình lưu này nếu cần.

Tham số
logSaver	ILogSaver

setMergeAttemps

public final void setMergeAttemps (boolean mergeAttempts)

Đặt xem chúng ta có nên hợp nhất kết quả hay không.

Tham số
mergeAttempts	boolean

setMetricCollectors

public void setMetricCollectors (List<IMetricCollector> collectors)

Chèn Danh sách IMetricCollector mà mô-đun sẽ dùng.

Tham số
collectors	List

setRecoverVirtualDevice

public void setRecoverVirtualDevice (boolean recoverVirtualDevice)

Các tập hợp sẽ khôi phục thiết bị ảo.

Tham số
recoverVirtualDevice	boolean

setRemoveModuleBuffering

public void setRemoveModuleBuffering (boolean removeModuleBuffering)

Tham số
removeModuleBuffering	boolean

setReportModuleEnd

public void setReportModuleEnd (boolean shouldReportModuleEnd)

Tham số
shouldReportModuleEnd	boolean

setReportModuleStart

public void setReportModuleStart (boolean shouldReportModuleStart)

Tham số
shouldReportModuleStart	boolean

setRetryDecision

public final void setRetryDecision (IRetryDecision decision)

Đặt IRetryDecision sẽ được dùng cho hoạt động thử lại trong mô-đun.

Tham số
decision	IRetryDecision

setUseModuleResultsForwarder

public void setUseModuleResultsForwarder (boolean useModuleResultsForwarder)

Tham số
useModuleResultsForwarder	boolean

shouldRecoverVirtualDevice

public boolean shouldRecoverVirtualDevice ()

Trả về nếu chúng ta nên khôi phục thiết bị ảo.

Giá trị trả về
boolean

toString

public String toString ()

Giá trị trả về
String

transferSuiteLevelOptions

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

Sao chép một số cấu hình ở cấp bộ

Tham số
mSuiteConfiguration	IConfiguration

Phương thức được bảo vệ

hasTests

protected boolean hasTests ()

Trả về True nếu Mô-đun vẫn còn IRemoteTest để chạy trong nhóm của mô-đun. Nếu không thì trả về giá trị false.

Giá trị trả về
boolean