模組定義

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 ()

傳回與模組關聯的IInvocationContext

getRequiredTokens ( TestInformation testInfo)
long getRuntimeHint ()

返回運行模組中所有測試的大致時間。

boolean hasModuleFailed ()

如果已在模組上呼叫 testRunFailure,則傳回 True *

int neededDevices ()

傳回預計執行此測試的設備數量。

int numTests ()

傳回目前等待執行的IRemoteTest數量。

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)

運行模組中包含的所有IRemoteTest ,並使用之前和之後的所有準備器來設定和清理設備。

final void run ( TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, TestFailureListener failureListener) run ( TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, TestFailureListener failureListener)

運行模組中包含的所有IRemoteTest ,並使用之前和之後的所有準備器來設定和清理設備。

final void run ( TestInformation moduleInfo, ITestInvocationListener listener)

運行模組中包含的所有IRemoteTest ,並使用之前和之後的所有準備器來設定和清理設備。

Throwable runPreparation (boolean includeSuitePreparers)

運行測試的準備器,包括套件級準備器(如果指定)。

void setBuild ( IBuildInfo build)

注入要在測試期間使用的IBuildInfo

void setCollectTestsOnly (boolean collectTestsOnly)

啟用或停用測試收集模式

void setDevice ( ITestDevice device)

注入要在測試期間使用的ITestDevice

void setEnableDynamicDownload (boolean enableDynamicDownload)

是否在模組層級啟用動態下載。

void setLogSaver ( ILogSaver logSaver)

將呼叫日誌保存程式傳遞給模組,以便模組可以在必要時使用它。

final void setMergeAttemps (boolean mergeAttempts)

設定是否應該合併結果。

void setMetricCollectors ( collectors) setMetricCollectors ( collectors)

注入模組要使用的IMetricCollector清單。

void setRecoverVirtualDevice (boolean recoverVirtualDevice)

設定應該恢復虛擬設備。

final void setRetryDecision ( IRetryDecision decision)

設定用於模組內重試的IRetryDecision

boolean shouldRecoverVirtualDevice ()

返回我們是否應該恢復虛擬設備。

String toString ()

void transferSuiteLevelOptions ( IConfiguration mSuiteConfiguration)

複製一些套件層級的配置

受保護的方法

boolean hasTests ()

如果模組仍有IRemoteTest要在其池中運行,則傳回 True。

領域

隔離成本

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

公共方法

相比於

public int compareTo (ModuleDefinition moduleDef)

參數
moduleDef ModuleDefinition

退貨
int

取得ID

public String getId ()

傳回唯一的模組名稱。

退貨
String

取得模組配置

public IConfiguration getModuleConfiguration ()

退貨
IConfiguration

取得模組呼叫上下文

public IInvocationContext getModuleInvocationContext ()

傳回與模組關聯的IInvocationContext

退貨
IInvocationContext

取得所需令牌

public  getRequiredTokens (TestInformation testInfo)

參數
testInfo TestInformation

退貨

取得運行時提示

public long getRuntimeHint ()

返回運行模組中所有測試的大致時間。

退貨
long

模組失敗

public boolean hasModuleFailed ()

如果已在模組上呼叫 testRunFailure,則傳回 True *

退貨
boolean

所需設備

public int neededDevices ()

傳回預計執行此測試的設備數量。

退貨
int

測試次數

public int numTests ()

傳回目前等待執行的IRemoteTest數量。

退貨
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 ITestInvocationListenerITestInvocationListener報告結果的位置。

moduleLevelListeners :模組層級的偵聽器清單。

failureListener TestFailureListener :收集 testFail 日誌的特定偵聽器。可以為空。

maxRunLimit int :每個測試案例的最大運行次數。

投擲
DeviceNotAvailableException如果設備離線。

跑步

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener, 
                 moduleLevelListeners, 
                TestFailureListener failureListener)

運行模組中包含的所有IRemoteTest ,並使用之前和之後的所有準備器來設定和清理設備。

參數
moduleInfo TestInformation

listener ITestInvocationListenerITestInvocationListener報告結果的位置。

moduleLevelListeners :模組層級的偵聽器清單。

failureListener TestFailureListener :收集 testFail 日誌的特定偵聽器。可以為空。

投擲
DeviceNotAvailableException如果設備離線。

跑步

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener)

運行模組中包含的所有IRemoteTest ,並使用之前和之後的所有準備器來設定和清理設備。

參數
moduleInfo TestInformation

listener ITestInvocationListenerITestInvocationListener報告結果的位置。

投擲
DeviceNotAvailableException如果設備離線。

運行準備

public Throwable runPreparation (boolean includeSuitePreparers)

運行測試的準備器,包括套件級準備器(如果指定)。

參數
includeSuitePreparers boolean :設定為true也可以運行套件等級的準備器。

退貨
Throwable運作準備器時引發的任何異常Throwable

設定建置

public void setBuild (IBuildInfo build)

注入要在測試期間使用的IBuildInfo

參數
build IBuildInfo

僅設定收集測試

public void setCollectTestsOnly (boolean collectTestsOnly)

啟用或停用測試收集模式

設定設備

public void setDevice (ITestDevice device)

注入要在測試期間使用的ITestDevice

參數
device ITestDevice

設定啟用動態下載

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

受保護的方法

有測試

protected boolean hasTests ()

如果模組仍有IRemoteTest要在其池中運行,則傳回 True。否則為假。

退貨
boolean