模組定義
public class ModuleDefinition
extends Object
implements ITestCollector
java.lang.Object | |
↳ | com.android.tradefed.testtype.suite.ModuleDefinition |
測試運行配置的容器。這個類別是準備和運行測試的助手。
概括
領域 | |
---|---|
public static final String | ISOLATION_COST |
public static final String | MODULE_ABI |
public static final String | MODULE_CACHED 如果測試模組結果已緩存,則此屬性設為 true。 |
public static final String | MODULE_CONTROLLER |
public static final String | MODULE_EXTERNAL_DEPENDENCIES |
public static final String | MODULE_ID 模組 ID 將在 testRunStart 期間用於唯一識別模組的名稱。 |
public static final String | MODULE_ISOLATED 如果模組在新準備的裝置上運行,則此屬性設為 true。 |
public static final String | MODULE_NAME 模組名稱是與模組關聯的基本名稱,通常來自載入模組的 Xml TF 設定檔。 |
public static final String | MODULE_PARAMETERIZATION |
public static final String | MODULE_TEST_COUNT |
public static final String | PREPARATION_TIME |
public static final String | RETRY_FAIL_COUNT |
public static final String | RETRY_SUCCESS_COUNT |
public static final String | RETRY_TIME |
public static final String | SPARSE_MODULE 如果僅報告模組級事件,則此屬性設為 true。 |
public static final String | TEAR_DOWN_TIME |
public static final String | TEST_TIME
|
公共構造函數 | |
---|---|
ModuleDefinition () | |
ModuleDefinition (String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig) ModuleDefinition (String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig) ModuleDefinition (String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig) ModuleDefinition (String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig) 建構函數 | |
ModuleDefinition (String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig) ModuleDefinition (String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig) ModuleDefinition (String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig) ModuleDefinition (String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig) ModuleDefinition (String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig) 建構函數 |
公共方法 | |
---|---|
int | compareTo ( ModuleDefinition moduleDef) |
String | getId () 傳回唯一的模組名稱。 |
IConfiguration | getModuleConfiguration () |
IInvocationContext | getModuleInvocationContext () 傳回與模組關聯的 |
getRequiredTokens ( TestInformation testInfo) | |
long | getRuntimeHint () 返回運行模組中所有測試的大致時間。 |
boolean | hasModuleFailed () 如果已在模組上呼叫 testRunFailure,則傳回 True * |
int | neededDevices () 傳回預計執行此測試的設備數量。 |
int | numTests () 傳回目前等待執行的 |
final void | reportNotExecuted ( ITestInvocationListener listener, String message) 完全報告未執行的模組。 |
final void | run ( TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, TestFailureListener failureListener, int maxRunLimit) run ( TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, TestFailureListener failureListener, int maxRunLimit) 運行模組中包含的所有 |
final void | run ( TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, TestFailureListener failureListener) run ( TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, TestFailureListener failureListener) 運行模組中包含的所有 |
final void | run ( TestInformation moduleInfo, ITestInvocationListener listener) 運行模組中包含的所有 |
Throwable | runPreparation (boolean includeSuitePreparers) 運行測試的準備器,包括套件級準備器(如果指定)。 |
void | setBuild ( IBuildInfo build) 注入要在測試期間使用的 |
void | setCollectTestsOnly (boolean collectTestsOnly) 啟用或停用測試收集模式 |
void | setDevice ( ITestDevice device) 注入要在測試期間使用的 |
void | setEnableDynamicDownload (boolean enableDynamicDownload) 是否在模組層級啟用動態下載。 |
void | setLogSaver ( ILogSaver logSaver) 將呼叫日誌保存程式傳遞給模組,以便模組可以在必要時使用它。 |
final void | setMergeAttemps (boolean mergeAttempts) 設定是否應該合併結果。 |
void | setMetricCollectors ( collectors) setMetricCollectors ( collectors) 注入模組要使用的 |
void | setRecoverVirtualDevice (boolean recoverVirtualDevice) 設定應該恢復虛擬設備。 |
final void | setRetryDecision ( IRetryDecision decision) 設定用於模組內重試的 |
boolean | shouldRecoverVirtualDevice () 返回我們是否應該恢復虛擬設備。 |
String | toString () |
void | transferSuiteLevelOptions ( IConfiguration mSuiteConfiguration) 複製一些套件層級的配置 |
受保護的方法 | |
---|---|
boolean | hasTests () 如果模組仍有 |
領域
隔離成本
public static final String ISOLATION_COST
模組_ABI
public static final String MODULE_ABI
模組_緩存
public static final String MODULE_CACHED
如果測試模組結果已緩存,則此屬性設為 true。
模組控制器
public static final String MODULE_CONTROLLER
MODULE_EXTERNAL_DEPENDENCIES
public static final String MODULE_EXTERNAL_DEPENDENCIES
模組ID
public static final String MODULE_ID
模組 ID 將在 testRunStart 期間用於唯一識別模組的名稱。它通常是 MODULE_ABI + MODULE_NAME 的組合。
模組_隔離
public static final String MODULE_ISOLATED
如果模組在新準備的裝置上運行,則此屬性設為 true。
模組名稱
public static final String MODULE_NAME
模組名稱是與模組關聯的基本名稱,通常來自載入模組的 Xml TF 設定檔。
模組參數化
public static final String MODULE_PARAMETERIZATION
MODULE_TEST_COUNT
public static final String MODULE_TEST_COUNT
準備時間
public static final String PREPARATION_TIME
重試失敗次數
public static final String RETRY_FAIL_COUNT
RETRY_SUCCESS_COUNT 次
public static final String RETRY_SUCCESS_COUNT
重試時間
public static final String RETRY_TIME
稀疏模組
public static final String SPARSE_MODULE
如果僅報告模組級事件,則此屬性設為 true。
TEAR_DOWN_TIME
public static final String TEAR_DOWN_TIME
測試時間
public static final String TEST_TIME
公共構造函數
模組定義
public ModuleDefinition ()
模組定義
public ModuleDefinition (String name,tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig)
建構函數
參數 | |
---|---|
name | String :測試配置的唯一名稱。 |
tests | IRemoteTest 列表。 |
preparersPerDevice | ITargetPreparer 清單。 |
multiPreparers | |
moduleConfig | IConfiguration :底層模組配置的IConfiguration 。 |
模組定義
public ModuleDefinition (String name,tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig)
建構函數
參數 | |
---|---|
name | String :測試配置的唯一名稱。 |
tests | IRemoteTest 列表。 |
preparersPerDevice | ITargetPreparer 清單。 |
suitePreparersPerDevice | |
multiPreparers | |
moduleConfig | IConfiguration :底層模組配置的IConfiguration 。 |
公共方法
取得ID
public String getId ()
傳回唯一的模組名稱。
退貨 | |
---|---|
String |
取得模組呼叫上下文
public IInvocationContext getModuleInvocationContext ()
傳回與模組關聯的IInvocationContext
。
退貨 | |
---|---|
IInvocationContext |
取得運行時提示
public long getRuntimeHint ()
返回運行模組中所有測試的大致時間。
退貨 | |
---|---|
long |
模組失敗
public boolean hasModuleFailed ()
如果已在模組上呼叫 testRunFailure,則傳回 True *
退貨 | |
---|---|
boolean |
所需設備
public int neededDevices ()
傳回預計執行此測試的設備數量。
退貨 | |
---|---|
int |
報告未執行
public final void reportNotExecuted (ITestInvocationListener listener, String message)
完全報告未執行的模組。
參數 | |
---|---|
listener | ITestInvocationListener |
message | String |
跑步
public final void run (TestInformation moduleInfo, ITestInvocationListener listener,moduleLevelListeners, TestFailureListener failureListener, int maxRunLimit)
運行模組中包含的所有IRemoteTest
,並使用之前和之後的所有準備器來設定和清理設備。
參數 | |
---|---|
moduleInfo | TestInformation :模組的TestInformation 。 |
listener | ITestInvocationListener : ITestInvocationListener 報告結果的位置。 |
moduleLevelListeners | |
failureListener | TestFailureListener :收集 testFail 日誌的特定偵聽器。可以為空。 |
maxRunLimit | int :每個測試案例的最大運行次數。 |
投擲 | |
---|---|
DeviceNotAvailableException | 如果設備離線。 |
跑步
public final void run (TestInformation moduleInfo, ITestInvocationListener listener,moduleLevelListeners, TestFailureListener failureListener)
運行模組中包含的所有IRemoteTest
,並使用之前和之後的所有準備器來設定和清理設備。
參數 | |
---|---|
moduleInfo | TestInformation |
listener | ITestInvocationListener : ITestInvocationListener 報告結果的位置。 |
moduleLevelListeners | |
failureListener | TestFailureListener :收集 testFail 日誌的特定偵聽器。可以為空。 |
投擲 | |
---|---|
DeviceNotAvailableException | 如果設備離線。 |
跑步
public final void run (TestInformation moduleInfo, ITestInvocationListener listener)
運行模組中包含的所有IRemoteTest
,並使用之前和之後的所有準備器來設定和清理設備。
參數 | |
---|---|
moduleInfo | TestInformation |
listener | ITestInvocationListener : ITestInvocationListener 報告結果的位置。 |
投擲 | |
---|---|
DeviceNotAvailableException | 如果設備離線。 |
運行準備
public Throwable runPreparation (boolean includeSuitePreparers)
運行測試的準備器,包括套件級準備器(如果指定)。
參數 | |
---|---|
includeSuitePreparers | boolean :設定為true 也可以運行套件等級的準備器。 |
退貨 | |
---|---|
Throwable | 運作準備器時引發的任何異常Throwable 。 |
僅設定收集測試
public void setCollectTestsOnly (boolean collectTestsOnly)
啟用或停用測試收集模式
設定啟用動態下載
public void setEnableDynamicDownload (boolean enableDynamicDownload)
是否在模組層級啟用動態下載。
參數 | |
---|---|
enableDynamicDownload | boolean |
設定日誌保存程序
public void setLogSaver (ILogSaver logSaver)
將呼叫日誌保存程式傳遞給模組,以便模組可以在必要時使用它。
參數 | |
---|---|
logSaver | ILogSaver |
設定合併嘗試
public final void setMergeAttemps (boolean mergeAttempts)
設定是否應該合併結果。
參數 | |
---|---|
mergeAttempts | boolean |
設定MetricCollectors
public void setMetricCollectors (collectors)
注入模組要使用的IMetricCollector
清單。
參數 | |
---|---|
collectors |
設定恢復虛擬設備
public void setRecoverVirtualDevice (boolean recoverVirtualDevice)
設定應該恢復虛擬設備。
參數 | |
---|---|
recoverVirtualDevice | boolean |
設定重試決策
public final void setRetryDecision (IRetryDecision decision)
設定用於模組內重試的IRetryDecision
。
參數 | |
---|---|
decision | IRetryDecision |
應該恢復虛擬設備
public boolean shouldRecoverVirtualDevice ()
返回我們是否應該恢復虛擬設備。
退貨 | |
---|---|
boolean |
到字串
public String toString ()
退貨 | |
---|---|
String |
傳輸套件等級選項
public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)
複製一些套件層級的配置
參數 | |
---|---|
mSuiteConfiguration | IConfiguration |