計装テスト
public class InstrumentationTest
extends Object
implements IDeviceTest , IRemoteTest , ITestCollector , IAbiReceiver , IConfigurationReceiver , IMetricCollectorReceiver
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
|
パブリック コンストラクター | |
---|---|
InstrumentationTest () |
公開メソッド | |
---|---|
void | addDeviceListeners ( extraListeners) addDeviceListeners ( extraListeners) カスタムリスナーをランナーに追加できます |
void | addInstrumentationArg (String key, String value) インストルメンテーション テストの実行時に提供する引数を追加します。 |
IAbi | getAbi () |
IConfiguration | getConfiguration () このテストの |
String | getCoverageTarget () |
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) 使用中の |
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) テスト実行用に定義された |
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」クエリの解析に使用される |
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 : 引数の値 |
getConfiguration
public IConfiguration getConfiguration ()
このテストのIConfiguration
を取得します。
戻り値 | |
---|---|
IConfiguration |
getCoverageTarget
public String getCoverageTarget ()
setCoverageTarget(String)
を介して以前に設定された coverageTarget を取得します。
戻り値 | |
---|---|
String |
getDebug
public boolean getDebug ()
インストルメンテーション デバッグ設定を取得します。
戻り値 | |
---|---|
boolean | ブール値のデバッグ設定。 |
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 |
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 staticexcludeNonExecuted (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 |