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

Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

HarnessException

public class HarnessException
extends Exception implements IHarnessException

java.lang.Object
↳	java.lang.Throwable
	↳	java.lang.Exception
		↳	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`