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


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()

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

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)

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

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)

さまざまなユースケースで、通常アーティファクトがある複数の場所を調べて、jar を見つけます。

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

SET_OPTION_NAME

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 ()

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

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)

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

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

さまざまなユースケースでアーティファクトが通常配置されている場所をいくつか調べて、jar を見つけます。

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