為配合主幹穩定開發模型，並確保生態系統的平台穩定性，我們將自 2026 年起，在第 2 季和第 4 季將原始碼發布至 AOSP。如要建構及貢獻 AOSP，請使用 android-latest-release。android-latest-release 資訊清單分支版本一律會參照推送至 Android 開放原始碼計畫的最新版本。詳情請參閱「Android 開放原始碼計畫變更」。

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 Test 儲存空間用戶端，可將測試結果上傳至 Test Storage 服務。

摘要

公用方法
`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`

擲回
`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`：- 要上傳的結果。