ModuleDefinition

public class ModuleDefinition
extends Object implements 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 trợ giúp để 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, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig)

Hàm dựng

ModuleDefinition(String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig)

Hàm dựng

Phương thức công khai

int compareTo(ModuleDefinition moduleDef)

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()
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ả 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ả 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 các kiểm thử.

void setCollectTestsOnly(boolean collectTestsOnly)

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

void setDevice(ITestDevice device)

Chèn ITestDevice sẽ được dùng trong các 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ể sử 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( 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, 
                 tests, 
                 preparersPerDevice, 
                 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 : danh sách IRemoteTest cần chạy.

preparersPerDevice : danh sách ITargetPreparer sẽ được dùng để thiết lập thiết bị.

multiPreparers

moduleConfig IConfiguration: IConfiguration của cấu hình mô-đun cơ bản.

ModuleDefinition

public ModuleDefinition (String name, 
                 tests, 
                 preparersPerDevice, 
                 suitePreparersPerDevice, 
                 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 : danh sách IRemoteTest cần chạy.

preparersPerDevice : danh sách ITargetPreparer sẽ được dùng để thiết lập thiết bị.

suitePreparersPerDevice

multiPreparers

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

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  getRequiredTokens (TestInformation testInfo)

Tham số
testInfo TestInformation

Giá trị trả về

getRuntimeHint

public long getRuntimeHint ()

Trả về thời gian ước tính để chạy tất cả các 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ả 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ả 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 các kiểm thử.

Tham số
build IBuildInfo

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

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

setDevice

public void setDevice (ITestDevice device)

Chèn ITestDevice sẽ được dùng trong các 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ể sử 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 ( collectors)

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

Tham số
collectors

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