Google 致力于为黑人社区推动种族平等。查看具体举措
此页面由 Cloud Translation API 翻译。
Switch to English

仪器测试

public class InstrumentationTest
extends Object implements IDeviceTest , IResumableTest , ITestCollector , IAbiReceiver , IInvocationContextReceiver , IMetricCollectorReceiver

java.lang.Object
com.android.tradefed.testtype.InstrumentationTest


在给定设备上运行仪器测试包的测试。

摘要

领域

protected boolean mDebug

公共建设者

InstrumentationTest ()

公开方法

void addDeviceListeners ( extraListeners) addDeviceListeners ( extraListeners)

允许向跑步者添加更多自定义侦听器

void addInstrumentationArg (String key, String value)

添加参数以在运行测试时提供。

IAbi getAbi ()
String getCoverageTarget ()

获取先前通过setCoverageTarget(String)设置的coverageTarget。

boolean getDebug ()

获取检测调试设置。

ITestDevice getDevice ()

获取被测设备。

String getForceAbi ()
long getMaxTimeout ()

返回仪器的最大超时设置。

String getPackageName ()

获取要运行的Android清单包。

String getRunName ()

获取将提供给侦听器的自定义测试运行名称

String getRunnerName ()

获取要使用的Android工具运行器。

boolean isResumable ()

void run ( ITestInvocationListener listener)

运行测试,并将结果报告给侦听器。

void setAbi ( IAbi abi)
void setBugreportFrequency ( BugreportCollector.Freq freq)

设置测试失败后自动收集错误报告的频率。

void setClassName (String testClassName)

(可选)将测试类名称设置为运行。

void setCollectTestsOnly (boolean shouldCollectTest)

启用或禁用测试收集模式

void setCollectsTestsShellTimeout (int timeout)

不建议使用此方法。此方法不可操作

void setCoverageTarget (String coverageTarget)

设置此测试的覆盖率目标。

void setDebug (boolean debug)

设置检测调试设置。

void setDevice ( ITestDevice device)

注入被测设备。

void setEnforceFormat (boolean enforce)

如果我们强制执行工具的AJUR输出格式,则设置True。

void setFallbackToSerialRerun (boolean reRunSerially)

设置--fallback-to-serial-rerun选项。

void setForceAbi (String abi)

设置force-abi选项。

void setInstallFile (File installFile)

设置要安装的包含测试的可选文件。

void setInvocationContext ( IInvocationContext invocationContext)
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 setRebootBeforeReRun (boolean rebootBeforeReRun)

设置--reboot-before-rerun选项。

void setRerunMode (boolean rerun)

(可选)设置重新运行模式。

void setResumeMode (boolean resume)

(可选)设置恢复模式。

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执行的测试的集合。

受保护的方法

String getClassName ()

获取要运行的类名。

ListInstrumentationParser getListInstrumentationParser ()

获取用于解析“ pm list instrumentation”查询的ListInstrumentationParser

String getMethodName ()

获取要运行的测试方法。

String getTestPackageName ()

获取要运行的测试Java包。

String queryRunnerName ()

向设备查询要使用的测试运行程序。

void setRunnerArgs (IRemoteAndroidTestRunner runner)

领域

mDebug

protected boolean mDebug

公共建设者

仪器测试

public InstrumentationTest ()

公开方法

addDeviceListeners

public void addDeviceListeners ( extraListeners)

允许向跑步者添加更多自定义侦听器

参量
extraListeners

addInstrumentationArg

public void addInstrumentationArg (String key, 
                String value)

添加参数以在运行测试时提供。

参量
key String :参数名称

value String :参数值

getAbi

public IAbi getAbi ()

退货
IAbi

getCoverageTarget

public String getCoverageTarget ()

获取先前通过setCoverageTarget(String)设置的coverageTarget。

退货
String

getDebug

public boolean getDebug ()

获取检测调试设置。

退货
boolean 布尔调试设置。

getDevice

public ITestDevice getDevice ()

获取被测设备。

退货
ITestDevice ITestDevice

getForceAbi

public String getForceAbi ()

退货
String

getMaxTimeout

public long getMaxTimeout ()

返回仪器的最大超时设置。

退货
long

getPackageName

public String getPackageName ()

获取要运行的Android清单包。

退货
String

getRunName

public String getRunName ()

获取将提供给侦听器的自定义测试运行名称

退货
String

getRunnerName

public String getRunnerName ()

获取要使用的Android工具运行器。

退货
String

isResumable

public boolean isResumable ()

退货
boolean

public void run ( ITestInvocationListener listener)

运行测试,并将结果报告给侦听器。

参量
listener ITestInvocationListener :测试结果的ITestInvocationListener

投掷
DeviceNotAvailableException

setAbi

public void setAbi ( IAbi abi)

参量
abi IAbi

setBugreportFrequency

public void setBugreportFrequency ( BugreportCollector.Freq freq)

设置测试失败后自动收集错误报告的频率。

请注意,测试运行程序和错误报告收集器之间没有反馈机制,因此应谨慎使用EACH设置:如果大量连续快速发生故障,则可能会收集给定故障之一的错误报告发生相应故障后数十分钟或几小时。

参量
freq BugreportCollector.Freq

setClassName

public void setClassName (String testClassName)

(可选)将测试类名称设置为运行。

参量
testClassName String

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

启用或禁用测试收集模式

setCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

不建议使用此方法。
此方法不可操作

设置最大时间(以毫秒为单位),以在收集测试时考虑“对外壳输出响应的最大时间”。

参量
timeout int

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

设置此测试的覆盖率目标。

目前未使用。只是存在此方法,因此以后可以通过getCoverageTarget()检索getCoverageTarget()

参量
coverageTarget String

setDebug

public void setDebug (boolean debug)

设置检测调试设置。

参量
debug boolean :将检测调试设置设置为的布尔值。

setDevice

public void setDevice ( ITestDevice device)

注入被测设备。

参量
device ITestDevice :要使用的ITestDevice

setEnforceFormat

public void setEnforceFormat (boolean enforce)

如果我们强制执行工具的AJUR输出格式,则设置True。

参量
enforce boolean

setFallbackToSerialRerun

public void setFallbackToSerialRerun (boolean reRunSerially)

设置--fallback-to-serial-rerun选项。

参量
reRunSerially boolean

setForceAbi

public void setForceAbi (String abi)

设置force-abi选项。

setInstallFile

public void setInstallFile (File installFile)

设置要安装的包含测试的可选文件。

参量
installFile File :可安装的ERROR(/File)

setInvocationContext

public void setInvocationContext ( IInvocationContext invocationContext)

参量
invocationContext IInvocationContext

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

设置是否使用隔离存储。

参量
isolatedStorage boolean

setMethodName

public void setMethodName (String testMethodName)

(可选)将测试方法设置为运行。

参量
testMethodName String

setMetricCollectors

public void setMetricCollectors ( collectors)

设置为测试运行定义的IMetricCollector的列表。

参量
collectors

setPackageName

public void setPackageName (String packageName)

将Android清单包设置为运行。

参量
packageName String

setReRunUsingTestFile

public void setReRunUsingTestFile (boolean reRunUsingTestFile)

设置--rerun-from-file选项。

参量
reRunUsingTestFile boolean

setRebootBeforeReRun

public void setRebootBeforeReRun (boolean rebootBeforeReRun)

设置--reboot-before-rerun选项。

参量
rebootBeforeReRun boolean

setRerunMode

public void setRerunMode (boolean rerun)

(可选)设置重新运行模式。

参量
rerun boolean

setResumeMode

public void setResumeMode (boolean resume)

(可选)设置恢复模式。

参量
resume 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)的列表。如果置位,将自动尝试重新运行测试通过使用该测试文件InstrumentationFileTest而不是执行单独的ADB命令用于经由每个剩余测试InstrumentationSerialTest

参量
testFilePathOnDevice String

setTestPackageName

public void setTestPackageName (String testPackageName)

设置测试包过滤器。

如果为非null,则仅执行给定java包内的测试。

如果已将非空值提供给setClassName(String)将被忽略

参量
testPackageName String

setTestSize

public void setTestSize (String size)

(可选)将测试大小设置为运行。

参量
size String

setTestTimeout

public void setTestTimeout (long timeout)

(可选)设置每个单独的测试运行的最长时间(以毫秒为单位)。

参量
timeout long

setTestsToRun

public void setTestsToRun ( tests)

设置应由此InstrumentationTest执行的测试的集合。

参量
tests :要运行的测试

受保护的方法

getClassName

protected String getClassName ()

获取要运行的类名。

退货
String

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

获取用于解析“ pm list instrumentation”查询的ListInstrumentationParser

退货
ListInstrumentationParser

getMethodName

protected String getMethodName ()

获取要运行的测试方法。

退货
String

getTestPackageName

protected String getTestPackageName ()

获取要运行的测试Java包。

退货
String

queryRunnerName

protected String queryRunnerName ()

向设备查询要使用的测试运行程序。

退货
String 与软件包匹配的第一个测试跑步者名称;如果找不到,则为null。

投掷
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

参量
runner IRemoteAndroidTestRunner