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

客户

public final class Client
extends Object implements ITestStorageClient

java.lang.Object
↳	com.google.android.tradefed.result.teststorage.Client

将测试结果上传到测试存储服务的 Android 测试存储客户端。

摘要

公共方法
`static ITestStorageClient`	`create(String buildEnvironment, boolean useLegacyMigration, boolean enableUploadThread, boolean useBatchApi, int maxBatchSize, int insertBatchSize)`
`static ITestStorageClient`	`create(Androidbuildinternal client)`
`static ITestStorageClient`	`create(String buildEnvironment, boolean useLegacyMigration, boolean enableUploadThread, boolean useBatchApi)`
`static ITestStorageClient`	`create(String buildEnvironment, boolean useLegacyMigration, boolean useBatchApi)`
`Invocation`	`createInvocation(Invocation invocation)` 使用所提供调用中的数据在测试存储空间中创建调用。
`Build`	`createLocalBuild(Build localBuild)` 如需了解详情，请参阅 go/local_build_guide。
`WorkUnit`	`createWorkUnit(WorkUnit workUnit)` 在测试存储空间中创建工作单元。
`ImmutableList<WorkUnit>`	`createWorkUnits( workUnits)` 在 TestStorage 中创建所提供列表中的所有工作单元。
`File`	`fetchTestArtifact(String invocationId, String resourceId)` 提取并返回实际请求的测试制品文件。
`void`	`finalizeTestResults()` 等待所有测试结果上传完毕。
`Invocation`	`getInvocation(String invocationId)` 返回具有指定调用 ID 的调用。
`BuildArtifactMetadata`	`getTestArtifact(String invocationId, String resourceId)` 返回与所提供的调用和资源 ID 相匹配的测试制品。
`WorkUnit`	`getWorkUnit(String workUnitId)` 返回与所提供 ID 匹配的工作单元。
`TestArtifactListResponse`	`listTestArtifact(String invocationId, String artifactType)` 搜索并列出与所提供类型匹配的所有测试制品。
`Invocation`	`updateInvocation(Invocation invocation)` 使用所提供调用中的数据更新测试存储空间中的调用。
`BuildArtifactMetadata`	`updateTestArtifact(String invocationId, String workUnitId, String testResultId, BuildArtifactMetadata artifact, long legacyId)` 更新提供的制品。
`BuildArtifactMetadata`	`updateTestArtifact(BuildArtifactMetadata artifact, long legacyId, AbstractInputStreamContent content)` 更新提供的制品并上传提供的内容。
`WorkUnit`	`updateWorkUnit(WorkUnit workUnit)` 更新测试存储空间中提供的工作单元。
`void`	`uploadAssociations( associations, int poolSize)` 上传日志与测试/工作单元之间的关联。
`void`	`uploadResult(TestResult result)` 将提供的测试结果上传到测试存储空间。

公共方法

create

public static ITestStorageClient create (String buildEnvironment, 
                boolean useLegacyMigration, 
                boolean enableUploadThread, 
                boolean useBatchApi, 
                int maxBatchSize, 
                int insertBatchSize)

参数
`buildEnvironment`	`String`
`useLegacyMigration`	`boolean`
`enableUploadThread`	`boolean`
`useBatchApi`	`boolean`
`maxBatchSize`	`int`
`insertBatchSize`	`int`

返回
`ITestStorageClient`

create

public static ITestStorageClient create (Androidbuildinternal client)

参数
`client`	`Androidbuildinternal`

返回
`ITestStorageClient`

create

public static ITestStorageClient create (String buildEnvironment, 
                boolean useLegacyMigration, 
                boolean enableUploadThread, 
                boolean useBatchApi)

参数
`buildEnvironment`	`String`
`useLegacyMigration`	`boolean`
`enableUploadThread`	`boolean`
`useBatchApi`	`boolean`

返回
`ITestStorageClient`

create

public static ITestStorageClient create (String buildEnvironment, 
                boolean useLegacyMigration, 
                boolean useBatchApi)

参数
`buildEnvironment`	`String`
`useLegacyMigration`	`boolean`
`useBatchApi`	`boolean`

返回
`ITestStorageClient`

createInvocation

public Invocation createInvocation (Invocation invocation)

使用所提供调用中的数据在测试存储空间中创建调用。

参数
`invocation`	`Invocation`：- 描述要创建的调用。

返回
`Invocation`	在测试存储空间中创建的调用。

createLocalBuild

public Build createLocalBuild (Build localBuild)

如需了解详情，请参阅 go/local_build_guide。

参数
`localBuild`	`Build`：本地 build 的说明

返回
`Build`	`Build`

createWorkUnit

public WorkUnit createWorkUnit (WorkUnit workUnit)

在测试存储空间中创建工作单元。

参数
`workUnit`	`WorkUnit`：- 描述要创建的工作单元。

返回
`WorkUnit`	新的工作单位。

createWorkUnits

public ImmutableList<WorkUnit> createWorkUnits ( workUnits)

在 TestStorage 中创建所提供列表中的所有工作单元。

参数
`workUnits`	：- 要创建的工作单元的列表。

返回
`ImmutableList<WorkUnit>`	已创建的工作单元列表。

fetchTestArtifact

public File fetchTestArtifact (String invocationId, 
                String resourceId)

提取并返回实际请求的测试制品文件。

参数
`invocationId`	`String`
`resourceId`	`String`

返回
`File`

finalizeTestResults

public void finalizeTestResults ()

等待所有测试结果上传完毕。

getInvocation

public Invocation getInvocation (String invocationId)

返回具有指定调用 ID 的调用。

参数
`invocationId`	`String`：- 要返回的调用的 ID。

返回
`Invocation`

getTestArtifact

public BuildArtifactMetadata getTestArtifact (String invocationId, 
                String resourceId)

返回与所提供的调用和资源 ID 相匹配的测试制品。

参数
`invocationId`	`String`
`resourceId`	`String`

返回
`BuildArtifactMetadata`

getWorkUnit

public WorkUnit getWorkUnit (String workUnitId)

返回与所提供 ID 匹配的工作单元。

参数
`workUnitId`	`String`：- 工作单元的 ID。

返回
`WorkUnit`

listTestArtifact

public TestArtifactListResponse listTestArtifact (String invocationId, 
                String artifactType)

搜索并列出与所提供类型匹配的所有测试制品。

参数
`invocationId`	`String`
`artifactType`	`String`

返回
`TestArtifactListResponse`

updateInvocation

public Invocation updateInvocation (Invocation invocation)

使用所提供调用中的数据更新测试存储空间中的调用。

参数
`invocation`	`Invocation`：- 包含更新数据的调用。

返回
`Invocation`	更新后的调用。

updateTestArtifact

public BuildArtifactMetadata updateTestArtifact (String invocationId, 
                String workUnitId, 
                String testResultId, 
                BuildArtifactMetadata artifact, 
                long legacyId)

更新提供的制品。此方法仅更新关联，不会修改内容。调用此方法时，请将原始调用 ID、工作单元 ID 和测试结果 ID 作为实参提供。将新的工作单元和测试结果 ID 放入 BuildArtifactMetadata 对象中。如果关联中未使用工作单元 ID 和/或测试结果，则应将其设置为空字符串 ("")。

参数
`invocationId`	`String`
`workUnitId`	`String`
`testResultId`	`String`
`artifact`	`BuildArtifactMetadata`
`legacyId`	`long`

返回
`BuildArtifactMetadata`

updateTestArtifact

public BuildArtifactMetadata updateTestArtifact (BuildArtifactMetadata artifact, 
                long legacyId, 
                AbstractInputStreamContent content)

更新提供的制品并上传提供的内容。上传内容时，无法更新关联数据。请勿修改 BuildArtifactMetadata 实参中已设置的工作单元 ID 和测试结果 ID。

参数
`artifact`	`BuildArtifactMetadata`
`legacyId`	`long`
`content`	`AbstractInputStreamContent`

返回
`BuildArtifactMetadata`

updateWorkUnit

public WorkUnit updateWorkUnit (WorkUnit workUnit)

更新测试存储空间中提供的工作单元。

参数
`workUnit`	`WorkUnit`：- 要更新的工作单元。

返回
`WorkUnit`	更新后的工作单元。

uploadAssociations

public void uploadAssociations ( associations, 
                int poolSize)

上传日志与测试/工作单元之间的关联。关联功能可让 Android 测试存储空间跟踪哪个测试生成了日志。

参数
`associations`	：日志文件及其关联的列表。
`poolSize`	`int`：用于并行上传的工作器池的大小。0 表示不进行并行上传。

uploadResult

public void uploadResult (TestResult result)

将提供的测试结果上传到测试存储空间。测试结果必须是之前创建的调用的一部分。

参数
`result`	`TestResult`：- 要上传的结果。