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

客戶

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( 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`

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)

更新 Test Storage 中提供的作業單元。

參數
`workUnit`	`WorkUnit`：- 要更新的工作單元。

傳回
`WorkUnit`	更新工作單元。

uploadAssociations

public void uploadAssociations ( associations, 
                int poolSize)

上傳記錄檔與測試/工作單元之間的關聯。Android 測試儲存空間可透過關聯，追蹤產生記錄的測試。

參數
`associations`	：記錄檔清單及其關聯。
`poolSize`	`int`：用於平行上傳的工作站集區大小。0 代表不進行平行上傳。

uploadResult

public void uploadResult (TestResult result)

將提供的測試結果上傳至測試儲存空間。測試結果必須是先前建立的叫用項目。

參數
`result`	`TestResult`：- 要上傳的結果。