InstrumentationTest

public class InstrumentationTest
extends Object implements IAbiReceiver, IConfigurationReceiver, IDeviceTest, IMetricCollectorReceiver, IRemoteTest, ITestCollector

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

指定されたデバイスでインストルメンテーション テスト パッケージを実行するテスト。

概要

フィールド

public static final String RUN_TESTS_AS_USER_KEY

public static final String RUN_TESTS_ON_SDK_SANDBOX

protected boolean mDebug

protected boolean mInstrumentSdkInSandbox

protected boolean mInstrumentSdkSandbox

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

InstrumentationTest()

パブリック メソッド

void addDeviceListeners( extraListeners)

ランナーにカスタム リスナーを追加できます。

void addInstrumentationArg(String key, String value)

インストルメンテーション テストの実行時に指定する引数を追加します。

IAbi getAbi()
IConfiguration getConfiguration()

このテストの IConfiguration を取得します。

String getCoverageTarget()

以前に setCoverageTarget(String) で設定した coverageTarget を取得します。

boolean getDebug()

インストルメンテーションのデバッグ設定を取得します。

ITestDevice getDevice()

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

String getForceAbi()
long getMaxTimeout()

計測に設定された最大タイムアウトを返します。

String getPackageName()

実行する Android マニフェスト パッケージを取得します。

String getRunName()

リスナーに提供するカスタム テスト実行名を取得します。

String getRunnerName()

使用する Android インストルメンテーション ランナーを取得します。

boolean isOrchestrator()

ERROR(InstrumentationTest.mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest.mOrchestrator) の値を返します。
void run(TestInformation testInfo, ITestInvocationListener listener)

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

void setAbi(IAbi abi)
void setClassName(String testClassName)

必要に応じて、実行するテストクラス名を設定します。

void setCollectTestsOnly(boolean shouldCollectTest)

テスト収集モードを有効または無効にします

void setCollectsTestsShellTimeout(int timeout)

このメソッドは非推奨です。 このメソッドは no-op です

void setConfiguration(IConfiguration config)

使用中の IConfiguration を挿入します。

void setCoverageTarget(String coverageTarget)

このテストのカバレッジ目標を設定します。

void setDebug(boolean debug)

インストルメンテーションのデバッグ設定を設定します。

void setDevice(ITestDevice device)

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

void setEnforceFormat(boolean enforce)

計測の AJUR 出力形式を適用する場合は true に設定します。

void setForceAbi(String abi)

force-abi オプションを設定します。

void setInstallFile(File installFile)

テストを含むインストールするオプション ファイルを設定します。

void setIsolatedStorage(boolean isolatedStorage)

分離ストレージを使用するかどうかを設定します。

void setMethodName(String testMethodName)

必要に応じて、実行するテスト方法を設定します。

void setMetricCollectors( collectors)

テスト実行用に定義された IMetricCollector のリストを設定します。

void setOrchestrator(boolean useOrchestrator)

--orchestrator オプションを設定します。
void setPackageName(String packageName)

実行する Android マニフェスト パッケージを設定します。

void setReRunUsingTestFile(boolean reRunUsingTestFile)

--rerun-from-file オプションを設定します。

void setRerunMode(boolean rerun)

必要に応じて、再実行モードを設定します。

void setRunName(String runName)

リスナーに提供するカスタム テスト実行名を設定します。

void setRunnerName(String runnerName)

必要に応じて、使用する Android インストルメンテーション ランナーを設定します。

void setShellTimeout(long timeout)

必要に応じて、デバイスからのシェル出力を待機する最大時間（ミリ秒単位）を設定します。
void setTestFilePathOnDevice(String testFilePathOnDevice)

必要に応じて、実行するテストクラスとメソッドのリスト（形式: com.foo.Class#method）が含まれているデバイス上のファイルのパスを設定します。
void setTestPackageName(String testPackageName)

テスト パッケージ フィルタを設定します。

void setTestSize(String size)

必要に応じて、実行するテストサイズを設定します。

void setTestTimeout(long timeout)

必要に応じて、個々のテスト実行の最大時間（ミリ秒単位）を設定します。

void setTestsToRun( tests)

この InstrumentationTest で実行するテストのコレクションを設定します。

void setWindowAnimation(boolean windowAnimation)

保護されたメソッド

static excludeNonExecuted(TestRunResult results)

再実行が必要なものをトラッキングするために、「NOT_EXECUTED」とスキップされたものを除外します。

String getClassName()

実行するクラス名を取得します。

ListInstrumentationParser getListInstrumentationParser()

「pm list instrumentation」クエリの解析に使用される ListInstrumentationParser を取得します。

String getMethodName()

実行するテストメソッドを取得します。

String getTestPackageName()

実行するテスト Java パッケージを取得します。

String queryRunnerName()

使用するテストランナーについてデバイスにクエリを実行します。

void setRunnerArgs(IRemoteAndroidTestRunner runner)

フィールド

RUN_TESTS_AS_USER_KEY

public static final String RUN_TESTS_AS_USER_KEY

RUN_TESTS_ON_SDK_SANDBOX

public static final String RUN_TESTS_ON_SDK_SANDBOX

mDebug

protected boolean mDebug

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

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

InstrumentationTest

public InstrumentationTest ()

パブリック メソッド

addDeviceListeners

public void addDeviceListeners ( extraListeners)

ランナーにカスタム リスナーを追加できる

パラメータ
extraListeners

addInstrumentationArg

public void addInstrumentationArg (String key, 
                String value)

インストルメンテーション テストの実行時に指定する引数を追加します。

パラメータ
key String: 引数名
value String: 引数の値

getAbi

public IAbi getAbi ()

戻り値
IAbi

getConfiguration

public IConfiguration getConfiguration ()

このテストの IConfiguration を取得します。

戻り値
IConfiguration

getCoverageTarget

public String getCoverageTarget ()

以前に setCoverageTarget(String) で設定した coverageTarget を取得します。

戻り値
String

getDebug

public boolean getDebug ()

インストルメンテーションのデバッグ設定を取得します。

戻り値
boolean ブール値のデバッグ設定。

getDevice

public ITestDevice getDevice ()

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

戻り値
ITestDevice ITestDevice

getForceAbi

public String getForceAbi ()

戻り値
String

getMaxTimeout

public long getMaxTimeout ()

計測に設定された最大タイムアウトを返します。

戻り値
long

getPackageName

public String getPackageName ()

実行する Android マニフェスト パッケージを取得します。

戻り値
String

getRunName

public String getRunName ()

リスナーに提供するカスタム テスト実行名を取得する

戻り値
String

getRunnerName

public String getRunnerName ()

使用する Android インストルメンテーション ランナーを取得します。

戻り値
String

isOrchestrator

public boolean isOrchestrator ()

ERROR(InstrumentationTest.mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest.mOrchestrator) の値を返します。

戻り値
boolean

ホームラン

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

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

パラメータ
testInfo TestInformation: テストの実行に役立つ情報が含まれる TestInformation オブジェクト。
listener ITestInvocationListener: テスト結果の ITestInvocationListener
例外
DeviceNotAvailableException

setAbi

public void setAbi (IAbi abi)

パラメータ
abi IAbi

setClassName

public void setClassName (String testClassName)

必要に応じて、実行するテストクラス名を設定します。

パラメータ
testClassName String

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

テスト収集モードを有効または無効にする

setCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

このメソッドは非推奨です。
このメソッドは no-op です

テストの収集時に「シェル出力レスポンスの最大時間」を許可するように、最大時間をミリ秒単位で設定します。

パラメータ
timeout int

setConfiguration

public void setConfiguration (IConfiguration config)

使用中の IConfiguration を挿入します。

パラメータ
config IConfiguration

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

このテストのカバレッジ目標を設定します。

現在使用されていません。このメソッドは、coverageTarget を後で getCoverageTarget() を介して取得できるようにするためだけに存在します。

パラメータ
coverageTarget String

setDebug

public void setDebug (boolean debug)

インストルメンテーションのデバッグ設定を設定します。

パラメータ
debug boolean: 計測デバッグ設定に設定するブール値。

setDevice

public void setDevice (ITestDevice device)

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

パラメータ
device ITestDevice: 使用する ITestDevice

setEnforceFormat

public void setEnforceFormat (boolean enforce)

計測の AJUR 出力形式を適用する場合は true に設定します。

パラメータ
enforce boolean

setForceAbi

public void setForceAbi (String abi)

force-abi オプションを設定します。

setInstallFile

public void setInstallFile (File installFile)

テストを含むインストールするオプション ファイルを設定します。

パラメータ
installFile File: インストール可能な ERROR(/File)

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

分離ストレージを使用するかどうかを設定します。

パラメータ
isolatedStorage boolean

setMethodName

public void setMethodName (String testMethodName)

必要に応じて、実行するテスト方法を設定します。

パラメータ
testMethodName String

setMetricCollectors

public void setMetricCollectors ( collectors)

テスト実行用に定義された IMetricCollector のリストを設定します。

パラメータ
collectors

setOrchestrator

public void setOrchestrator (boolean useOrchestrator)

--orchestrator オプションを設定する

パラメータ
useOrchestrator boolean

setPackageName

public void setPackageName (String packageName)

実行する Android マニフェスト パッケージを設定します。

パラメータ
packageName String

setReRunUsingTestFile

public void setReRunUsingTestFile (boolean reRunUsingTestFile)

--rerun-from-file オプションを設定します。

パラメータ
reRunUsingTestFile boolean

setRerunMode

public void setRerunMode (boolean rerun)

必要に応じて、再実行モードを設定します。

パラメータ
rerun boolean

setRunName

public void setRunName (String runName)

リスナーに提供するカスタム テスト実行名を設定します。

パラメータ
runName String

setRunnerName

public void setRunnerName (String runnerName)

必要に応じて、使用する Android インストルメンテーション ランナーを設定します。

パラメータ
runnerName String

setShellTimeout

public void setShellTimeout (long timeout)

必要に応じて、デバイスからのシェル出力を待機する最大時間（ミリ秒単位）を設定します。

パラメータ
timeout long

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

必要に応じて、実行するテストクラスとメソッドのリスト（形式: com.foo.Class#method）が含まれているデバイス上のファイルのパスを設定します。設定すると、残りのテストごとに個別の adb コマンドを実行するのではなく、InstrumentationFileTest を介してこのテストファイルを使用してテストの再実行を自動的に試みます。

パラメータ
testFilePathOnDevice String

setTestPackageName

public void setTestPackageName (String testPackageName)

テスト パッケージ フィルタを設定します。

null でない場合、指定された java パッケージ内のテストのみが実行されます。

setClassName(String) に null 以外の値が指定されている場合、無視されます。

パラメータ
testPackageName String

setTestSize

public void setTestSize (String size)

必要に応じて、実行するテストサイズを設定します。

パラメータ
size String

setTestTimeout

public void setTestTimeout (long timeout)

必要に応じて、個々のテスト実行の最大時間（ミリ秒単位）を設定します。

パラメータ
timeout long

setTestsToRun

public void setTestsToRun ( tests)

この InstrumentationTest によって実行されるテストのコレクションを設定します。

パラメータ
tests : 実行するテスト

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

パラメータ
windowAnimation boolean

保護されたメソッド

excludeNonExecuted

protected static  excludeNonExecuted (TestRunResult results)

再実行が必要なテストをトラッキングするために、「NOT_EXECUTED」と「スキップ」を除外します。

パラメータ
results TestRunResult

戻り値

getClassName

protected String getClassName ()

実行するクラス名を取得します。

戻り値
String

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

「pm list instrumentation」クエリの解析に使用される ListInstrumentationParser を取得します。

戻り値
ListInstrumentationParser

getMethodName

protected String getMethodName ()

実行するテストメソッドを取得します。

戻り値
String

getTestPackageName

protected String getTestPackageName ()

実行するテスト Java パッケージを取得します。

戻り値
String

queryRunnerName

protected String queryRunnerName ()

使用するテストランナーについてデバイスにクエリを実行します。

戻り値
String パッケージに一致する最初のテストランナー名。一致するものが見つからない場合、null です。
例外
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

パラメータ
runner IRemoteAndroidTestRunner