À partir de 2026, pour nous aligner sur notre modèle de développement stable et garantir la stabilité de la plate-forme pour l'écosystème, nous publierons le code source sur AOSP au deuxième et au quatrième trimestre. Pour créer et contribuer à AOSP, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main. La branche de fichier manifeste android-latest-release fera toujours référence à la version la plus récente envoyée à AOSP. Pour en savoir plus, consultez Modifications apportées à AOSP.

Client

public final class Client
extends Object implements ITestStorageClient

java.lang.Object
↳	com.google.android.tradefed.result.teststorage.Client

Client de stockage de tests Android qui importe les résultats des tests dans le service Test Storage.

Résumé

Méthodes publiques
`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)` Crée une invocation dans Test Storage à l'aide des données de l'invocation fournie.
`Build`	`createLocalBuild(Build localBuild)` Pour en savoir plus, consultez go/local_build_guide.
`WorkUnit`	`createWorkUnit(WorkUnit workUnit)` Crée une unité de travail dans Test Storage.
`ImmutableList<WorkUnit>`	`createWorkUnits( workUnits)` Crée toutes les unités de travail d'une liste fournie dans TestStorage.
`File`	`fetchTestArtifact(String invocationId, String resourceId)` Récupère et renvoie le fichier d'artefact de test demandé.
`void`	`finalizeTestResults()` Attend que tous les résultats des tests soient importés.
`Invocation`	`getInvocation(String invocationId)` Renvoie une invocation qui possède l'ID d'invocation fourni.
`BuildArtifactMetadata`	`getTestArtifact(String invocationId, String resourceId)` Renvoie un artefact de test correspondant à l'invocation et à l'ID de ressource fournis.
`WorkUnit`	`getWorkUnit(String workUnitId)` Renvoie une unité de travail correspondant à l'ID fourni.
`TestArtifactListResponse`	`listTestArtifact(String invocationId, String artifactType)` Recherche et liste tous les artefacts de test correspondant au type fourni.
`Invocation`	`updateInvocation(Invocation invocation)` Met à jour une invocation dans Test Storage à l'aide des données de l'invocation fournie.
`BuildArtifactMetadata`	`updateTestArtifact(String invocationId, String workUnitId, String testResultId, BuildArtifactMetadata artifact, long legacyId)` Met à jour l'artefact fourni.
`BuildArtifactMetadata`	`updateTestArtifact(BuildArtifactMetadata artifact, long legacyId, AbstractInputStreamContent content)` Met à jour l'artefact fourni et importe le contenu fourni.
`WorkUnit`	`updateWorkUnit(WorkUnit workUnit)` Met à jour une unité de travail fournie dans Test Storage.
`void`	`uploadAssociations( associations, int poolSize)` Importe les associations entre les journaux et les tests/unités de travail.
`void`	`uploadResult(TestResult result)` Importez le résultat du test fourni dans Test Storage.

Méthodes publiques

create

public static ITestStorageClient create (String buildEnvironment, 
                boolean useLegacyMigration, 
                boolean enableUploadThread, 
                boolean useBatchApi, 
                int maxBatchSize, 
                int insertBatchSize)

Paramètres
`buildEnvironment`	`String`
`useLegacyMigration`	`boolean`
`enableUploadThread`	`boolean`
`useBatchApi`	`boolean`
`maxBatchSize`	`int`
`insertBatchSize`	`int`

Renvoie
`ITestStorageClient`

create

public static ITestStorageClient create (Androidbuildinternal client)

Paramètres
`client`	`Androidbuildinternal`

Renvoie
`ITestStorageClient`

create

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

Paramètres
`buildEnvironment`	`String`
`useLegacyMigration`	`boolean`
`enableUploadThread`	`boolean`
`useBatchApi`	`boolean`

Renvoie
`ITestStorageClient`

create

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

Paramètres
`buildEnvironment`	`String`
`useLegacyMigration`	`boolean`
`useBatchApi`	`boolean`

Renvoie
`ITestStorageClient`

createInvocation

public Invocation createInvocation (Invocation invocation)

Crée une invocation dans Test Storage à l'aide des données de l'invocation fournie.

Paramètres
`invocation`	`Invocation` : décrit l'invocation à créer.

Renvoie
`Invocation`	invocation créée dans Test Storage.

createLocalBuild

public Build createLocalBuild (Build localBuild)

Pour en savoir plus, consultez go/local_build_guide.

Paramètres
`localBuild`	`Build` : description de la compilation locale

Renvoie
`Build`	`Build`

createWorkUnit

public WorkUnit createWorkUnit (WorkUnit workUnit)

Crée une unité de travail dans Test Storage.

Paramètres
`workUnit`	`WorkUnit` : décrit l'unité de travail à créer.

Renvoie
`WorkUnit`	une nouvelle unité de travail.

createWorkUnits

public ImmutableList<WorkUnit> createWorkUnits ( workUnits)

Crée toutes les unités de travail d'une liste fournie dans TestStorage.

Paramètres
`workUnits`	: liste des unités de travail à créer.

Renvoie
`ImmutableList<WorkUnit>`	Liste des unités de travail créées.

fetchTestArtifact

public File fetchTestArtifact (String invocationId, 
                String resourceId)

Récupère et renvoie le fichier d'artefact de test demandé.

Paramètres
`invocationId`	`String`
`resourceId`	`String`

Renvoie
`File`

finalizeTestResults

public void finalizeTestResults ()

Attend que tous les résultats des tests soient importés.

getInvocation

public Invocation getInvocation (String invocationId)

Renvoie une invocation qui possède l'ID d'invocation fourni.

Paramètres
`invocationId`	`String` : ID de l'appel à renvoyer.

Renvoie
`Invocation`

getTestArtifact

public BuildArtifactMetadata getTestArtifact (String invocationId, 
                String resourceId)

Renvoie un artefact de test correspondant à l'invocation et à l'ID de ressource fournis.

Paramètres
`invocationId`	`String`
`resourceId`	`String`

Renvoie
`BuildArtifactMetadata`

getWorkUnit

public WorkUnit getWorkUnit (String workUnitId)

Renvoie une unité de travail correspondant à l'ID fourni.

Paramètres
`workUnitId`	`String` : ID de l'unité de travail.

Renvoie
`WorkUnit`

listTestArtifact

public TestArtifactListResponse listTestArtifact (String invocationId, 
                String artifactType)

Recherche et liste tous les artefacts de test correspondant au type fourni.

Paramètres
`invocationId`	`String`
`artifactType`	`String`

Renvoie
`TestArtifactListResponse`

updateInvocation

public Invocation updateInvocation (Invocation invocation)

Met à jour une invocation dans Test Storage à l'aide des données de l'invocation fournie.

Paramètres
`invocation`	`Invocation` : invocation avec des données mises à jour.

Renvoie
`Invocation`	une invocation mise à jour.

updateTestArtifact

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

Met à jour l'artefact fourni. Cette méthode ne met à jour que l'association et ne modifie pas le contenu. Lorsque vous appelez cette méthode, fournissez l'ID d'invocation d'origine, l'ID d'unité de travail et l'ID de résultat du test en tant qu'arguments. Placez le nouvel ID d'unité de travail et de résultat de test dans l'objet BuildArtifactMetadata. Lorsque l'ID d'unité de travail et/ou le résultat du test ne sont pas utilisés dans l'association, ils doivent être définis sur une chaîne vide ("").

Paramètres
`invocationId`	`String`
`workUnitId`	`String`
`testResultId`	`String`
`artifact`	`BuildArtifactMetadata`
`legacyId`	`long`

Renvoie
`BuildArtifactMetadata`

updateTestArtifact

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

Met à jour l'artefact fourni et importe le contenu fourni. Lorsque vous importez du contenu, il n'est pas possible de mettre à jour les données d'association. Ne modifiez pas l'ID de l'unité de travail ni l'ID du résultat du test déjà définis dans l'argument BuildArtifactMetadata.

Paramètres
`artifact`	`BuildArtifactMetadata`
`legacyId`	`long`
`content`	`AbstractInputStreamContent`

Renvoie
`BuildArtifactMetadata`

updateWorkUnit

public WorkUnit updateWorkUnit (WorkUnit workUnit)

Met à jour une unité de travail fournie dans Test Storage.

Paramètres
`workUnit`	`WorkUnit` : unité de travail à mettre à jour.

Renvoie
`WorkUnit`	unité de travail mise à jour.

uploadAssociations

public void uploadAssociations ( associations, 
                int poolSize)

Importe les associations entre les journaux et les tests/unités de travail. Les associations permettent à Android Test Storage de suivre le test qui a produit un journal.

Paramètres
`associations`	: liste des fichiers journaux et de leurs associations.
`poolSize`	`int` : taille du pool de nœuds de calcul utilisé pour l'importation parallèle. 0 pour désactiver l'importation parallèle.

uploadResult

public void uploadResult (TestResult result)

Importez le résultat du test fourni dans Test Storage. Le résultat du test doit faire partie d'un appel créé précédemment.

Paramètres
`result`	`TestResult` : résultat à importer.