模塊定義

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_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 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列表。

final void setRetryDecision ( IRetryDecision decision)

設置用於模塊內重試的IRetryDecision

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_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

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 final void setRetryDecision (IRetryDecision decision)

設置用於模塊內重試的IRetryDecision

參數
decision IRetryDecision

到字符串

public String toString ()

退貨
String

傳輸套件級別選項

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

複製一些套件級別的配置

參數
mSuiteConfiguration IConfiguration

受保護的方法

有測試

protected boolean hasTests ()

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

退貨
boolean