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)
このメソッドは非推奨です。 この方法は何も行う必要がありません |
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)
このメソッドは非推奨です。
この方法は
「シェル出力レスポンスまでの時間」が許容されるように最大時間をミリ秒単位で設定する収集時 テストです。
| パラメータ | |
|---|---|
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 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 |