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()

実行された最新の runDeviceTest の 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(String pkgName, String testClassName, 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, boolean isTestApiCheckDisabled, boolean isIsolatedStorageDisabled, instrumentationArgs, extraListeners)

インストールされたインストルメンテーション パッケージを実行するメソッド。

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 ()

実行された最新の runDeviceTest の 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: インストール コマンドで指定された追加オプション

例外
DeviceNotAvailableException
TargetSetupError

installPackage

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

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

パラメータ
device ITestDevice: APK をインストールする ITestDevice

apkFileName String: apk ファイルの名前。

options String: インストール コマンドで指定された追加オプション

例外
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: インストール コマンドで指定された追加オプション

例外
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: インストール コマンドで指定された追加オプション

例外
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 (String pkgName, 
                String testClassName, 
                Long testTimeoutMs)

インストールされたインストルメンテーション パッケージを実行するメソッド。getLastDeviceRunResults() を使用する 結果の詳細を取得します

パラメータ
pkgName String: 実行するパッケージの名前。

testClassName 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, 
                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 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