HostTest

public class HostTest
extends Object implements IAbiReceiver, IBuildReceiver, IConfigurationReceiver, IDeviceTest, IRemoteTest, IRuntimeHintProvider, IShardableTest, ITestAnnotationFilterReceiver, ITestCollector, ITestFilterReceiver

java.lang.Object
↳	com.android.tradefed.testtype.HostTest

既知の直接サブクラス JarHostTest JarHostTest ホスト側の JUnit テスト用のテストランナー。

---

JUnit ホストベースのテスト用のテストランナー。実行するテストが IDeviceTest を実装する場合 このランナーはデバイスへの参照を渡します。

概要

フィールド
public static final String	SET_OPTION_DESC
public static final String	SET_OPTION_NAME

パブリック コンストラクタ
HostTest()

パブリック メソッド
void	addAllExcludeAnnotation( notAnnotations) テストがマークされている場合に除外するアノテーションの ERROR(/Set) を追加します。
void	addAllExcludeFilters( filters) 除外するテストのフィルタの ERROR(/Set) を追加します。
void	addAllIncludeAnnotation( annotations) テストがマークされている場合に含めるアノテーションの ERROR(/Set) を追加します。
void	addAllIncludeFilters( filters) 含めるテストのフィルタの ERROR(/Set) を追加します。
void	addExcludeAnnotation(String notAnnotation) テストがマークされている場合に除外するアノテーションを追加します。
void	addExcludeFilter(String filter) 除外するテストのフィルタを追加します。
void	addIncludeAnnotation(String annotation) テストがマークされている場合に、含めるアノテーションを追加します。
void	addIncludeFilter(String filter) 含めるテストのフィルタを追加します。
void	clearExcludeAnnotations() 現在トラッキングされている除外アノテーションをすべて削除します。
void	clearExcludeFilters() 現在トラッキングされている除外フィルタをすべて削除します。
void	clearIncludeAnnotations() 現在トラッキングされているインクルード アノテーションをすべて削除します。
void	clearIncludeFilters() 現在トラッキングされている一致フィルタをすべて削除します。
int	countTestCases() テストの全クラス部分のテストケースの数を返す
IAbi	getAbi()
	getClassNames()
ITestDevice	getDevice() テスト対象のデバイスを入手します。
	getExcludeAnnotations() 除外するアノテーションの現在の ERROR(/Set) を返します。
	getExcludeFilters() 除外フィルタの現在の ERROR(/Set) を返します。
	getIncludeAnnotations() 含めるアノテーションの現在の ERROR(/Set) を返します。
	getIncludeFilters() 一致フィルタの現在の ERROR(/Set) を返します。
long	getRuntimeHint() テストで想定される実行時間を ミリ秒単位です。
void	run(TestInformation testInfo, ITestInvocationListener listener) テストを実行し、結果をリスナーに報告します。
void	setAbi(IAbi abi)
void	setBuild(IBuildInfo buildInfo)
void	setCollectTestsOnly(boolean shouldCollectTest) テスト収集モードを有効または無効にします
void	setConfiguration(IConfiguration configuration) 使用中の IConfiguration を注入します。
void	setDevice(ITestDevice device) テスト対象デバイスを挿入します。
static void	setOptionToLoadedObject(Object testObj, keyValueOptions) デバイス ランナーが HostTest と同じ方法で set-option からオプションを設定するために使用するヘルパー。
void	setTestInformation(TestInformation testInfo)
	split(Integer shardCount, TestInformation testInfo) テストクラスまたはテストメソッドのいずれかで個人別に分割します。

保護されたメソッド
HostTest	createHostTest(Class<?> classObj) シャーディング時に HostTest インスタンスを作成するためのヘルパー。
IBuildInfo	getBuild() HostTest が受信したビルド情報を取得します。
ClassLoader	getClassLoader() デフォルトのクラスローダーを返します。
final	getClasses()
File	getJarFile(String jarName, TestInformation testInfo) さまざまなユースケースで、アーティファクトが通常配置されている複数の場所を検査し、 見つけましょう。
boolean	hasJUnit4Annotation(Class<?> classObj) Junit4 アノテーションを含む Test クラスを扱っているかどうかを判断するためのヘルパー。
Object	loadObject(Class<?> classObj) クラス オブジェクトを読み込み、テスト情報（デバイス、ビルド）を設定します。
void	setClassName(String className) クリアしてから、実行するクラス名を設定します。
boolean	shouldTestRun(AnnotatedElement annotatedElement) アノテーションを持つ要素がフィルタに合格しているかどうかを確認します。

フィールド

SET_OPTION_DESC

public static final String SET_OPTION_DESC

設定オプション名

public static final String SET_OPTION_NAME

パブリック コンストラクタ

HostTest

public HostTest ()

パブリック メソッド

addAllExcludeAnnotation

public void addAllExcludeAnnotation ( notAnnotations)

テストがマークされている場合に除外するアノテーションの ERROR(/Set) を追加します。

パラメータ
notAnnotations

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

除外するテストのフィルタの ERROR(/Set) を追加します。

パラメータ
filters

addAllIncludeAnnotation

public void addAllIncludeAnnotation ( annotations)

テストがマークされている場合に含めるアノテーションの ERROR(/Set) を追加します。

パラメータ
annotations

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

含めるテストのフィルタの ERROR(/Set) を追加します。

パラメータ
filters

addExcludeAnnotation

public void addExcludeAnnotation (String notAnnotation)

テストがマークされている場合に除外するアノテーションを追加します。

パラメータ
notAnnotation	String

addExcludeFilter

public void addExcludeFilter (String filter)

除外するテストのフィルタを追加します。

パラメータ
filter	String

addIncludeAnnotation によるアノテーションの追加

public void addIncludeAnnotation (String annotation)

テストがマークされている場合に、含めるアノテーションを追加します。

パラメータ
annotation	String

addIncludeFilter

public void addIncludeFilter (String filter)

含めるテストのフィルタを追加します。

パラメータ
filter	String

ClearExcludeAnnotations

public void clearExcludeAnnotations ()

現在トラッキングされている除外アノテーションをすべて削除します。

ClearExcludeFilters

public void clearExcludeFilters ()

現在トラッキングされている除外フィルタをすべて削除します。

ClearIncludeAnnotations

public void clearIncludeAnnotations ()

現在トラッキングされているインクルード アノテーションをすべて削除します。

ClearIncludeFilters

public void clearIncludeFilters ()

現在トラッキングされている一致フィルタをすべて削除します。

countTestCases

public int countTestCases ()

テストの全クラス部分のテストケースの数を返す

戻り値
int

getAbi

public IAbi getAbi ()

戻り値
IAbi

getClassNames

public  getClassNames ()

戻り値

getDevice

public ITestDevice getDevice ()

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

戻り値
ITestDevice	ITestDevice

getExcludeAnnotations

public  getExcludeAnnotations ()

除外するアノテーションの現在の ERROR(/Set) を返します。

戻り値

getExcludeFilters

public  getExcludeFilters ()

除外フィルタの現在の ERROR(/Set) を返します。

戻り値

getIncludeAnnotations

public  getIncludeAnnotations ()

含めるアノテーションの現在の ERROR(/Set) を返します。

戻り値

getIncludeFilters

public  getIncludeFilters ()

一致フィルタの現在の ERROR(/Set) を返します。

戻り値

getRuntimeHint

public long getRuntimeHint ()

テストで想定される実行時間を ミリ秒単位です。 この時間は、シャーディングされた実行のロード バランシングに使用されます

戻り値
long

ホームラン

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

テストを実行し、結果をリスナーに報告します。

パラメータ
testInfo	TestInformation: 実行に役立つ情報を含む TestInformation オブジェクト テストです。
listener	ITestInvocationListener: テスト結果の ITestInvocationListener

例外
DeviceNotAvailableException

setAbi

public void setAbi (IAbi abi)

パラメータ
abi	IAbi

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

setOptionToLoadedObject

public static void setOptionToLoadedObject (Object testObj, 
                 keyValueOptions)

デバイス ランナーが HostTest と同じ方法で set-option からオプションを設定するために使用するヘルパー。

パラメータ
testObj	Object: オプションを受け取るオブジェクト。
keyValueOptions	: HostTest の set-option に必要な形式のオプションのリスト。

setTestInformation

public void setTestInformation (TestInformation testInfo)

パラメータ
testInfo	TestInformation

分割

public  split (Integer shardCount, 
                TestInformation testInfo)

テストクラスまたはテストメソッドのいずれかで個人別に分割します。

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

戻り値
	個別に実行するサブテストのコレクション。テストが必要な場合は null 現在シャーディング不可

保護されたメソッド

createHostTest

protected HostTest createHostTest (Class<?> classObj)

シャーディング時に HostTest インスタンスを作成するためのヘルパー。オーバーライドして子を返す HostTest。

パラメータ
classObj	Class

戻り値
HostTest

getBuild

protected IBuildInfo getBuild ()

HostTest が受信したビルド情報を取得します。

戻り値
IBuildInfo	IBuildInfo

getClassLoader

protected ClassLoader getClassLoader ()

デフォルトのクラスローダーを返します。

戻り値
ClassLoader

getClasses

protected final  getClasses ()

戻り値

getJarFile

protected File getJarFile (String jarName, 
                TestInformation testInfo)

さまざまなユースケースで、アーティファクトが通常配置されている複数の場所を検査し、 見つけましょう。

パラメータ
jarName	String
testInfo	TestInformation

戻り値
File

hasJUnit4Annotation

protected boolean hasJUnit4Annotation (Class<?> classObj)

Junit4 アノテーションを含む Test クラスを扱っているかどうかを判断するためのヘルパー。

パラメータ
classObj	Class

戻り値
boolean

loadObject

protected Object loadObject (Class<?> classObj)

クラス オブジェクトを読み込み、テスト情報（デバイス、ビルド）を設定します。

パラメータ
classObj	Class

戻り値
Object

setClassName

protected void setClassName (String className)

クリアしてから、実行するクラス名を設定します。

パラメータ
className	String

shouldTestRun

protected boolean shouldTestRun (AnnotatedElement annotatedElement)

アノテーションを持つ要素がフィルタに合格しているかどうかを確認します。単体テスト用に公開されています。

戻り値
boolean	テストを実行しない場合は false。