計装テスト

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

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

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

---

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

まとめ

田畑
public static final String	RUN_TESTS_AS_USER_KEY
public static final String	RUN_TESTS_ON_SDK_SANDBOX
protected boolean	mDebug

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

公開メソッド
void	addDeviceListeners ( extraListeners) 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 インストルメンテーション ランナーを取得します。
void	run ( TestInformation testInfo, ITestInvocationListener listener) テストを実行し、結果をリスナーに報告します。
void	setAbi ( IAbi abi)
void	setClassName (String testClassName) 必要に応じて、実行するテスト クラス名を設定します。
void	setCollectTestsOnly (boolean shouldCollectTest) テスト収集モードを有効または無効にします
void	setCollectsTestsShellTimeout (int timeout) このメソッドは非推奨です。このメソッドはノーオペレーションです
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) setMetricCollectors ( collectors) テスト実行用に定義されたIMetricCollectorのリストを設定します。
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) 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

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

計装テスト

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

走る

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)

このメソッドは非推奨です。
このメソッドはノーオペレーションです

テストの収集時に「シェル出力応答までの最大時間」を許容する最大時間をミリ秒単位で設定します。

パラメーター
timeout	int

setConfiguration

public void setConfiguration (IConfiguration config)

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

パラメーター
config	IConfiguration

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

このテストのカバレッジ ターゲットを設定します。

現在未使用です。このメソッドは存在するだけなので、後でgetCoverageTarget()を介して coverageTarget を取得できます。

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

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

保護されたメソッド

除外非実行

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