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

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 String`	`getCurrentRunner()` 傳回目前的測試執行程式 (如果已知)。
`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`	`setCurrentRunner(String runner)` 為目前的測試執行器設定追蹤。
`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`

getCurrentRunner

public static String getCurrentRunner ()

傳回目前的測試執行程式 (如果已知)。

傳回
`String`

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`

setCurrentRunner

public static void setCurrentRunner (String runner)

設定目前測試執行器的追蹤功能。

參數
`runner`	`String`

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`