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

ITestStorageClient

public interface ITestStorageClient

com.google.android.tradefed.result.teststorage.ITestStorageClient

已知的间接子类

客户端

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

用于与 Android 测试存储后端通信的接口。该接口包含用于创建和更新调用和工作单元以及上传测试结果的方法。为了创建或更新工作单元或测试结果，它们必须属于由相应客户端创建的调用，或者必须使用 addInvocation 方法添加调用。

摘要

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

公共方法

createInvocation

public abstract Invocation createInvocation (Invocation invocation)

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

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

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

抛出
	IOException

createLocalBuild

public abstract Build createLocalBuild (Build localBuild)

在后端中插入本地 build。

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

返回
`Build`	`Build`

抛出
	IOException

createWorkUnit

public abstract WorkUnit createWorkUnit (WorkUnit workUnit)

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

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

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

抛出
	IOException

createWorkUnits

public abstract ImmutableList<WorkUnit> createWorkUnits ( workUnits)

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

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

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

抛出
	IOException

fetchTestArtifact

public abstract File fetchTestArtifact (String invocationId, 
                String resourceId)

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

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

返回
`File`

finalizeTestResults

public abstract void finalizeTestResults ()

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

getInvocation

public abstract Invocation getInvocation (String invocationId)

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

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

返回
`Invocation`

抛出
	- 如果找不到所提供的调用，或者与后端通信时出错。

getTestArtifact

public abstract BuildArtifactMetadata getTestArtifact (String invocationId, 
                String resourceId)

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

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

返回
`BuildArtifactMetadata`

getWorkUnit

public abstract WorkUnit getWorkUnit (String workUnitId)

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

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

返回
`WorkUnit`

抛出
	- 如果找不到提供的工作单元，或者与后端服务通信时出错。

listTestArtifact

public abstract TestArtifactListResponse listTestArtifact (String invocationId, 
                String artifactType)

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

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

返回
`TestArtifactListResponse`

updateInvocation

public abstract Invocation updateInvocation (Invocation invocation)

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

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

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

抛出
	IOException

updateTestArtifact

public abstract 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 abstract BuildArtifactMetadata updateTestArtifact (BuildArtifactMetadata artifact, 
                long legacyId, 
                AbstractInputStreamContent content)

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

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

返回
`BuildArtifactMetadata`

updateWorkUnit

public abstract WorkUnit updateWorkUnit (WorkUnit workUnit)

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

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

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

抛出
	IOException

uploadAssociations

public abstract void uploadAssociations ( associations, 
                int poolSize)

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

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

抛出
	IOException

uploadResult

public abstract void uploadResult (TestResult result)

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

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

抛出
	IOException