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

ITestStorageClient

public interface ITestStorageClient

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

已知間接子類別

用戶端

用戶端	Android Test 儲存空間用戶端，可將測試結果上傳至 Test Storage 服務。

與 Android Test Storage 後端通訊的介面。這個介面包含建立及更新呼叫和工作單元，以及上傳測試結果的方法。如要建立或更新工作單元或測試結果，這些項目必須屬於由這個用戶端建立的叫用，或是使用 addInvocation 方法新增的叫用。

摘要

公用方法
`abstract Invocation`	`createInvocation(Invocation invocation)` 使用提供的調用中的資料，在測試儲存空間中建立調用。
`abstract Build`	`createLocalBuild(Build localBuild)` 在後端插入本機建構版本。
`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)

在後端插入本機建構版本。

參數
`localBuild`	`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)

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

參數
`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