計装テスト

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

java.lang.オブジェクト
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 ( 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

mデバッグ

protected boolean mDebug

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkサンドボックス

protected boolean mInstrumentSdkSandbox

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

計装テスト

public InstrumentationTest ()

パブリックメソッド

addDeviceListeners

public void addDeviceListeners ( extraListeners)

ランナーにさらにカスタム リスナーを追加できるようにします

パラメーター
extraListeners

addInstrumentationArg

public void addInstrumentationArg (String key, 
                String value)

インストルメンテーション テストの実行時に指定する引数を追加します。

パラメーター
key String : 引数名

value String : 引数の値

アビを取得

public IAbi getAbi ()

戻り値
IAbi

get構成

public IConfiguration getConfiguration ()

このテストのIConfigurationを取得します。

戻り値
IConfiguration

getCoverageTarget

public String getCoverageTarget ()

setCoverageTarget(String)を介して以前に設定されたcoverageTargetを取得します。

戻り値
String

デバッグの取得

public boolean getDebug ()

インストルメンテーションのデバッグ設定を取得します。

戻り値
booleanブール値のデバッグ設定。

デバイスの取得

public ITestDevice getDevice ()

テスト対象のデバイスを取得します。

戻り値
ITestDevice ITestDevice

getForceAbi

public String getForceAbi ()

戻り値
String

getMaxTimeout

public long getMaxTimeout ()

インストルメンテーションに設定された最大タイムアウトを返します。

戻り値
long

getパッケージ名

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

セットアビ

public void setAbi (IAbi abi)

パラメーター
abi IAbi

セットクラス名

public void setClassName (String testClassName)

必要に応じて、実行するテスト クラス名を設定します。

パラメーター
testClassName String

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

テスト収集モードを有効または無効にします。

setCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

このメソッドは廃止されました。
このメソッドは何も操作しません

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

パラメーター
timeout int

set構成

public void setConfiguration (IConfiguration config)

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

パラメーター
config IConfiguration

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

このテストのカバレッジ目標を設定します。

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

パラメーター
coverageTarget String

セットデバッグ

public void setDebug (boolean debug)

インストルメンテーションのデバッグ設定を設定します。

パラメーター
debug boolean : インストルメンテーションのデバッグ設定を設定するブール値。

セットデバイス

public void setDevice (ITestDevice device)

テスト対象のデバイスを注入します。

パラメーター
device ITestDevice : 使用するITestDevice

setEnforceFormat

public void setEnforceFormat (boolean enforce)

インストルメンテーションの AJUR 出力形式を強制する場合は、True を設定します。

パラメーター
enforce boolean

セットフォースアビ

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

setパッケージ名

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

実行するテストを設定

public void setTestsToRun ( tests)

この InstrumentationTest によって実行されるテストのコレクションを設定します。

パラメーター
tests : 実行するテスト

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

パラメーター
windowAnimation boolean

保護されたメソッド

除外非実行

protected static  excludeNonExecuted (TestRunResult results)

再実行する必要があるものを追跡するために、「NOT_EXECUTED」をフィルターで除外します。

パラメーター
results TestRunResult

戻り値

getクラス名

protected String getClassName ()

実行するクラス名を取得します。

戻り値
String

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

「pm list instrumentation」クエリの解析に使用されるListInstrumentationParserを取得します。

戻り値
ListInstrumentationParser

getメソッド名

protected String getMethodName ()

実行するテスト メソッドを取得します。

戻り値
String

getTestPackageName

protected String getTestPackageName ()

実行するテスト Java パッケージを取得します。

戻り値
String

クエリランナー名

protected String queryRunnerName ()

テスト ランナーが使用するデバイスをクエリします。

戻り値
Stringパッケージに一致する最初のテスト ランナー名、または見つからない場合は null。

投げる
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

パラメーター
runner IRemoteAndroidTestRunner