模塊定義

public class ModuleDefinition
extends Object implements ITestCollector

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


測試運行配置的容器。這個類是準備和運行測試的助手。

概括

字段

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

Module 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。

字段

MODULE_ABI

public static final String MODULE_ABI

MODULE_CONTROLLER

public static final String MODULE_CONTROLLER

MODULE_EXTERNAL_DEPENDENCIES

public static final String MODULE_EXTERNAL_DEPENDENCIES

MODULE_ID

public static final String MODULE_ID

Module ID 將用於在 testRunStart 期間唯一標識模塊的名稱。它通常是 MODULE_ABI + MODULE_NAME 的組合。

MODULE_ISOLATED

public static final String MODULE_ISOLATED

如果模塊在新準備的設備上運行,則此屬性設置為 true。

MODULE_NAME

public static final String MODULE_NAME

模塊名稱是與模塊關聯的基本名稱,通常來自加載模塊的 Xml TF 配置文件。

MODULE_PARAMETERIZATION

public static final String MODULE_PARAMETERIZATION

MODULE_TEST_COUNT 個

public static final String MODULE_TEST_COUNT

準備時間

public static final String PREPARATION_TIME

RETRY_FAIL_COUNT

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

TEST_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

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

返回與模塊關聯的IInvocationContext

退貨
IInvocationContext

getRequiredTokens

public  getRequiredTokens (TestInformation testInfo)

參數
testInfo TestInformation

退貨

獲取運行時提示

public long getRuntimeHint ()

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

退貨
long

hasModuleFailed

public boolean hasModuleFailed ()

如果在模塊上調用了 testRunFailure,則返回 True *

退貨
boolean

需要的設備

public int neededDevices ()

返回預期運行此測試的設備數量。

退貨
int

numTests

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 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 setBuild (IBuildInfo build)

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

參數
build IBuildInfo

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

啟用或禁用測試收集模式

設置設備

public void setDevice (ITestDevice device)

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

參數
device ITestDevice

setEnableDynamic 下載

public void setEnableDynamicDownload (boolean enableDynamicDownload)

是否在模塊級別啟用動態下載。

參數
enableDynamicDownload boolean

設置日誌保護程序

public void setLogSaver (ILogSaver logSaver)

將調用日誌保存程序傳遞給模塊,以便它可以在必要時使用它。

參數
logSaver ILogSaver

setMergeAttemps

public final void setMergeAttemps (boolean mergeAttempts)

設置我們是否應該合併結果。

參數
mergeAttempts boolean

setMetricCollectors

public void setMetricCollectors ( collectors)

注入模塊要使用的IMetricCollector列表。

參數
collectors

設置重試決策

public final void setRetryDecision (IRetryDecision decision)

設置IRetryDecision用於模塊內重試。

參數
decision IRetryDecision

到字符串

public String toString ()

退貨
String

transferSuiteLevelOptions

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

複製一些套件級別的配置

參數
mSuiteConfiguration IConfiguration

受保護的方法

hasTests

protected boolean hasTests ()

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

退貨
boolean