BaseHostJUnit4Test

public abstract class BaseHostJUnit4Test
extends Object implements IAbiReceiver, ITestInformationReceiver

java.lang.Object
   ↳ com.android.tradefed.testtype.junit4.BaseHostJUnit4Test

ホスト JUnit4 スタイルのテスト実行用のベース テストクラス。このクラスは、ホスト側からインストルメンテーション テストのインストール、実行、クリーンアップをサポートします。このクラスは複数のデバイスに対応しています。ユーティリティとベースクラスの重複を避けるため、ホスト側からインストルメンテーション テストを実行する唯一の情報源である必要があります。

概要

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

BaseHostJUnit4Test()

パブリック メソッド

final void autoTearDown()

インストールされているすべての APK の自動テイクダウン。

final IAbi getAbi()
final IBuildInfo getBuild()
final ITestDevice getDevice()
final IInvocationContext getInvocationContext()
final TestRunResult getLastDeviceRunResults()

最後に実行された runDeviceTests の結果の TestRunResult を返します。

final getListDevices()
TestInformation getTestInformation()
boolean hasDeviceFeature(String feature)
final void installPackage(DeviceTestRunOptions options)

デバイスに DeviceTestRunOptions に基づく APK をインストールします。

final void installPackage(String apkFileName, String... options)

デバイスに名前を指定して APK をインストールします。

final void installPackage(ITestDevice device, String apkFileName, String... options)

特定のデバイスに、名前を指定して APK をインストールします。

final void installPackageAsUser(ITestDevice device, String apkFileName, boolean grantPermission, int userId, String... options)

特定のデバイスの特定のユーザーに名前を指定して APK をインストールします。

final void installPackageAsUser(String apkFileName, boolean grantPermission, int userId, String... options)

特定のユーザーに名前を指定して APK をインストールします。

final boolean isPackageInstalled(String pkg)

指定された名前のパッケージがデバイスにインストールされているかどうかを確認します。

final boolean isPackageInstalled(ITestDevice device, String pkg)

指定された名前のパッケージがデバイスにインストールされているかどうかを確認します。

final boolean runDeviceTests(ITestDevice device, String pkgName, String testClassName, String testMethodName, Integer userId, Long testTimeoutMs)

インストール済みのインストルメンテーション パッケージを実行する方法。

final boolean runDeviceTests(ITestDevice device, String pkgName, String testClassName, String testMethodName, Long testTimeoutMs, Long maxTimeToOutputMs, Long maxInstrumentationTimeoutMs)

インストール済みのインストルメンテーション パッケージを実行する方法。

final boolean runDeviceTests(ITestDevice device, String runner, String pkgName, String testClassName, String testMethodName, Integer userId, Long testTimeoutMs, Long maxTimeToOutputMs, Long maxInstrumentationTimeoutMs, boolean checkResults, boolean isHiddenApiCheckDisabled, boolean isTestApiCheckDisabled, boolean isIsolatedStorageDisabled, boolean isWindowAnimationDisabled, instrumentationArgs, extraListeners)

インストール済みのインストルメンテーション パッケージを実行する方法。

final boolean runDeviceTests(ITestDevice device, String pkgName, String testClassName, String testMethodName, Long testTimeoutMs)

インストール済みのインストルメンテーション パッケージを実行する方法。

final boolean runDeviceTests(ITestDevice device, String runner, String pkgName, String testClassName, String testMethodName, Integer userId, Long testTimeoutMs, Long maxTimeToOutputMs, Long maxInstrumentationTimeoutMs, boolean checkResults, boolean isHiddenApiCheckDisabled, instrumentationArgs)

インストール済みのインストルメンテーション パッケージを実行する方法。

final boolean runDeviceTests(String pkgName, String testClassName, String testMethodName)

インストール済みのインストルメンテーション パッケージを実行する方法。

final boolean runDeviceTests(DeviceTestRunOptions options)

DeviceTestRunOptions の情報に基づいて計測ベースを実行します。

final boolean runDeviceTests(ITestDevice device, String runner, String pkgName, String testClassName, String testMethodName, Integer userId, Long testTimeoutMs, Long maxTimeToOutputMs, Long maxInstrumentationTimeoutMs, boolean checkResults, boolean isHiddenApiCheckDisabled, boolean isTestApiCheckDisabled, boolean isIsolatedStorageDisabled, boolean isWindowAnimationDisabled, boolean isRestartDisabled, instrumentationArgs, extraListeners)

インストール済みのインストルメンテーション パッケージを実行する方法。

final boolean runDeviceTests(ITestDevice device, String pkgName, String testClassName, String testMethodName)

インストール済みのインストルメンテーション パッケージを実行する方法。

final boolean runDeviceTests(String pkgName, String testClassName, Integer userId, Long testTimeoutMs)

インストール済みのインストルメンテーション パッケージを実行する方法。

final boolean runDeviceTests(String pkgName, String testClassName)

インストール済みのインストルメンテーション パッケージを実行する方法。

final boolean runDeviceTests(ITestDevice device, String runner, String pkgName, String testClassName, String testMethodName, Integer userId, Long testTimeoutMs, Long maxTimeToOutputMs, Long maxInstrumentationTimeoutMs, boolean checkResults, boolean isHiddenApiCheckDisabled, boolean isTestApiCheckDisabled, boolean isIsolatedStorageDisabled, instrumentationArgs, extraListeners)

インストール済みのインストルメンテーション パッケージを実行する方法。

final boolean runDeviceTests(String pkgName, String testClassName, Long testTimeoutMs)

インストール済みのインストルメンテーション パッケージを実行する方法。

final boolean runDeviceTests(String runner, String pkgName, String testClassName, String testMethodName)

インストール済みのインストルメンテーション パッケージを実行する方法。

final void setAbi(IAbi abi)
final void setTestInformation(TestInformation testInformation)
final String uninstallPackage(String pkgName)

デバイス上のパッケージをアンインストールします。

final String uninstallPackage(ITestDevice device, String pkgName)

デバイス上のパッケージをアンインストールします。

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

BaseHostJUnit4Test

public BaseHostJUnit4Test ()

パブリック メソッド

autoTearDown

public final void autoTearDown ()

インストールされているすべての APK の自動削除。これにより、インストールされているデバイスからすべての APK がアンインストールされます。

例外
DeviceNotAvailableException

getAbi

public final IAbi getAbi ()

戻り値
IAbi

getBuild

public final IBuildInfo getBuild ()

戻り値
IBuildInfo

getDevice

public final ITestDevice getDevice ()

戻り値
ITestDevice

getInvocationContext

public final IInvocationContext getInvocationContext ()

戻り値
IInvocationContext

getLastDeviceRunResults

public final TestRunResult getLastDeviceRunResults ()

最後に実行された runDeviceTests の結果である TestRunResult を返します。結果が得られない場合は null。

戻り値
TestRunResult

getListDevices

public final  getListDevices ()

戻り値

getTestInformation

public TestInformation getTestInformation ()

戻り値
TestInformation

hasDeviceFeature

public boolean hasDeviceFeature (String feature)

パラメータ
feature String

戻り値
boolean

例外
DeviceNotAvailableException

installPackage

public final void installPackage (DeviceTestRunOptions options)

デバイスに DeviceTestRunOptions に基づく APK をインストールします。APK は自動的にクリーンアップされます。

パラメータ
options DeviceTestRunOptions: パッケージ インストールのオプション。
例外
DeviceNotAvailableException
TargetSetupError

installPackage

public final void installPackage (String apkFileName, 
                String... options)

デバイスに名前を指定して APK をインストールします。APK は自動的にクリーンアップされます。

パラメータ
apkFileName String: APK ファイルの名前。
options String: install コマンドに指定する追加オプション
例外
DeviceNotAvailableException
TargetSetupError

installPackage

public final void installPackage (ITestDevice device, 
                String apkFileName, 
                String... options)

特定のデバイスに、名前を指定して APK をインストールします。APK は自動的にクリーンアップされます。

パラメータ
device ITestDevice: APK をインストールする ITestDevice。
apkFileName String: APK ファイルの名前。
options String: install コマンドに指定する追加オプション
例外
DeviceNotAvailableException
TargetSetupError

installPackageAsUser

public final void installPackageAsUser (ITestDevice device, 
                String apkFileName, 
                boolean grantPermission, 
                int userId, 
                String... options)

特定のデバイスの特定のユーザーに名前を指定して APK をインストールします。

パラメータ
device ITestDevice: APK をインストールする ITestDevice。
apkFileName String: APK ファイルの名前。
grantPermission boolean: APK のインストール時に権限付与フラグを渡すかどうか。
userId int: APK をインストールするユーザーのユーザー ID。
options String: install コマンドに指定する追加オプション
例外
DeviceNotAvailableException
TargetSetupError

installPackageAsUser

public final void installPackageAsUser (String apkFileName, 
                boolean grantPermission, 
                int userId, 
                String... options)

特定のユーザーに名前を指定して APK をインストールします。

パラメータ
apkFileName String: APK ファイルの名前。
grantPermission boolean: APK のインストール時に権限付与フラグを渡すかどうか。
userId int: APK をインストールするユーザーのユーザー ID。
options String: install コマンドに指定する追加オプション
例外
DeviceNotAvailableException
TargetSetupError

isPackageInstalled

public final boolean isPackageInstalled (String pkg)

指定された名前のパッケージがデバイスにインストールされているかどうかを確認します。

パラメータ
pkg String: パッケージの名前
戻り値
boolean デバイスにパッケージが見つかった場合は true
例外
DeviceNotAvailableException

isPackageInstalled

public final boolean isPackageInstalled (ITestDevice device, 
                String pkg)

指定された名前のパッケージがデバイスにインストールされているかどうかを確認します。

パラメータ
device ITestDevice: パッケージをアンインストールするデバイス。
pkg String: パッケージの名前
戻り値
boolean デバイスにパッケージが見つかった場合は true
例外
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (ITestDevice device, 
                String pkgName, 
                String testClassName, 
                String testMethodName, 
                Integer userId, 
                Long testTimeoutMs)

インストール済みのインストルメンテーション パッケージを実行する方法。直後に getLastDeviceRunResults() を使用して、結果の詳細を取得します。

パラメータ
device ITestDevice: インストルメンテーションを実行するデバイス。
pkgName String: 実行するパッケージの名前。
testClassName String: 実行するテストクラスの名前。
testMethodName String: 実行するクラス内のテストメソッドの名前。
userId Integer: テストを実行するユーザーの ID。null にできます。
testTimeoutMs Long: 各テストケースに適用するタイムアウト（ミリ秒単位）。
戻り値
boolean エラーなく成功した場合は true。それ以外の場合は False です。
例外
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (ITestDevice device, 
                String pkgName, 
                String testClassName, 
                String testMethodName, 
                Long testTimeoutMs, 
                Long maxTimeToOutputMs, 
                Long maxInstrumentationTimeoutMs)

インストール済みのインストルメンテーション パッケージを実行する方法。直後に getLastDeviceRunResults() を使用して、結果の詳細を取得します。

パラメータ
device ITestDevice: インストルメンテーションを実行するデバイス。
pkgName String: 実行するパッケージの名前。
testClassName String: 実行するテストクラスの名前。
testMethodName String: 実行するクラス内のテストメソッドの名前。
testTimeoutMs Long: 各テストケースに適用するタイムアウト（ミリ秒単位）。
maxTimeToOutputMs Long: テストが何かの出力を開始するまでの最大タイムアウト。
maxInstrumentationTimeoutMs Long: 完全な計測が完了するまでの最大タイムアウト。
戻り値
boolean エラーなく成功した場合は true。それ以外の場合は False です。
例外
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (ITestDevice device, 
                String runner, 
                String pkgName, 
                String testClassName, 
                String testMethodName, 
                Integer userId, 
                Long testTimeoutMs, 
                Long maxTimeToOutputMs, 
                Long maxInstrumentationTimeoutMs, 
                boolean checkResults, 
                boolean isHiddenApiCheckDisabled, 
                boolean isTestApiCheckDisabled, 
                boolean isIsolatedStorageDisabled, 
                boolean isWindowAnimationDisabled, 
                 instrumentationArgs, 
                 extraListeners)

インストール済みのインストルメンテーション パッケージを実行する方法。直後に getLastDeviceRunResults() を使用して、結果の詳細を取得します。

パラメータ
device ITestDevice: インストルメンテーションを実行するデバイス。
runner String

pkgName String: 実行するパッケージの名前。
testClassName String: 実行するテストクラスの名前。
testMethodName String: 実行するクラス内のテストメソッドの名前。
userId Integer: テストを実行するユーザーの ID。null にできます。
testTimeoutMs Long: 各テストケースに適用するタイムアウト（ミリ秒単位）。
maxTimeToOutputMs Long: テストが何かの出力を開始するまでの最大タイムアウト。
maxInstrumentationTimeoutMs Long: 完全な計測が完了するまでの最大タイムアウト。
checkResults boolean: 結果のクラッシュがチェックされるかどうか。
isHiddenApiCheckDisabled boolean: 非表示の API チェックを無効にするかどうか。
isTestApiCheckDisabled boolean: テスト API チェックを無効にするかどうか。
isIsolatedStorageDisabled boolean: 分離ストレージを無効にするかどうか。
isWindowAnimationDisabled boolean: ウィンドウのアニメーションを無効にするかどうか。
instrumentationArgs : 計測に渡す引数。
extraListeners

戻り値
boolean エラーなしで成功した場合は true。それ以外の場合は False です。
例外
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (ITestDevice device, 
                String pkgName, 
                String testClassName, 
                String testMethodName, 
                Long testTimeoutMs)

インストール済みのインストルメンテーション パッケージを実行する方法。直後に getLastDeviceRunResults() を使用して、結果の詳細を取得します。

パラメータ
device ITestDevice: インストルメンテーションを実行するデバイス。
pkgName String: 実行するパッケージの名前。
testClassName String: 実行するテストクラスの名前。
testMethodName String: 実行するクラス内のテストメソッドの名前。
testTimeoutMs Long: 各テストケースに適用するタイムアウト（ミリ秒単位）。
戻り値
boolean エラーなく成功した場合は true。それ以外の場合は False です。
例外
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (ITestDevice device, 
                String runner, 
                String pkgName, 
                String testClassName, 
                String testMethodName, 
                Integer userId, 
                Long testTimeoutMs, 
                Long maxTimeToOutputMs, 
                Long maxInstrumentationTimeoutMs, 
                boolean checkResults, 
                boolean isHiddenApiCheckDisabled, 
                 instrumentationArgs)

インストール済みのインストルメンテーション パッケージを実行する方法。直後に getLastDeviceRunResults() を使用して、結果の詳細を取得します。

パラメータ
device ITestDevice: インストルメンテーションを実行するデバイス。
runner String

pkgName String: 実行するパッケージの名前。
testClassName String: 実行するテストクラスの名前。
testMethodName String: 実行するクラス内のテストメソッドの名前。
userId Integer: テストを実行するユーザーの ID。null にできます。
testTimeoutMs Long: 各テストケースに適用するタイムアウト（ミリ秒単位）。
maxTimeToOutputMs Long: テストが何かの出力を開始するまでの最大タイムアウト。
maxInstrumentationTimeoutMs Long: 完全な計測が完了するまでの最大タイムアウト。
checkResults boolean: 結果のクラッシュがチェックされるかどうか。
isHiddenApiCheckDisabled boolean: 非表示の API チェックを無効にするかどうか。
instrumentationArgs : 計測に渡す引数。
戻り値
boolean エラーなしで成功した場合は true。それ以外の場合は False です。
例外
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (String pkgName, 
                String testClassName, 
                String testMethodName)

インストール済みのインストルメンテーション パッケージを実行する方法。直後に getLastDeviceRunResults() を使用して、結果の詳細を取得します。

パラメータ
pkgName String: 実行するパッケージの名前。
testClassName String: 実行するテストクラスの名前。
testMethodName String: 実行するクラス内のテストメソッドの名前。
戻り値
boolean エラーなく成功した場合は true。それ以外の場合は False です。
例外
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (DeviceTestRunOptions options)

DeviceTestRunOptions の情報に基づいて計測ベースを実行します。

パラメータ
options DeviceTestRunOptions: 計測設定を駆動する DeviceTestRunOptions。
戻り値
boolean エラーなしで成功した場合は true。それ以外の場合は False です。
例外
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (ITestDevice device, 
                String runner, 
                String pkgName, 
                String testClassName, 
                String testMethodName, 
                Integer userId, 
                Long testTimeoutMs, 
                Long maxTimeToOutputMs, 
                Long maxInstrumentationTimeoutMs, 
                boolean checkResults, 
                boolean isHiddenApiCheckDisabled, 
                boolean isTestApiCheckDisabled, 
                boolean isIsolatedStorageDisabled, 
                boolean isWindowAnimationDisabled, 
                boolean isRestartDisabled, 
                 instrumentationArgs, 
                 extraListeners)

インストール済みのインストルメンテーション パッケージを実行する方法。直後に getLastDeviceRunResults() を使用して、結果の詳細を取得します。

パラメータ
device ITestDevice: インストルメンテーションを実行するデバイス。
runner String

pkgName String: 実行するパッケージの名前。
testClassName String: 実行するテストクラスの名前。
testMethodName String: 実行するクラス内のテストメソッドの名前。
userId Integer: テストを実行するユーザーの ID。null にできます。
testTimeoutMs Long: 各テストケースに適用するタイムアウト（ミリ秒単位）。
maxTimeToOutputMs Long: テストが何かの出力を開始するまでの最大タイムアウト。
maxInstrumentationTimeoutMs Long: 完全な計測が完了するまでの最大タイムアウト。
checkResults boolean: 結果のクラッシュがチェックされるかどうか。
isHiddenApiCheckDisabled boolean: 非表示の API チェックを無効にするかどうか。
isTestApiCheckDisabled boolean: テスト API チェックを無効にするかどうか。
isIsolatedStorageDisabled boolean: 分離ストレージを無効にするかどうか。
isWindowAnimationDisabled boolean: ウィンドウのアニメーションを無効にするかどうか。
isRestartDisabled boolean

instrumentationArgs : 計測に渡す引数。
extraListeners

戻り値
boolean エラーなしで成功した場合は true。それ以外の場合は False です。
例外
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (ITestDevice device, 
                String pkgName, 
                String testClassName, 
                String testMethodName)

インストール済みのインストルメンテーション パッケージを実行する方法。直後に getLastDeviceRunResults() を使用して、結果の詳細を取得します。

パラメータ
device ITestDevice: インストルメンテーションを実行するデバイス。
pkgName String: 実行するパッケージの名前。
testClassName String: 実行するテストクラスの名前。
testMethodName String: 実行するクラス内のテストメソッドの名前。
戻り値
boolean エラーなく成功した場合は true。それ以外の場合は False です。
例外
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (String pkgName, 
                String testClassName, 
                Integer userId, 
                Long testTimeoutMs)

インストール済みのインストルメンテーション パッケージを実行する方法。直後に getLastDeviceRunResults() を使用して、結果の詳細を取得します。

パラメータ
pkgName String: 実行するパッケージの名前。
testClassName String: 実行するテストクラスの名前。
userId Integer: テストを実行するユーザーの ID。null にできます。
testTimeoutMs Long: 各テストケースに適用するタイムアウト（ミリ秒単位）。
戻り値
boolean エラーなく成功した場合は true。それ以外の場合は False です。
例外
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (String pkgName, 
                String testClassName)

インストール済みのインストルメンテーション パッケージを実行する方法。直後に getLastDeviceRunResults() を使用して、結果の詳細を取得します。

パラメータ
pkgName String: 実行するパッケージの名前。
testClassName String: 実行するテストクラスの名前。
戻り値
boolean エラーなく成功した場合は true。それ以外の場合は False です。
例外
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (ITestDevice device, 
                String runner, 
                String pkgName, 
                String testClassName, 
                String testMethodName, 
                Integer userId, 
                Long testTimeoutMs, 
                Long maxTimeToOutputMs, 
                Long maxInstrumentationTimeoutMs, 
                boolean checkResults, 
                boolean isHiddenApiCheckDisabled, 
                boolean isTestApiCheckDisabled, 
                boolean isIsolatedStorageDisabled, 
                 instrumentationArgs, 
                 extraListeners)

インストール済みのインストルメンテーション パッケージを実行する方法。直後に getLastDeviceRunResults() を使用して、結果の詳細を取得します。

パラメータ
device ITestDevice: インストルメンテーションを実行するデバイス。
runner String

pkgName String: 実行するパッケージの名前。
testClassName String: 実行するテストクラスの名前。
testMethodName String: 実行するクラス内のテストメソッドの名前。
userId Integer: テストを実行するユーザーの ID。null にできます。
testTimeoutMs Long: 各テストケースに適用するタイムアウト（ミリ秒単位）。
maxTimeToOutputMs Long: テストが何かの出力を開始するまでの最大タイムアウト。
maxInstrumentationTimeoutMs Long: 完全な計測が完了するまでの最大タイムアウト。
checkResults boolean: 結果のクラッシュがチェックされるかどうか。
isHiddenApiCheckDisabled boolean: 非表示の API チェックを無効にするかどうか。
isTestApiCheckDisabled boolean: テスト API チェックを無効にするかどうか。
isIsolatedStorageDisabled boolean: 分離ストレージを無効にするかどうか。
instrumentationArgs : 計測に渡す引数。
extraListeners

戻り値
boolean エラーなしで成功した場合は true。それ以外の場合は False です。
例外
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (String pkgName, 
                String testClassName, 
                Long testTimeoutMs)

インストール済みのインストルメンテーション パッケージを実行する方法。直後に getLastDeviceRunResults() を使用して、結果の詳細を取得します。

パラメータ
pkgName String: 実行するパッケージの名前。
testClassName String: 実行するテストクラスの名前。
testTimeoutMs Long: 各テストケースに適用するタイムアウト（ミリ秒単位）。
戻り値
boolean エラーなく成功した場合は true。それ以外の場合は False です。
例外
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (String runner, 
                String pkgName, 
                String testClassName, 
                String testMethodName)

インストール済みのインストルメンテーション パッケージを実行する方法。直後に getLastDeviceRunResults() を使用して、結果の詳細を取得します。

パラメータ
runner String: 使用するインストルメンテーション ランナー。
pkgName String: 実行するパッケージの名前。
testClassName String: 実行するテストクラスの名前。
testMethodName String: 実行するクラス内のテストメソッドの名前。
戻り値
boolean エラーなく成功した場合は true。それ以外の場合は False です。
例外
DeviceNotAvailableException

setAbi

public final void setAbi (IAbi abi)

パラメータ
abi IAbi

setTestInformation

public final void setTestInformation (TestInformation testInformation)

パラメータ
testInformation TestInformation

uninstallPackage

public final String uninstallPackage (String pkgName)

デバイス上のパッケージをアンインストールします。

パラメータ
pkgName String: アンインストールする Android パッケージ
戻り値
String エラーコードを含む String、または成功した場合は null
例外
DeviceNotAvailableException

uninstallPackage

public final String uninstallPackage (ITestDevice device, 
                String pkgName)

デバイス上のパッケージをアンインストールする

パラメータ
device ITestDevice: パッケージをアンインストールするデバイス。
pkgName String: アンインストールする Android パッケージ
戻り値
String エラーコードを含む String、または成功した場合は null
例外
DeviceNotAvailableException