调用执行

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)

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

公共方法

清理构建

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

执行 build_provider 清理步骤。与构建获取相关联。

参数
context IInvocationContext :调用的IInvocationContext

config IConfiguration :此测试运行的IConfiguration

清理

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
DeviceNotAvailableException
BuildError
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 :测试运行时抛出的原始异常。

投掷
Throwable

获取构建

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。

投掷
com.android.tradefed.build.BuildRetrievalError
DeviceNotAvailableException
BuildRetrievalError

报告日志

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
TargetSetupError
DeviceNotAvailableException

运行测试

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

运行测试。

参数
info TestInformation :用于运行测试的TestInformation

config IConfiguration :要运行的IConfiguration

listener ITestInvocationListener : 测试结果的ITestInvocationListener

投掷
Throwable

分片配置

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

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

如果分片计数大于 1,它将简单地通过设置分片索引为每个分片创建配置并重新安排它们。如果未设置分片计数,它将回IShardHelper#shardConfig

参数
config IConfiguration :当前的IConfiguration

testInfo TestInformation :保存测试信息的TestInformation

rescheduler IReschedulerIRescheduler

logger ITestLogger : ITestLogger用于在分片期间记录文件。

退货
boolean如果测试被分片,则为真。否则返回false