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(
ランナーにカスタム リスナーを追加できます。 |
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 インストルメンテーション ランナーを取得します。 |
boolean
|
isOrchestrator()
|
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)
使用中の |
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(
テスト実行用に定義された |
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(
この 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
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: 引数の値 |
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 |
|
isOrchestrator
public boolean isOrchestrator ()
| 戻り値 | |
|---|---|
boolean |
|
ホームラン
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)
このメソッドは非推奨です。
このメソッドは 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 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 |