自 2026 年起，为了与我们的主干稳定开发模型保持一致，并确保生态系统的平台稳定性，我们将在第 2 季度和第 4 季度向 AOSP 发布源代码。如需构建 AOSP 并为其贡献代码，请使用 android-latest-release。android-latest-release 清单分支将始终引用推送到 AOSP 的最新版本。如需了解详情，请参阅 AOSP 变更。

Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

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)` 返回正在进行的调用的调用指标的 Map。
`static IInvocationContext`	`getInvocationContext()` 返回调用的当前 `IInvocationContext`。
`static ExecutionFiles`	`getInvocationFiles()` 返回调用的 `ExecutionFiles`。
`static IInvocationContext`	`getModuleContext()` 返回当前模块的模块 `IInvocationContext`。
`static File`	`getWorkFolder()` 返回调用的当前工作文件夹，如果尚未设置，则返回 null。
`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。可以为 null。

返回
`ActionInProgress`

getCurrentRunner

public static String getCurrentRunner ()

返回当前测试运行程序（如果已知）。

返回
`String`

getInfo

public static File getInfo (CurrentInvocation.InvocationInfo key)

返回正在进行的调用的调用指标的 Map。

参数
`key`	`CurrentInvocation.InvocationInfo`

返回
`File`

getInvocationContext

public static IInvocationContext getInvocationContext ()

返回调用的当前 IInvocationContext。可以为 null。

返回
`IInvocationContext`

getInvocationFiles

public static ExecutionFiles getInvocationFiles ()

返回调用的 ExecutionFiles。

返回
`ExecutionFiles`

getModuleContext

public static IInvocationContext getModuleContext ()

返回当前模块的模块 IInvocationContext。如果超出模块运行的范围，则可以为 null。

返回
`IInvocationContext`

getWorkFolder

public static File getWorkFolder ()

返回调用的当前工作文件夹，如果尚未设置，则返回 null。

返回
`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`