InstrumentationTest

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

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

既知の直接サブクラス AndroidJUnitTest、CodeCoverageTest AndroidJUnitTest 特定のデバイスでインストルメンテーション テスト パッケージを実行するテスト。 android.support.test.runner.AndroidJUnitRunner  CodeCoverageTest 特定のデバイスでインストルメンテーション テスト パッケージを実行するテスト。 コード カバレッジ レポートを生成します。

---

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

概要

フィールド
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) <ph type="x-smartling-placeholder"></ph> このメソッドは非推奨です。 この方法は何も行う必要がありません
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)

<ph type="x-smartling-placeholder"></ph> このメソッドは非推奨です。
この方法は

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

パラメータ
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 パッケージ内のテストのみが実行されます。

非 null 値が setClassName(String) に提供されている場合は無視されます

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

保護されたメソッド

includeNonExecuted

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