调用执行
public class InvocationExecution
extends Object
implements IInvocationExecution
java.lang.Object | |
↳ | com.android.tradefed.invoker.InvocationExecution |
描述所有调用步骤的类:构建下载,target_prep,运行测试,清理。可以扩展以覆盖某些步骤的默认行为。步骤的顺序由TestInvocation
驱动。
概要
领域 | |
---|---|
public static final String | ADB_VERSION_KEY |
public static final String | JAVA_CLASSPATH_KEY |
public static final String | JAVA_VERSION_KEY
|
公共建设者 | |
---|---|
InvocationExecution () |
公开方法 | |
---|---|
void | cleanUpBuilds (IInvocationContext context, IConfiguration config) 执行build_provider清理步骤。 |
void | doCleanUp (IInvocationContext context, IConfiguration config, Throwable exception) 执行target_preparer和multi_target_preparer cleanUp步骤。 |
void | doSetup (TestInformation testInfo, IConfiguration config, ITestLogger listener) 执行target_preparer和multi_target_preparer setUp步骤。 |
void | doTeardown (TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception) 执行target_preparer和multi_target_preparer拆卸步骤。 |
boolean | fetchBuild (TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener) 执行调用的build_provider步骤。 |
void | reportLogs (ITestDevice device, ITestLogger listener, TestInvocation.Stage stage) 在调用的不同阶段报告一些设备日志。 |
final void | runDevicePostInvocationTearDown (IInvocationContext context, IConfiguration config, Throwable exception) 为调用的每个设备部分调用 |
final void | runDevicePreInvocationSetup (IInvocationContext context, IConfiguration config, ITestLogger logger) 为调用的每个设备部分调用 |
void | runTests (TestInformation info, IConfiguration config, ITestInvocationListener listener) 运行测试。 |
boolean | shardConfig ( IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger) 尝试将配置分片为子配置,以将其重新安排为在多个资源上并行运行。 |
受保护的方法 | |
---|---|
IShardHelper | createShardHelper () 创建一个返回 |
void | customizeDevicePreInvocation ( IConfiguration config, IInvocationContext context) 在preInvocationSetup之前,有机会自定义一些设备。 |
String | getAdbVersion () 返回用于调用的adb版本。 |
void | setTestTag (IBuildInfo info, IConfiguration config) 处理在构建信息上设置测试标签的问题。 |
领域
ADB_VERSION_KEY
public static final String ADB_VERSION_KEY
JAVA_CLASSPATH_KEY
public static final String JAVA_CLASSPATH_KEY
JAVA_VERSION_KEY
public static final String JAVA_VERSION_KEY
公共建设者
调用执行
public InvocationExecution ()
公开方法
cleanUpBuilds
public void cleanUpBuilds (IInvocationContext context, IConfiguration config)
执行build_provider清理步骤。与构建获取相关联。
参量 | |
---|---|
context | IInvocationContext :调用的IInvocationContext 。 |
config | IConfiguration :此测试运行的IConfiguration 。 |
doCleanUp
public void doCleanUp (IInvocationContext context, IConfiguration config, Throwable exception)
执行target_preparer和multi_target_preparer cleanUp步骤。设备是否清理干净。
参量 | |
---|---|
context | IInvocationContext :调用的IInvocationContext 。 |
config | IConfiguration :此测试运行的IConfiguration 。 |
exception | Throwable :测试运行时抛出的原始异常。 |
doSetup
public void doSetup (TestInformation testInfo, IConfiguration config, ITestLogger listener)
执行target_preparer和multi_target_preparer setUp步骤。是否运行测试所需的所有设备设置。
参量 | |
---|---|
testInfo | TestInformation :调用的TestInformation 。 |
config | IConfiguration :此测试运行的IConfiguration 。 |
listener | ITestLogger : ITestLogger 报告安装失败日志。 |
投掷 | |
---|---|
BuildError | |
DeviceNotAvailableException | |
TargetSetupError |
doTeardown
public void doTeardown (TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)
执行target_preparer和multi_target_preparer拆卸步骤。设备是否与设置相关联地拆除。
参量 | |
---|---|
testInfo | TestInformation :调用的TestInformation 。 |
config | IConfiguration :此测试运行的IConfiguration 。 |
logger | ITestLogger : ITestLogger 报告日志。 |
exception | Throwable :测试运行时抛出的原始异常。 |
fetchBuild
public boolean fetchBuild (TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)
执行调用的build_provider步骤。
参量 | |
---|---|
testInfo | TestInformation :调用的TestInformation 。 |
config | IConfiguration :此测试运行的IConfiguration 。 |
rescheduler | IRescheduler : IRescheduler ,用于重新安排部分调用以在另一个资源上执行 |
listener | ITestInvocationListener : ITestInvocation 报告构建下载失败。 |
退货 | |
---|---|
boolean | 如果我们成功下载了构建,则为true,否则为false。 |
投掷 | |
---|---|
BuildRetrievalError | |
DeviceNotAvailableException |
reportLogs
public void reportLogs (ITestDevice device, ITestLogger listener, TestInvocation.Stage stage)
在调用的不同阶段报告一些设备日志。例如:logcat。
参量 | |
---|---|
device | ITestDevice :从中报告日志的设备。 |
listener | ITestLogger :日志记录器。 |
stage | TestInvocation.Stage :我们所处的调用阶段。 |
runDevicePostInvocationTearDown
public final void runDevicePostInvocationTearDown (IInvocationContext context, IConfiguration config, Throwable exception)
为调用的每个设备部分调用ITestDevice#postInvocationTearDown(Throwable)
。
参量 | |
---|---|
context | IInvocationContext :调用的IInvocationContext 。 |
config | IConfiguration :此测试运行的IConfiguration 。 |
exception | Throwable :测试运行时抛出的原始异常(如果有)。 |
runDevicePreInvocationSetup
public final void runDevicePreInvocationSetup (IInvocationContext context, IConfiguration config, ITestLogger logger)
为调用的每个设备部分调用ITestDevice#preInvocationSetup(IBuildInfo)
。
参量 | |
---|---|
context | IInvocationContext :调用的IInvocationContext 。 |
config | IConfiguration :此测试运行的IConfiguration 。 |
logger | ITestLogger : ITestLogger 报告日志。 |
投掷 | |
---|---|
DeviceNotAvailableException | |
TargetSetupError |
运行测试
public void runTests (TestInformation info, IConfiguration config, ITestInvocationListener listener)
运行测试。
参量 | |
---|---|
info | TestInformation :用于运行测试的TestInformation 。 |
config | IConfiguration :要运行的IConfiguration |
listener | ITestInvocationListener :测试结果的ITestInvocationListener |
shardConfig
public boolean shardConfig (IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)
尝试将配置分片为子配置,以将其重新安排为在多个资源上并行运行。
如果分片计数大于1,它将通过设置分片索引并重新计划它们,简单地为每个分片创建配置。如果未设置分片计数,它将回IShardHelper#shardConfig
。
参量 | |
---|---|
config | IConfiguration :当前的IConfiguration 。 |
testInfo | TestInformation :保存测试信息的TestInformation 。 |
rescheduler | IRescheduler : IRescheduler 。 |
logger | ITestLogger : ITestLogger 用于在分片期间记录文件。 |
退货 | |
---|---|
boolean | 如果测试已分片,则为true。否则返回false |
受保护的方法
createShardHelper
protected IShardHelper createShardHelper ()
创建一个返回IShardHelper
以使用IShardHelper
。
退货 | |
---|---|
IShardHelper |
customDevicePreInvocation
protected void customizeDevicePreInvocation (IConfiguration config, IInvocationContext context)
在preInvocationSetup之前,有机会自定义一些设备。
参量 | |
---|---|
config | IConfiguration :调用的配置。 |
context | IInvocationContext :当前调用上下文。 |
getAdbVersion
protected String getAdbVersion ()
返回用于调用的adb版本。
退货 | |
---|---|
String |
setTestTag
protected void setTestTag (IBuildInfo info, IConfiguration config)
处理在构建信息上设置测试标签的问题。
参量 | |
---|---|
info | IBuildInfo |
config | IConfiguration |