自 2025 年 3 月 27 日起，我們建議您使用 android-latest-release 而非 aosp-main 建構及貢獻 AOSP。詳情請參閱「Android 開放原始碼計畫變更」。

本頁面由 Cloud Translation API 翻譯而成。

CurrentInvocation

public class CurrentInvocation
extends Object

java.lang.Object
↳	com.android.tradefed.invoker.logger.CurrentInvocation

這個類別會追蹤並提供目前叫用資訊，可在叫用作業的任何位置使用。

摘要

公用方法
`static void`	`addInvocationInfo(CurrentInvocation.InvocationInfo key, File value)` 新增一個要在叫用層級追蹤的鍵/值。
`static void`	`clearInvocationInfos()` 清除叫用作業的叫用資訊。
`static FailureDescription`	`createFailure(String errorMessage, ErrorIdentifier errorIdentifier)` 建立與進行中的叫用動作相關的失敗。
`static ActionInProgress`	`getActionInProgress()` 傳回叫用作業的目前 `ActionInProgress`。
`static File`	`getInfo(CurrentInvocation.InvocationInfo key)` 傳回目前叫用作業的叫用指標對應圖表。
`static IInvocationContext`	`getInvocationContext()` 傳回呼叫的目前 `IInvocationContext`。
`static ExecutionFiles`	`getInvocationFiles()` 傳回呼叫的 `ExecutionFiles`。
`static IInvocationContext`	`getModuleContext()` 傳回目前模組的模組 `IInvocationContext`。
`static File`	`getWorkFolder()` 傳回叫用作業目前的資料夾，如果尚未設定，則傳回空值。
`static CurrentInvocation.IsolationGrade`	`moduleCurrentIsolation()` 傳回目前執行的套件模組是否已隔離。
`static void`	`registerExecutionFiles(ExecutionFiles invocFiles)` `ExecutionFiles` 的一次性註冊。
`static void`	`resetLocalGroup()` 重設本地化內容。
`static CurrentInvocation.IsolationGrade`	`runCurrentIsolation()` 傳回目前執行的測試是否已隔離。
`static void`	`setActionInProgress(ActionInProgress action)` 設定叫用作業的 `ActionInProgress`。
`static void`	`setInvocationContext(IInvocationContext context)` 設定叫用作業的 `IInvocationContext`。
`static void`	`setLocalGroup(ThreadGroup tg)` 使用 gRPC 伺服器內的屬性時，追蹤本地化內容
`static void`	`setModuleContext(IInvocationContext moduleContext)` 設定目前執行模組的模組 `IInvocationContext`。
`static void`	`setModuleIsolation(CurrentInvocation.IsolationGrade isolation)` 更新套件模組是否隔離的狀態。
`static void`	`setRunIsolation(CurrentInvocation.IsolationGrade isolation)` 更新測試執行是否隔離的狀態。

公用方法

addInvocationInfo

public static void addInvocationInfo (CurrentInvocation.InvocationInfo key, 
                File value)

新增一個要在叫用層級追蹤的鍵/值。

參數
`key`	`CurrentInvocation.InvocationInfo`：系統會追蹤呼叫資訊的鍵。
`value`	`File`：叫用指標的值。

clearInvocationInfos

public static void clearInvocationInfos ()

清除叫用作業的叫用資訊。

createFailure

public static FailureDescription createFailure (String errorMessage, 
                ErrorIdentifier errorIdentifier)

建立與進行中的叫用動作相關聯的失敗。避免呼叫 FailureDescription.setActionInProgress(ActionInProgress) 的便利實用工具。

參數
`errorMessage`	`String`
`errorIdentifier`	`ErrorIdentifier`

傳回
`FailureDescription`

getActionInProgress

public static ActionInProgress getActionInProgress ()

傳回叫用作業的目前 ActionInProgress。可為空值。

傳回
`ActionInProgress`

getInfo

public static File getInfo (CurrentInvocation.InvocationInfo key)

傳回目前叫用作業的叫用指標對應項目。

參數
`key`	`CurrentInvocation.InvocationInfo`

傳回
`File`

getInvocationContext

public static IInvocationContext getInvocationContext ()

傳回叫用作業的目前 IInvocationContext。可為空值。

傳回
`IInvocationContext`

getInvocationFiles

public static ExecutionFiles getInvocationFiles ()

傳回呼叫的 ExecutionFiles。

傳回
`ExecutionFiles`

getModuleContext

public static IInvocationContext getModuleContext ()

傳回目前模組的模組 IInvocationContext。如果超出模組執行範圍，則可能為空值。

傳回
`IInvocationContext`

getWorkFolder

public static File getWorkFolder ()

傳回叫用作業目前的資料夾，如果尚未設定，則傳回空值。

傳回
`File`

moduleCurrentIsolation

public static CurrentInvocation.IsolationGrade moduleCurrentIsolation ()

傳回目前執行的套件模組是否已隔離。

傳回
`CurrentInvocation.IsolationGrade`

registerExecutionFiles

public static void registerExecutionFiles (ExecutionFiles invocFiles)

一次性註冊 ExecutionFiles。這項操作由測試架構完成。

參數
`invocFiles`	`ExecutionFiles`：已註冊的 `ExecutionFiles`。

resetLocalGroup

public static void resetLocalGroup ()

重設本地化內容。

runCurrentIsolation

public static CurrentInvocation.IsolationGrade runCurrentIsolation ()

傳回目前執行的測試是否已隔離。

傳回
`CurrentInvocation.IsolationGrade`

setActionInProgress

public static void setActionInProgress (ActionInProgress action)

設定叫用作業的 ActionInProgress。

參數
`action`	`ActionInProgress`

setInvocationContext

public static void setInvocationContext (IInvocationContext context)

設定叫用作業的 IInvocationContext。

參數
`context`	`IInvocationContext`

setLocalGroup

public static void setLocalGroup (ThreadGroup tg)

在 gRPC 伺服器中使用屬性時，追蹤本地化內容

參數
`tg`	`ThreadGroup`

setModuleContext

public static void setModuleContext (IInvocationContext moduleContext)

設定目前執行模組的模組 IInvocationContext。

參數
`moduleContext`	`IInvocationContext`

setModuleIsolation

public static void setModuleIsolation (CurrentInvocation.IsolationGrade isolation)

更新套件模組是否隔離的狀態。

參數
`isolation`	`CurrentInvocation.IsolationGrade`

setRunIsolation

public static void setRunIsolation (CurrentInvocation.IsolationGrade isolation)

更新測試執行是否為隔離狀態。

參數
`isolation`	`CurrentInvocation.IsolationGrade`