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。

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的信息运行检测。

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。如果没有可用结果,则为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 ITestDeviceITestDevice在其上安装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 ITestDeviceITestDevice在其上安装apk的ITestDevice

apkFileName String :apk文件的名称。

grantPermission boolean :安装apk时是否通过授予许可标志。

userId int :将apk安装到的用户的用户ID。

options String :给安装命令的额外选项

投掷
DeviceNotAvailableException
TargetSetupError

isPackage已安装

public final boolean isPackageInstalled (String pkg)

检查设备上是否安装了给定名称的软件包

参量
pkg String :包的名称

退货
boolean 如果在设备上找到软件包,则为true

投掷
DeviceNotAvailableException

isPackage已安装

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。否则为假。

投掷
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。否则为假。

投掷
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。否则为假。

投掷
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。否则为假。

投掷
DeviceNotAvailableException

runDeviceTests

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

运行已安装的工具包的方法。立即使用getLastDeviceRunResults()获取结果的详细信息。

参量
pkgName String :要运行的程序包的名称。

testClassName String :要运行的测试类的名称。

testMethodName String :要运行的类中的测试方法的名称。

退货
boolean 如果成功没有失败,则为true。否则为假。

投掷
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests ( DeviceTestRunOptions options)

根据DeviceTestRunOptions的信息运行检测。

参量
options DeviceTestRunOptions :驱动仪器设置的DeviceTestRunOptions

退货
boolean 如果成功没有失败,则为true。否则为假。

投掷
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。否则为假。

投掷
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。否则为假。

投掷
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。否则为假。

投掷
DeviceNotAvailableException

runDeviceTests

public final boolean runDeviceTests (String pkgName, 
                String testClassName)

运行已安装的工具包的方法。立即使用getLastDeviceRunResults()获取结果的详细信息。

参量
pkgName String :要运行的程序包的名称。

testClassName String :要运行的测试类的名称。

退货
boolean 如果成功没有失败,则为true。否则为假。

投掷
DeviceNotAvailableException

runDeviceTests

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

运行已安装的工具包的方法。立即使用getLastDeviceRunResults()获取结果的详细信息。

参量
pkgName String :要运行的程序包的名称。

testClassName String :要运行的测试类的名称。

testTimeoutMs Long :要应用于每个测试用例的超时(以毫秒为单位)。

退货
boolean 如果成功没有失败,则为true。否则为假。

投掷
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。否则为假。

投掷
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