ITestSuite

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

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

既知の直接サブクラス

BaseTestSuite 、 TfSuiteRunner

BaseTestSuite	新しいスイートシステムで互換性テストスイートを実行するためのテスト。
TfSuiteRunner	TF jarのres / config / suite /フォルダーからテストをロードする`ITestSuite`実装。

既知の間接サブクラス

TestMappingSuiteRunner

TestMappingSuiteRunner BaseTestSuiteオプションinclude-filterまたはTEST_MAPPINGファイルで指定されたテストをBaseTestSuiteとして実行するためのBaseTestSuite実装。

テストスイートの実行に使用される抽象クラス。このクラスは、スイートの実行方法の基本を提供します。各実装は、 loadTests()メソッドを介してテストのリストを定義できます。

概要

田畑
`public static final String`	`ABI_OPTION`
`public static final String`	`ACTIVE_MAINLINE_PARAMETER_KEY`
`public static final String`	`MAINLINE_PARAMETER_KEY`
`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`	`RANDOM_SEED`
`public static final String`	`REBOOT_BEFORE_TEST`
`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)`
`final void`	`enableRebootBeforeTest ()` reboot-before-testをtrueに設定します。
	`getAbis (ITestDevice device)` 互換性テスト`AbiUtils#getAbisSupportedByCompatibility()`とテスト中のデバイスの両方でサポートされているABIのセットを取得します。
`IBuildInfo`	`getBuildInfo ()` `ITestSuite`実装では、テストをロードするためにビルド情報が必要になる場合があります。
`final IConfiguration`	`getConfiguration ()` 呼び出し`IConfiguration`返します。
`ITestLogger`	`getCurrentTestLogger ()`
`ITestDevice`	`getDevice ()` テスト対象のデバイスを入手します。
`ModuleDefinition`	`getDirectModule ()` 直接実行される`ModuleDefinition`を返します。まだ実行されていない場合（ITestSuiteがまだシャーディングされていない場合）はnullを返します。
`IInvocationContext`	`getInvocationContext ()` 呼び出しコンテキストを返します。
`final String`	`getRequestedAbi ()` オプション-aまたは--abiで要求されたabiを返します。
	`getRequiredTokens ()`
`long`	`getRuntimeHint ()` テストの予想される実行時間をミリ秒で返します。
`File`	`getTestsDir ()`
`boolean`	`isSplitting ()` 現在`IShardableTest.split(int)`いる場合はtrueを返します。
`abstract`	`loadTests ()` 実行されるテスト構成をロードする抽象メソッド。
`void`	`reportNotExecuted (ITestInvocationListener listener, String message)` 実行されなかったテストを提供されたメインリスナーに報告します。
`void`	`reportNotExecuted (ITestInvocationListener listener)` 実行されなかったテストを提供されたメインリスナーに報告します。
`final void`	`run (TestInformation testInfo, 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`	`setInvocationContext (IInvocationContext invocationContext)`
`void`	`setInvocationInjector (Injector injector)` 呼び出しから現在のGuice `Injector`取得します。
`void`	`setMetricCollectors ( collectors)` `setMetricCollectors ( collectors)` テスト実行用に定義された`IMetricCollector`のリストを設定します。
`void`	`setPrimaryAbiRun (boolean primaryAbiRun)` mPrimaryAbiRunの値を設定します
`void`	`setShouldMakeDynamicModule (boolean dynamicModule)` 分散シャーディングを行う場合、プール内でテストを共有するModuleDefinitionを使用できません。そうしないと、モジュール内シャーディングが機能しないため、無効にすることができます。
`void`	`setSystemStatusChecker ( systemCheckers)` `setSystemStatusChecker ( systemCheckers)` テストの構成から`ISystemStatusChecker`設定します。
`void`	`setTestLogger (ITestLogger testLogger)`
	`split (Integer shardCountHint, TestInformation testInfo)` シャードを作成する親からの初期情報を含む`TestInformation`も提供する`split(int)`代替バージョン。

保護されたメソッド
	`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

ACTIVE_MAINLINE_PARAMETER_KEY

public static final String ACTIVE_MAINLINE_PARAMETER_KEY

MAINLINE_PARAMETER_KEY

public static final String MAINLINE_PARAMETER_KEY

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

RANDOM_SEED

public static final String RANDOM_SEED

REBOOT_BEFORE_TEST

public static final String REBOOT_BEFORE_TEST

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`

enableRebootBeforeTest

public final void enableRebootBeforeTest ()

reboot-before-testをtrueに設定します。

getAbis

public  getAbis (ITestDevice device)

互換性テストAbiUtils#getAbisSupportedByCompatibility()とテスト中のデバイスの両方でサポートされているABIのセットを取得します。

パラメーター
`device`	`ITestDevice`

戻り値
	テストを実行するABIのセット

投げる
`DeviceNotAvailableException`

getBuildInfo

public IBuildInfo getBuildInfo ()

ITestSuite実装では、テストをロードするためにビルド情報が必要になる場合があります。

戻り値
`IBuildInfo`

getConfiguration

public final IConfiguration getConfiguration ()

呼び出しIConfiguration返します。

戻り値
`IConfiguration`

getCurrentTestLogger

public ITestLogger getCurrentTestLogger ()

戻り値
`ITestLogger`

getDevice

public ITestDevice getDevice ()

テスト対象のデバイスを入手します。

戻り値
`ITestDevice`	`ITestDevice`

getDirectModule

public ModuleDefinition getDirectModule ()

直接実行されるModuleDefinitionを返します。まだ実行されていない場合（ITestSuiteがまだシャーディングされていない場合）はnullを返します。

戻り値
`ModuleDefinition`

getInvocationContext

public IInvocationContext getInvocationContext ()

呼び出しコンテキストを返します。

戻り値
`IInvocationContext`

getRequestedAbi

public final String getRequestedAbi ()

オプション-aまたは--abiで要求されたabiを返します。

戻り値
`String`

getRequiredTokens

public  getRequiredTokens ()

戻り値

getRuntimeHint

public long getRuntimeHint ()

予想されるテストの実行時間をミリ秒単位で返します。時間は、断片化された実行の負荷分散に使用されます

戻り値
`long`

getTestsDir

public File getTestsDir ()

戻り値
`File`

isSplitting

public boolean isSplitting ()

現在IShardableTest.split(int)いる場合はtrueを返します。

戻り値
`boolean`

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 (TestInformation testInfo, 
                ITestInvocationListener listener)

loadTests()からロードされたすべてのテストの汎用runメソッド。

パラメーター
`testInfo`	`TestInformation`
`listener`	`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`

setInvocationContext

public void setInvocationContext (IInvocationContext invocationContext)

パラメーター
`invocationContext`	`IInvocationContext`

setInvocationInjector

public void setInvocationInjector (Injector injector)

呼び出しから現在のGuice Injector取得します。モジュールのオブジェクトインジェクションを継続できるようにする必要があります。

パラメーター
`injector`	`Injector`

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`

setTestLogger

public void setTestLogger (ITestLogger testLogger)

パラメーター
`testLogger`	`ITestLogger`

スプリット

public  split (Integer shardCountHint, 
                TestInformation testInfo)

シャードを作成する親からの初期情報を含むTestInformationも提供するsplit(int)代替バージョン。シャーディング中にデバイスやビルド情報などにアクセスする必要がある場合に役立ちます。

パラメーター
`shardCountHint`	`Integer` ：試行されたシャードの数。
`testInfo`	`TestInformation` ：親`TestInformation`

戻り値
	個別に実行されるサブテストのコレクション、またはテストが現在シャード可能でない場合は`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を返します。

戻り値