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を返します。まだ実行されていない場合(ITestSuiteがまだシャーディングされていない場合)はnullを返します。

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()からロードされたすべてのテストの汎用runメソッド。

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)

実行しようとするshardCountも提供するsplit()代替バージョン。

保護されたメソッド

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を返します。まだ実行されていない場合(ITestSuiteがまだシャーディングされていない場合)はnullを返します。

戻り値
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()からロードされたすべてのテストの汎用runメソッド。

パラメーター
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)

実行しようとするshardCountも提供するsplit()代替バージョン。これは、恣意的に決定できない場合があるテストランナーに役立ちます。

パラメーター
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を返します。

戻り値