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

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

GoogleTradefedSandbox

public class GoogleTradefedSandbox
extends TradefedSandbox

java.lang.Object
↳	com.android.tradefed.sandbox.TradefedSandbox
	↳	com.google.android.tradefed.sandbox.GoogleTradefedSandbox

TradefedSandbox 的内部专业化，用于实验室基础设施。这样可以满足与 build 关联的相应版本的下载需求。如果我们有一天可以依靠 AOSP API 下载 build，或许可以将此功能移至 AOSP。

摘要

公共构造函数
`GoogleTradefedSandbox()`

公共方法
`String`	`createClasspath(File workingDir)` Google Tradefed 沙盒仅使用工作目录中的 jar。
`IConfiguration`	`createThinLauncherConfig(String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)` 与主运行断开连接的特殊模式：如果父级中似乎不存在配置，我们会回退到精简启动器，尝试使用当前已知信息设置沙盒，并填充工作目录以在版本化目录中完全创建配置。
`Map<String, List<String>>`	`discoverTests(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger)`
`IFolderBuildInfo`	`fetchSandboxExtraArtifacts(IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)`
`File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)`
`void`	`tearDown()` 清理可能已更改的任何状态、文件或环境。

受保护的方法
`File`	`dumpGlobalConfig(IConfiguration config, Set<String> exclusionPatterns)` 转储从某些对象过滤的全局配置。
`File`	`prepareContext(IInvocationContext context, IConfiguration config)` 准备并序列化 `IInvocationContext`。

公共构造函数

GoogleTradefedSandbox

public GoogleTradefedSandbox ()

公共方法

createClasspath

public String createClasspath (File workingDir)

Google Tradefed 沙盒仅使用工作目录中的 jar。

参数
`workingDir`	`File`：沙盒的当前工作目录。

返回
`String`	要使用的类路径。

抛出
`ConfigurationException`

createThinLauncherConfig

public IConfiguration createThinLauncherConfig (String[] args, 
                IKeyStoreClient keyStoreClient, 
                IRunUtil runUtil, 
                File globalConfig)

与主运行断开连接的特殊模式：如果父级中似乎不存在配置，我们会回退到精简启动器，尝试使用当前已知信息设置沙盒，并填充工作目录以在版本化目录中完全创建配置。

参数
`args`	`String`：原始命令行实参。
`keyStoreClient`	`IKeyStoreClient`：用于创建配置的当前密钥库客户端。
`runUtil`	`IRunUtil`：用于运行主机命令的当前 `IRunUtil`。
`globalConfig`	`File`：用于运行 TF 子进程的全局配置。

返回
`IConfiguration`	指向非版本化对象的 TF 配置 XML 的文件。如果无法创建精简启动器配置，则返回 null。

discoverTests

public Map<String, List<String>> discoverTests (IInvocationContext context, 
                IConfiguration nonVersionedConfig, 
                ITestLogger logger)

参数
`context`	`IInvocationContext`
`nonVersionedConfig`	`IConfiguration`
`logger`	`ITestLogger`

返回
`Map<String, List<String>>`

fetchSandboxExtraArtifacts

public IFolderBuildInfo fetchSandboxExtraArtifacts (IInvocationContext context, 
                IConfiguration nonVersionedConfig, 
                String[] args)

参数
`context`	`IInvocationContext`
`nonVersionedConfig`	`IConfiguration`
`args`	`String`

返回
`IFolderBuildInfo`

抛出
`BuildRetrievalError`
`ConfigurationException`
`IOException`

getTradefedSandboxEnvironment

public File getTradefedSandboxEnvironment (IInvocationContext context, 
                IConfiguration nonVersionedConfig, 
                ITestLogger logger, 
                String[] args)

参数
`context`	`IInvocationContext`
`nonVersionedConfig`	`IConfiguration`
`logger`	`ITestLogger`
`args`	`String`

返回
`File`

抛出
`Exception`

tearDown

public void tearDown ()

清理可能已更改的任何状态、文件或环境。

受保护的方法

dumpGlobalConfig

protected File dumpGlobalConfig (IConfiguration config, 
                Set<String> exclusionPatterns)

转储从某些对象过滤的全局配置。

参数
`config`	`IConfiguration`
`exclusionPatterns`	`Set`

返回
`File`

抛出
`ConfigurationException`
`IOException`

prepareContext

protected File prepareContext (IInvocationContext context, 
                IConfiguration config)

准备并序列化 IInvocationContext。

参数
`context`	`IInvocationContext`：要准备的 `IInvocationContext`。
`config`	`IConfiguration`：沙盒的 `IConfiguration`。

返回
`File`	序列化的 `IInvocationContext`。

抛出
`IOException`