Google致力於提高黑人社區的種族平等。 怎麼看。
本頁面由 Cloud Translation API 翻譯而成。
Switch to English

ITestSuite

public abstract class ITestSuite
extends Object implements IRemoteTest , IDeviceTest , IMultiDeviceTest , IBuildReceiver , ISystemStatusCheckerReceiver , IShardableTest , ITestCollector , IInvocationContextReceiver , IRuntimeHintProvider , IMetricCollectorReceiver , IConfigurationReceiver , IReportNotExecuted , ITokenRequest

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


用於運行測試套件的抽像類。此類提供了套件如何運行的基礎。每個實現都可以通過loadTests()方法定義測試列表。

摘要

嵌套類

enum ITestSuite.RetryStrategy

重新運行某些測試時要使用的重試策略。

領域

public static final String ABI_OPTION

public static final String MODULE_CHECKER_POST

public static final String MODULE_CHECKER_PRE

public static final String MODULE_METADATA_EXCLUDE_FILTER

public static final String MODULE_METADATA_INCLUDE_FILTER

public static final String PARAMETER_KEY

public static final String PREPARER_WHITELIST

public static final String PRIMARY_ABI_RUN

public static final String RUNNER_WHITELIST

public static final String SKIP_HOST_ARCH_CHECK

public static final String SKIP_SYSTEM_STATUS_CHECKER

public static final String TOKEN_KEY

公共建設者

ITestSuite ()

公開方法

void addModuleMetadataExcludeFilters ( MultiMap <String, String> filters)
void addModuleMetadataIncludeFilters ( MultiMap <String, String> filters)
getAbis ( ITestDevice device)

獲取兼容性測試AbiUtils#getAbisSupportedByCompatibility()和被測設備支持的ABI集。

IBuildInfo getBuildInfo ()

ITestSuite實現可能需要構建信息才能加載測試。

ITestDevice getDevice ()

獲取被測設備。

ModuleDefinition getDirectModule ()

返回要直接執行的ModuleDefinition ,如果尚未執行,則返回null(當尚未拆分ITestSuite時)。

final String getRequestedAbi ()

返回帶有選項-a或--abi的abi。

getRequiredTokens ()

返回測試所需的令牌列表。

long getRuntimeHint ()

返回測試的預期運行時間(以毫秒為單位)。

abstract loadTests ()

加載將要運行的測試配置的抽象方法。

void reportNotExecuted ( ITestInvocationListener listener, String message)

向提供的主偵聽器報告未執行的測試。

void reportNotExecuted ( ITestInvocationListener listener)

向提供的主偵聽器報告未執行的測試。

final void run ( ITestInvocationListener listener)

loadTests()加載的所有測試的通用運行方法。

void setAbiName (String abiName)

設置mAbiName的值

void setBuild ( IBuildInfo buildInfo)

void setCollectTestsOnly (boolean shouldCollectTest)

在僅收集器模式下運行測試套件,這也要求所有子測試也要實現此接口。

void setConfiguration ( IConfiguration configuration)

注入正在使用的IConfiguration

void setDevice ( ITestDevice device)

注入被測設備。

void setDeviceInfos ( deviceInfos) setDeviceInfos ( deviceInfos)

void setInvocationContext ( IInvocationContext invocationContext)

void setInvocationInjector (Injector injector)

從調用中獲取當前的Guice Injector

final void setMaxRunLimit (int maxRunLimit)

設置每個模塊的最大嘗試運行次數。

void setMetricCollectors ( collectors) setMetricCollectors ( collectors)

設置為測試運行定義的IMetricCollector的列表。

void setPrimaryAbiRun (boolean primaryAbiRun)

設置mPrimaryAbiRun的值

void setShouldMakeDynamicModule (boolean dynamicModule)

在進行分佈式分片時,我們不能擁有在池中共享測試的ModuleDefinition,否則模塊內分片將無法工作,因此我們可以禁用它。

void setSystemStatusChecker ( systemCheckers) setSystemStatusChecker ( systemCheckers)

從測試的配置設置ISystemStatusChecker

split (int shardCountHint)

split()替代版本,它也提供嘗試運行的shardCount。

受保護的方法

createModuleListeners ()

返回適用於ModuleListener級別的ITestInvocationListener的列表。

boolean filterByConfigMetadata ( IConfiguration config, MultiMap <String, String> include, MultiMap <String, String> exclude)

將元數據過濾器應用於配置,並查看配置是否應運行。

boolean filterByRunnerType ( IConfiguration config, allowedRunners) filterByRunnerType ( IConfiguration config, allowedRunners)

應用“跑步者”白名單過濾,刪除所有未列入白名單的跑步者。

getAbisForBuildTargetArch ()

返回主機構建目標體系結構支持的abis。

getHostAbis ()

返回主機abis。

領域

ABI_OPTION

public static final String ABI_OPTION

MODULE_CHECKER_POST

public static final String MODULE_CHECKER_POST

MODULE_CHECKER_PRE

public static final String MODULE_CHECKER_PRE

MODULE_METADATA_EXCLUDE_FILTER

public static final String MODULE_METADATA_EXCLUDE_FILTER

MODULE_METADATA_INCLUDE_FILTER

public static final String MODULE_METADATA_INCLUDE_FILTER

PARAMETER_KEY

public static final String PARAMETER_KEY

PREPARER_WHITELIST

public static final String PREPARER_WHITELIST

PRIMARY_ABI_RUN

public static final String PRIMARY_ABI_RUN

RUNNER_WHITELIST

public static final String RUNNER_WHITELIST

SKIP_HOST_ARCH_CHECK

public static final String SKIP_HOST_ARCH_CHECK

SKIP_SYSTEM_STATUS_CHECKER

public static final String SKIP_SYSTEM_STATUS_CHECKER

TOKEN_KEY

public static final String TOKEN_KEY

公共建設者

ITestSuite

public ITestSuite ()

公開方法

addModuleMetadataExcludeFilters

public void addModuleMetadataExcludeFilters ( MultiMap <String, String> filters)

參量
filters MultiMap

addModuleMetadataIncludeFilters

public void addModuleMetadataIncludeFilters ( MultiMap <String, String> filters)

參量
filters MultiMap

getAbis

public  getAbis ( ITestDevice device)

獲取兼容性測試AbiUtils#getAbisSupportedByCompatibility()和被測設備支持的ABI集。

參量
device ITestDevice

退貨
在其上運行測試的一組ABI

投擲
DeviceNotAvailableException

getBuildInfo

public IBuildInfo getBuildInfo ()

ITestSuite實現可能需要構建信息才能加載測試。

退貨
IBuildInfo

getDevice

public ITestDevice getDevice ()

獲取被測設備。

退貨
ITestDevice ITestDevice

getDirectModule

public ModuleDefinition getDirectModule ()

返回要直接執行的ModuleDefinition ,如果尚未執行,則返回null(當尚未拆分ITestSuite時)。

退貨
ModuleDefinition

getRequestedAbi

public final String getRequestedAbi ()

返回帶有選項-a或--abi的abi。

退貨
String

getRequiredTokens

public  getRequiredTokens ()

返回測試所需的令牌列表。如果沒有令牌支持,則返回null。

退貨

getRuntimeHint

public long getRuntimeHint ()

返回測試的預期運行時間(以毫秒為單位)。該時間用於平衡分片執行的負載

退貨
long

loadTests

public abstract  loadTests ()

加載將要運行的測試配置的抽象方法。每個測試都由一個IConfiguration和一個唯一的名稱定義,該名稱將用來報告結果。

退貨

reportNotExecuted

public void reportNotExecuted ( ITestInvocationListener listener, 
                String message)

向提供的主偵聽器報告未執行的測試。應通過NOT_EXECUTED_FAILURE消息將其報告為失敗。

參量
listener ITestInvocationListener :報告未執行結果的主要偵聽器。

message String :與未執行的失敗相關聯的消息。

reportNotExecuted

public void reportNotExecuted ( ITestInvocationListener listener)

向提供的主偵聽器報告未執行的測試。應通過NOT_EXECUTED_FAILURE消息將其報告為失敗。

參量
listener ITestInvocationListener :報告未執行結果的主要偵聽器。

public final void run ( ITestInvocationListener listener)

loadTests()加載的所有測試的通用運行方法。

參量
listener ITestInvocationListener :測試結果的ITestInvocationListener

投擲
DeviceNotAvailableException

setAbiName

public void setAbiName (String abiName)

設置mAbiName的值

參量
abiName String

setBuild

public void setBuild ( IBuildInfo buildInfo)

參量
buildInfo IBuildInfo

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

在僅收集器模式下運行測試套件,這也要求所有子測試也要實現此接口。

setConfiguration

public void setConfiguration ( IConfiguration configuration)

注入正在使用的IConfiguration

參量
configuration IConfiguration

setDevice

public void setDevice ( ITestDevice device)

注入被測設備。

參量
device ITestDevice :要使用的ITestDevice

setDeviceInfos

public void setDeviceInfos ( deviceInfos)

參量
deviceInfos

setInvocationContext

public void setInvocationContext ( IInvocationContext invocationContext)

參量
invocationContext IInvocationContext

setInvocationInjector

public void setInvocationInjector (Injector injector)

從調用中獲取當前的Guice Injector 。它應該允許我們繼續對象的模塊注入。

參量
injector Injector

setMaxRunLimit

public final void setMaxRunLimit (int maxRunLimit)

設置每個模塊的最大嘗試運行次數。

參量
maxRunLimit int

setMetricCollectors

public void setMetricCollectors ( collectors)

設置為測試運行定義的IMetricCollector的列表。

參量
collectors

setPrimaryAbiRun

public void setPrimaryAbiRun (boolean primaryAbiRun)

設置mPrimaryAbiRun的值

參量
primaryAbiRun boolean

setShouldMakeDynamicModule

public void setShouldMakeDynamicModule (boolean dynamicModule)

在進行分佈式分片時,我們不能擁有在池中共享測試的ModuleDefinition,否則模塊內分片將無法工作,因此我們可以禁用它。

參量
dynamicModule boolean

setSystemStatusChecker

public void setSystemStatusChecker ( systemCheckers)

從測試的配置設置ISystemStatusChecker

參量
systemCheckers

分裂

public  split (int shardCountHint)

split()替代版本,它也提供嘗試運行的shardCount。這對於某些有時無法任意決定的測試運行者很有用。

參量
shardCountHint int :嘗試的分片計數。

退貨
要單獨執行的子測試的集合;如果測試當前不可分割,則返回null

受保護的方法

createModuleListeners

protected  createModuleListeners ()

返回適用於ModuleListener級別的ITestInvocationListener的列表。這些偵聽器將在每個模塊中重複使用,不會被重新實例化,因此它們不應處於內部狀態。

退貨

filterByConfigMetadata

protected boolean filterByConfigMetadata ( IConfiguration config, 
                MultiMap <String, String> include, 
                MultiMap <String, String> exclude)

將元數據過濾器應用於配置,然後查看配置是否應運行。

參量
config IConfiguration :正在評估的IConfiguration

include MultiMap :元數據包含過濾器

exclude MultiMap :元數據排除過濾器

退貨
boolean 如果模塊應該運行,則為true,否則為false。

filterByRunnerType

protected boolean filterByRunnerType ( IConfiguration config, 
                 allowedRunners)

應用“跑步者”白名單過濾,刪除所有未列入白名單的跑步者。如果配置中有多個運行程序,則可能會刪除一些運行程序,並且配置仍將運行。

參量
config IConfiguration :正在評估的IConfiguration

allowedRunners :當前的跑步者白名單。

退貨
boolean 如果允許配置模塊運行,則為true,否則為false。

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

返回主機構建目標體系結構支持的abis。暴露於測試。

退貨

getHostAbis

protected  getHostAbis ()

返回主機abis。

退貨