Google は、黒人コミュニティに対する人種平等の促進に取り組んでいます。取り組みを見る
このページは Cloud Translation API によって翻訳されました。
Switch to English

BaseHostJUnit4Test

public abstract class BaseHostJUnit4Test
extends Object implements IAbiReceiver , IBuildReceiver , IDeviceTest , IInvocationContextReceiver

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

TestRunResultされた最新のTestRunResult結果であるTestRunResult返します。

final getListDevices ()
boolean hasDeviceFeature (String feature)
final void installPackage ( ITestDevice device, String apkFileName, String... options)

指定されたデバイスにその名前が指定されたAPKをインストールします。

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

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

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

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

final void installPackageAsUser ( ITestDevice device, 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 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) 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の情報にDeviceTestRunOptionsて計測を実行し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 isIsolatedStorageDisabled, instrumentationArgs, extraListeners) runDeviceTests ( ITestDevice device, String runner, String pkgName, String testClassName, String testMethodName, Integer userId, Long testTimeoutMs, Long maxTimeToOutputMs, Long maxInstrumentationTimeoutMs, boolean checkResults, boolean isHiddenApiCheckDisabled, boolean isIsolatedStorageDisabled, instrumentationArgs, extraListeners) runDeviceTests ( ITestDevice device, String runner, String pkgName, String testClassName, String testMethodName, Integer userId, Long testTimeoutMs, Long maxTimeToOutputMs, Long maxInstrumentationTimeoutMs, boolean checkResults, boolean isHiddenApiCheckDisabled, boolean isIsolatedStorageDisabled, 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 (String runner, String pkgName, String testClassName, String testMethodName)

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

final void setAbi ( IAbi abi)
final void setBuild ( IBuildInfo buildInfo)
final void setDevice ( ITestDevice device)

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

final void setInvocationContext ( IInvocationContext invocationContext)
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 ITestDevice

getInvocationContext

public final IInvocationContext getInvocationContext ()

戻り値
IInvocationContext

getLastDeviceRunResults

public final TestRunResult getLastDeviceRunResults ()

TestRunResultされた最新のTestRunResult結果であるTestRunResult返します。結果がない場合はnull。

戻り値
TestRunResult

getListDevices

public final  getListDevices ()

戻り値

hasDeviceFeature

public boolean hasDeviceFeature (String feature)

パラメーター
feature String

戻り値
boolean

投げる
DeviceNotAvailableException

installPackage

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

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

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

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

options String :インストールコマンドに追加のオプションを指定

投げる
DeviceNotAvailableException
TargetSetupError

installPackage

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

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

パラメーター
apkFileName String :apkファイルの名前。

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

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

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 失敗することなく成功すれば真。それ以外の場合は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 失敗することなく成功すれば真。それ以外の場合は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 失敗することなく成功すれば真。それ以外の場合は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 失敗することなく成功すれば真。それ以外の場合はfalse。

投げる
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests ( DeviceTestRunOptions options)

DeviceTestRunOptionsの情報にDeviceTestRunOptionsて計測を実行しDeviceTestRunOptions

パラメーター
options DeviceTestRunOptions :インストルメンテーションセットアップを駆動するDeviceTestRunOptions

戻り値
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 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チェックを無効にするかどうか。

isIsolatedStorageDisabled 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 失敗することなく成功すれば真。それ以外の場合は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 失敗することなく成功すれば真。それ以外の場合はfalse。

投げる
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (String pkgName, 
                String testClassName)

インストールされた計測パッケージを実行するメソッド。結果の詳細を取得するには、直後にgetLastDeviceRunResults()使用します。

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

testClassName String :実行するテストクラスの名前。

戻り値
boolean 失敗することなく成功すれば真。それ以外の場合はfalse。

投げる
DeviceNotAvailableException

runDeviceTests

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

インストールされた計測パッケージを実行するメソッド。結果の詳細を取得するには、直後にgetLastDeviceRunResults()使用します。

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

testClassName String :実行するテストクラスの名前。

testTimeoutMs Long :各テストケースに適用されるミリ秒単位のタイムアウト。

戻り値
boolean 失敗することなく成功すれば真。それ以外の場合は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 失敗することなく成功すれば真。それ以外の場合はfalse。

投げる
DeviceNotAvailableException

setAbi

public final void setAbi ( IAbi abi)

パラメーター
abi IAbi

setBuild

public final void setBuild ( IBuildInfo buildInfo)

パラメーター
buildInfo IBuildInfo

setDevice

public final void setDevice ( ITestDevice device)

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

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

setInvocationContext

public final void setInvocationContext ( IInvocationContext invocationContext)

パラメーター
invocationContext IInvocationContext

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