IInvocationExecution

public interface IInvocationExecution

com.android.tradefed.invoker.IInvocationExecution


描述将在调用过程中执行的操作的接口。调用 TestInvocation 本身可确保调用的顺序。

摘要

公共方法

default void cleanUpBuilds(IInvocationContext context, IConfiguration config)

执行 build_provider 清理步骤。

default void doCleanUp(IInvocationContext context, IConfiguration config, Throwable exception)

执行 target_ preparer 和 multi_target_ preparer 清理步骤。

default void doSetup(TestInformation testInfo, IConfiguration config, ITestLogger logger)

执行 target_ preparer 和 multi_target_ preparer 设置步骤。

default void doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)

执行 target_ preparer 和 multi_target_ preparer 拆解步骤。

default boolean fetchBuild(TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)

执行调用的 build_provider 步骤。

abstract void reportLogs(ITestDevice device, ITestLogger logger, TestInvocation.Stage stage)

报告在调用的不同阶段的一些设备日志。

default void runDevicePostInvocationTearDown(IInvocationContext context, IConfiguration config, Throwable exception)

针对ITestDevice#postInvocationTearDown(Throwable) 调用。

default void runDevicePreInvocationSetup(IInvocationContext context, IConfiguration config, ITestLogger logger)

针对ERROR(ITestDevice#preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice#preInvocationSetup(IBuildInfo)) 调用。

default void runTests(TestInformation info, IConfiguration config, ITestInvocationListener listener)

运行测试。

default boolean shardConfig(IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)

尝试将配置分片为子配置,并重新安排在哪个子配置中运行 并行运行多个资源。

公共方法

cleanUpBuild

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 清理步骤。设备会清理吗 。

参数
context IInvocationContext:调用的 IInvocationContext

config IConfiguration:此测试运行的 IConfiguration

exception Throwable:运行测试时抛出的原始异常。

设置

public void doSetup (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger logger)

执行 target_ preparer 和 multi_target_ preparer 设置步骤。是否设置所有设备 以及测试运行所需的资源

参数
testInfo TestInformation:调用的 TestInformation

config IConfiguration:此测试运行的 IConfiguration

logger ITestLogger:用于报告设置失败日志的 ITestLogger

抛出
com.android.tradefed.targetprep.TargetSetupError
com.android.tradefed.targetprep.BuildError
com.android.tradefed.device.DeviceNotAvailableException
BuildError
DeviceNotAvailableException
TargetSetupError

执行拆解

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 IReschedulerIRescheduler,用于重新调度部分调用 在其他资源上执行

listener ITestInvocationListener:用于报告 build 下载失败的 ITestInvocation

返回
boolean 如果我们成功下载了构建,则为 true,否则为 false。

抛出
com.android.tradefed.build.BuildRetrievalError
com.android.tradefed.device.DeviceNotAvailableException
BuildRetrievalError
DeviceNotAvailableException

reportLogs

public abstract void reportLogs (ITestDevice device, 
                ITestLogger logger, 
                TestInvocation.Stage stage)

报告在调用的不同阶段的一些设备日志。例如:logcat。

参数
device ITestDevice:要从中报告日志的设备。

logger ITestLogger:日志的日志记录器。

stage TestInvocation.Stage:我们所处的调用阶段。

runDevicePostInvocationTearDown

public void runDevicePostInvocationTearDown (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

针对ITestDevice#postInvocationTearDown(Throwable) 调用。

参数
context IInvocationContext:调用的 IInvocationContext

config IConfiguration:此测试运行的 IConfiguration

exception Throwable:运行测试抛出的原始异常(如果有)。

runDevicePreInvocationSetup

public void runDevicePreInvocationSetup (IInvocationContext context, 
                IConfiguration config, 
                ITestLogger logger)

针对ERROR(ITestDevice#preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice#preInvocationSetup(IBuildInfo)) 调用。

参数
context IInvocationContext:调用的 IInvocationContext

config IConfiguration:此测试运行的 IConfiguration

logger ITestLogger:要报告日志的 ITestLogger

抛出
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.targetprep.TargetSetupError
DeviceNotAvailableException
TargetSetupError

runTest

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 IReschedulerIRescheduler

logger ITestLoggerITestLogger,用于在分片期间记录文件。

返回
boolean 如果测试已分片,则为 true。否则返回 false