為配合主幹穩定開發模型，並確保生態系統的平台穩定性，我們將於 2026 年起，在第 2 季和第 4 季將原始碼發布至 AOSP。如要建構及貢獻 AOSP，建議使用 android-latest-release，而非 aosp-main。android-latest-release 資訊清單分支版本一律會參照推送至 AOSP 的最新版本。詳情請參閱「Android 開放原始碼計畫變更」一文。

HarnessException

public class HarnessException
extends Object implements IHarnessException

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

已知的直接子類別

BuildError、BuildRetrievalError、ConfigurationException、DeviceActionUtil.DeviceActionConfigError、DeviceNotAvailableException、ModulePusher.ModulePushError、TargetSetupError

BuildError	如果提供的版本無法執行，就會擲回此例外狀況。
BuildRetrievalError	擷取測試版本時發生致命錯誤。
ConfigurationException	如果無法載入設定，就會擲回此例外狀況。
DeviceActionUtil.DeviceActionConfigError	設定錯誤的例外狀況。
DeviceNotAvailableException	當裝置無法再用於測試時，系統會擲回此例外狀況。
ModulePusher.ModulePushError	Mainline 模組推送期間發生嚴重錯誤。
TargetSetupError	準備測試目標時發生致命錯誤。

已知間接子類別

ClassNotFoundConfigurationException、DeviceDisconnectedException、DeviceFailedToBootError、DeviceUnresponsiveException、OptionNotAllowedException、SandboxConfigurationException、TemplateResolutionError

ClassNotFoundConfigurationException	`ConfigurationException`：找不到物件的類別。
DeviceDisconnectedException	當裝置無法透過其傳輸類型存取時，系統會擲回此例外狀況，例如裝置無法透過 USB 或 TCP/IP 連線顯示
DeviceFailedToBootError	如果裝置在刷入版本後無法啟動，系統會擲回此例外狀況。
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)`

公用建構函式

HarnessException

public HarnessException (ErrorIdentifier errorId)

參數
`errorId`	`ErrorIdentifier`

HarnessException

public HarnessException (String message, 
                ErrorIdentifier errorId)

參數
`message`	`String`
`errorId`	`ErrorIdentifier`

HarnessException

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

參數
`message`	`String`
`cause`	`Throwable`
`errorId`	`ErrorIdentifier`

HarnessException

public HarnessException (Throwable cause, 
                ErrorIdentifier errorId)

參數
`cause`	`Throwable`
`errorId`	`ErrorIdentifier`

公用方法

getErrorId

public ErrorIdentifier getErrorId ()

傳回與例外狀況相關聯的 ErrorIdentifier。可為空值。

傳回
`ErrorIdentifier`

getOrigin

public String getOrigin ()

傳回例外狀況的來源。

傳回
`String`

toString

public String toString ()

傳回
`String`

受保護的方法

setCallerClass

protected final void setCallerClass (Class<?> clazz)

參數
`clazz`	`Class`

setCallerClass

protected final void setCallerClass (String clazz)

參數
`clazz`	`String`