此页面由 Cloud Translation API 翻译。

测试调用

public class TestInvocation
extends Object implements ITestInvocation

java.lang.Object
↳	com.android.tradefed.invoker.TestInvocation

ITestInvocation的默认实现。

基于IConfiguration加载主要对象 - 检索构建 - 准备目标 - 运行测试 - 报告结果

概括

常量
`long`	`AVAILABILITY_CHECK_TIMEOUT`

领域
`public static final String`	`COMMAND_ARGS_KEY` 命令行 args 属性的键
`public static final String`	`INVOCATION_EXTERNAL_DEPENDENCIES`
`public static final String`	`TRADEFED_CONFIG_NAME`
`public static final String`	`TRADEFED_END_HOST_LOG`
`public static final String`	`TRADEFED_INVOC_COMPLETE_HOST_LOG`
`public static final String`	`TRADEFED_LOG_NAME`

公共构造函数
`TestInvocation ()`

公共方法
`static IBuildInfo`	`backFillBuildInfoForReporting (String commandLine)` 使用命令行回填`IBuildInfo`以在下载失败时报告的帮助程序。
`static FailureDescription`	`createFailureFromException (Throwable exception, TestRecordProto.FailureStatus defaultStatus)` 从调用异常创建`FailureDescription` 。
`IInvocationExecution`	`createInvocationExec ( TestInvocation.RunMode mode)` 创建应遵循的调用路径。
`static String`	`getDeviceLogName ( TestInvocation.Stage stage)`
`static String`	`getEmulatorLogName ( TestInvocation.Stage stage)`
`ITestInvocation.ExitInformation`	`getExitInfo ()` 给定调用的退出信息。
`void`	`invoke ( IInvocationContext context, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener... extraListeners)` 执行测试调用。
`static boolean`	`isSubprocess ( IConfiguration config)` 如果调用当前在子流程范围内，则返回 true。
`void`	`notifyInvocationForceStopped (String message, ErrorIdentifier errorId)` 通知`TestInvocation`已请求 TradeFed 停止。
`void`	`notifyInvocationStopped (String message)` 通知`TestInvocation` TradeFed 最终将关闭。
`static void`	`printStageDelimiter ( TestInvocation.Stage phase, boolean end)` 打印给定调用阶段的分隔符。
`void`	`registerExecutionFiles ( ExecutionFiles executionFiles)`
`void`	`setClearcutClient (ClearcutClient client)` 转发 clearcut 客户端以报告指标。
`String`	`toString ()`

受保护的方法
`void`	`addInvocationMetric ( InvocationMetricLogger.InvocationMetricKey key, String value)`
`void`	`addInvocationMetric ( InvocationMetricLogger.InvocationMetricKey key, long value)`
`void`	`applyAutomatedReporters ( IConfiguration config)`
`void`	`setExitCode ( CommandRunner.ExitCode code, Throwable stack)` 帮助设置退出代码。

常量

可用性_检查_超时

public static final long AVAILABILITY_CHECK_TIMEOUT

常数值：180000 (0x000000000002bf20)

领域

COMMAND_ARGS_KEY

public static final String COMMAND_ARGS_KEY

命令行 args 属性的键

INVOCATION_EXTERNAL_DEPENDENCIES

public static final String INVOCATION_EXTERNAL_DEPENDENCIES

TRADEFED_CONFIG_NAME

public static final String TRADEFED_CONFIG_NAME

TRADEFED_END_HOST_LOG

public static final String TRADEFED_END_HOST_LOG

TRADEFED_INVOC_COMPLETE_HOST_LOG

public static final String TRADEFED_INVOC_COMPLETE_HOST_LOG

TRADEFED_LOG_NAME

public static final String TRADEFED_LOG_NAME

公共构造函数

测试调用

public TestInvocation ()

公共方法

backFillBuildInfoForReporting

public static IBuildInfo backFillBuildInfoForReporting (String commandLine)

使用命令行回填IBuildInfo以在下载失败时报告的帮助程序。

参数
`commandLine`	`String`

退货
`IBuildInfo`

createFailureFromException 异常

public static FailureDescription createFailureFromException (Throwable exception, 
                TestRecordProto.FailureStatus defaultStatus)

从调用异常创建FailureDescription 。

参数
`exception`	`Throwable` ：要转换的异常
`defaultStatus`	`TestRecordProto.FailureStatus` ：如果异常不是`IHarnessException`则默认使用的状态。

退货
`FailureDescription`

创建InvocationExec

public IInvocationExecution createInvocationExec (TestInvocation.RunMode mode)

创建应遵循的调用路径。

参数
`mode`	`TestInvocation.RunMode` ：我们当前运行的模式。

退货
`IInvocationExecution`	描述调用的`IInvocationExecution` 。

获取设备日志名称

public static String getDeviceLogName (TestInvocation.Stage stage)

参数
`stage`	`TestInvocation.Stage`

退货
`String`

getEmulatorLogName

public static String getEmulatorLogName (TestInvocation.Stage stage)

参数
`stage`	`TestInvocation.Stage`

退货
`String`

获取退出信息

public ITestInvocation.ExitInformation getExitInfo ()

给定调用的退出信息。

退货
`ITestInvocation.ExitInformation`

调用

public void invoke (IInvocationContext context, 
                IConfiguration config, 
                IRescheduler rescheduler, 
                ITestInvocationListener... extraListeners)

执行测试调用。

参数
`context`	`IInvocationContext` ：执行测试的`IInvocationContext` 。
`config`	`IConfiguration` ：本次测试运行的`IConfiguration` 。
`rescheduler`	`IRescheduler` ： `IRescheduler` ，用于重新安排调用的一部分以在另一个资源上执行
`extraListeners`	`ITestInvocationListener` ：要通知的`ITestInvocationListener` s，除了`config`中的那些

投掷
`DeviceNotAvailableException`

是子进程

public static boolean isSubprocess (IConfiguration config)

如果调用当前在子流程范围内，则返回 true。

参数
`config`	`IConfiguration`

退货
`boolean`

通知调用强制停止

public void notifyInvocationForceStopped (String message, 
                ErrorIdentifier errorId)

通知TestInvocation已请求 TradeFed 停止。

参数
`message`	`String` ：与停止调用关联的消息
`errorId`	`ErrorIdentifier` ：与强制停止关联的标识符

通知调用停止

public void notifyInvocationStopped (String message)

通知TestInvocation TradeFed 最终将关闭。

参数
`message`	`String` ：与停止调用关联的消息

打印阶段定界符

public static void printStageDelimiter (TestInvocation.Stage phase, 
                boolean end)

打印给定调用阶段的分隔符。

参数
`phase`	`TestInvocation.Stage`
`end`	`boolean`

注册执行文件

public void registerExecutionFiles (ExecutionFiles executionFiles)

参数
`executionFiles`	`ExecutionFiles`

设置清除客户端

public void setClearcutClient (ClearcutClient client)

转发 clearcut 客户端以报告指标。

参数
`client`	`ClearcutClient`

到字符串

public String toString ()

退货
`String`

受保护的方法

添加调用指标

protected void addInvocationMetric (InvocationMetricLogger.InvocationMetricKey key, 
                String value)

参数
`key`	`InvocationMetricLogger.InvocationMetricKey`
`value`	`String`

添加调用指标

protected void addInvocationMetric (InvocationMetricLogger.InvocationMetricKey key, 
                long value)

参数
`key`	`InvocationMetricLogger.InvocationMetricKey`
`value`	`long`

申请自动记者

protected void applyAutomatedReporters (IConfiguration config)

参数
`config`	`IConfiguration`

设置退出代码

protected void setExitCode (CommandRunner.ExitCode code, 
                Throwable stack)

帮助设置退出代码。暴露测试。

参数
`code`	`CommandRunner.ExitCode`
`stack`	`Throwable`