自 2025 年 3 月 27 日起，我们建议您使用 android-latest-release 而非 aosp-main 构建 AOSP 并为其做出贡献。如需了解详情，请参阅 AOSP 的变更。

此页面由 Cloud Translation API 翻译。

HarnessException

public class HarnessException
extends Object implements IHarnessException

java.lang.Object
↳	com.android.tradefed.error.HarnessException

已知的直接子类

BuildError	如果提供的 build 无法运行，则会抛出此异常。
BuildRetrievalError	检索要用于测试的 build 时发生了严重错误。
ConfigurationException	如果无法加载配置，则会抛出此异常。
DeviceActionUtil.DeviceActionConfigError	配置错误异常。
DeviceNotAvailableException	当设备无法再用于测试时抛出。
ModulePusher.ModulePushError	Mainline 模块推送期间出现严重错误。
TargetSetupError	准备目标以进行测试时发生严重错误。

已知的间接子类

ClassNotFoundConfigurationException	`ConfigurationException` - 当找不到对象的类时。
DeviceDisconnectedException	当设备无法再通过其传输类型访问时抛出，例如，如果设备无法再通过 USB 或 TCP/IP 连接看到
DeviceFailedToBootError	如果设备在使用 build 刷写后无法启动，则会抛出此异常。
DeviceUnresponsiveException	`DeviceNotAvailableException` 的特殊化，表示设备对 adb 可见，但无响应（即命令超时、无法启动等）
OptionNotAllowedException	当不允许在命令行中传递选项时，出现的特定 `ConfigurationException`。
SandboxConfigurationException	来自沙盒设置的特殊配置异常。
TemplateResolutionError	在配置解析期间，扩展了 `ConfigurationException` 的类会导致模板相关错误。

用于处理在测试框架中抛出的异常的基类。此类可帮助携带 ErrorIdentifier 来报告失败详情。

摘要

公共构造函数
`HarnessException(ErrorIdentifier errorId)`
`HarnessException(String message, ErrorIdentifier errorId)`
`HarnessException(String message, Throwable cause, ErrorIdentifier errorId)`
`HarnessException(Throwable cause, ErrorIdentifier errorId)`

公共方法
`ErrorIdentifier`	`getErrorId()` 返回与异常关联的 `ErrorIdentifier`。
`String`	`getOrigin()` 返回异常的来源。
`String`	`toString()`

受保护的方法
`final void`	`setCallerClass(Class<?> clazz)`
`final void`	`setCallerClass(String clazz)`

public HarnessException (ErrorIdentifier errorId)

参数
`errorId`	`ErrorIdentifier`

public HarnessException (String message, 
                ErrorIdentifier errorId)

参数
`message`	`String`
`errorId`	`ErrorIdentifier`

public HarnessException (String message, 
                Throwable cause, 
                ErrorIdentifier errorId)

public HarnessException (Throwable cause, 
                ErrorIdentifier errorId)

参数
`cause`	`Throwable`
`errorId`	`ErrorIdentifier`

public ErrorIdentifier getErrorId ()

返回与异常关联的 ErrorIdentifier。可以为 null。

返回
`ErrorIdentifier`

public String getOrigin ()

返回异常的来源。

返回
`String`

public String toString ()

返回
`String`

protected final void setCallerClass (Class<?> clazz)

参数
`clazz`	`Class`

protected final void setCallerClass (String clazz)

参数
`clazz`	`String`