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

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

委托人

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(List<WorkUnit> 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 unusedLegacyId)` 更新提供的制品。
`BuildArtifactMetadata`	`updateTestArtifact(BuildArtifactMetadata artifact, long unusedLegacyId, AbstractInputStreamContent content)` 更新提供的制品并上传提供的内容。
`WorkUnit`	`updateWorkUnit(WorkUnit workUnit)` 更新测试存储空间中提供的作业单元。
`void`	`uploadAssociations(List<LogAssociation> 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`

抛出
`GeneralSecurityException`
`IOException`

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`

抛出
`GeneralSecurityException`
`IOException`

create

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

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

返回
`ITestStorageClient`

抛出
`GeneralSecurityException`
`IOException`

createInvocation

public Invocation createInvocation (Invocation invocation)

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

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

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

抛出
`IOException`

createLocalBuild

public Build createLocalBuild (Build localBuild)

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

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

返回
`Build`	`Build`

抛出
`IOException`

createWorkUnit

public WorkUnit createWorkUnit (WorkUnit workUnit)

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

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

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

抛出
`IOException`

createWorkUnits

public ImmutableList<WorkUnit> createWorkUnits (List<WorkUnit> workUnits)

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

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

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

抛出
`IOException`

fetchTestArtifact

public File fetchTestArtifact (String invocationId, 
                String resourceId)

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

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

返回
`File`

抛出
`IOException`

finalizeTestResults

public void finalizeTestResults ()

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

getInvocation

public Invocation getInvocation (String invocationId)

返回具有所提供调用 ID 的调用。

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

返回
`Invocation`

抛出
`IOException`

getTestArtifact

public BuildArtifactMetadata getTestArtifact (String invocationId, 
                String resourceId)

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

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

返回
`BuildArtifactMetadata`

抛出
`IOException`

getWorkUnit

public WorkUnit getWorkUnit (String workUnitId)

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

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

返回
`WorkUnit`

抛出
`IOException`

listTestArtifact

public TestArtifactListResponse listTestArtifact (String invocationId, 
                String artifactType)

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

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

返回
`TestArtifactListResponse`

抛出
`IOException`

updateInvocation

public Invocation updateInvocation (Invocation invocation)

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

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

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

抛出
`IOException`

updateTestArtifact

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

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

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

返回
`BuildArtifactMetadata`

抛出
`IOException`

updateTestArtifact

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

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

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

返回
`BuildArtifactMetadata`

抛出
`IOException`

updateWorkUnit

public WorkUnit updateWorkUnit (WorkUnit workUnit)

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

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

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

抛出
`IOException`

uploadAssociations

public void uploadAssociations (List<LogAssociation> associations, 
                int poolSize)

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

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

抛出
`IOException`

uploadResult

public void uploadResult (TestResult result)

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

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