Google 致力于为黑人社区推动种族平等。查看具体举措

调用执行

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 清理步骤。

void doSetup (TestInformation testInfo, IConfiguration config, ITestLogger listener)

执行 target_preparer 和 multi_target_preparer 设置步骤。

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)

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

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

为调用的每个设备部分调用ITestDevice#postInvocationTearDown(Throwable)

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))

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

运行测试。

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

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

受保护的方法

void collectAutoInfo ( IConfiguration config, TestInformation info)

自动收集有关被测主设备的一些信息。

IShardHelper createShardHelper ()

创建一个返回要使用的IShardHelper

void customizeDevicePreInvocation ( IConfiguration config, IInvocationContext context)

在 preInvocationSetup 之前有机会自定义一些设备。

String getAdbVersion ()

返回用于调用的 adb 版本。

getPreparersToRun ( IConfiguration config, String deviceName)

检索要在此设备上运行的准备程序列表。

void logHostAdb ( IConfiguration config, ITestLogger logger)

从 $TMPDIR/adb.$UID.log 收集日志。

void runPreparersSetup (TestInformation testInfo, IConfiguration config, ITestLogger listener)
Throwable runPreparersTearDown (TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun) runPreparersTearDown (TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun)
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 ()

公共方法

清理构建

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 listener)

执行 target_preparer 和 multi_target_preparer 设置步骤。是否设置了测试运行所需的所有设备。

参数
testInfo TestInformation :调用的TestInformation

config IConfiguration :此测试运行的IConfiguration

listener ITestLogger :报告设置失败日志的ITestLogger

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

获取构建

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

报告日志

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

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

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

listener 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

投掷
DeviceNotAvailableException
TargetSetupError

运行测试

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

运行测试。

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

config IConfiguration :要运行的IConfiguration

listener ITestInvocationListener : 测试结果的ITestInvocationListener

分片配置

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

受保护的方法

收集汽车信息

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

自动收集有关被测主设备的一些信息。

参数
config IConfiguration

info TestInformation

投掷
DeviceNotAvailableException

创建ShardHelper

protected IShardHelper createShardHelper ()

创建一个返回要使用的IShardHelper

退货
IShardHelper

customDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

在 preInvocationSetup 之前有机会自定义一些设备。

参数
config IConfiguration :调用的配置。

context IInvocationContext :当前调用上下文。

获取AdbVersion

protected String getAdbVersion ()

返回用于调用的 adb 版本。

退货
String

getPreparersToRun

protected  getPreparersToRun (IConfiguration config, 
                String deviceName)

检索要在此设备上运行的准备程序列表。

在沙盒类中重写以限制实验室准备者在沙盒子项中运行

参数
config IConfiguration

deviceName String

退货

logHostAdb

protected void logHostAdb (IConfiguration config, 
                ITestLogger logger)

从 $TMPDIR/adb.$UID.log 收集日志。

参数
config IConfiguration

logger ITestLogger

运行PreparersSetup

protected void runPreparersSetup (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger listener)

参数
testInfo TestInformation

config IConfiguration

listener ITestLogger

投掷
BuildError
DeviceNotAvailableException
TargetSetupError

runPreparersTearDown

protected Throwable runPreparersTearDown (TestInformation testInfo, 
                ITestDevice device, 
                String deviceName, 
                int deviceIndex, 
                ITestLogger logger, 
                Throwable exception, 
                 preparersToRun)

参数
testInfo TestInformation

device ITestDevice

deviceName String

deviceIndex int

logger ITestLogger

exception Throwable

preparersToRun

退货
Throwable

设置测试标签

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

处理在构建信息上设置测试标签。

参数
info IBuildInfo

config IConfiguration