À 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.

ITestStorageClient

public interface ITestStorageClient

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

Sous-classes indirectes connues

Client

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

Interface pour communiquer avec le backend Android Test Storage. L'interface contient des méthodes permettant de créer et de mettre à jour des appels et des unités de travail, et d'importer les résultats des tests. Pour créer ou mettre à jour des unités de travail ou des résultats de tests, ils doivent appartenir à une invocation qui a été créée par ce client ou l'invocation doit être ajoutée à l'aide de la méthode addInvocation.

Résumé

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

Méthodes publiques

createInvocation

public abstract 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.

Génère
	IOException

createLocalBuild

public abstract Build createLocalBuild (Build localBuild)

Insérez un build local dans le backend.

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

Renvoie
`Build`	`Build`

Génère
	IOException

createWorkUnit

public abstract 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.

Génère
	IOException

createWorkUnits

public abstract 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.

Génère
	IOException

fetchTestArtifact

public abstract 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 abstract void finalizeTestResults ()

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

getInvocation

public abstract 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`

Génère
	- si l'invocation fournie est introuvable ou si une erreur de communication avec le backend se produit.

getTestArtifact

public abstract 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 abstract 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`

Génère
	- si l'unité de travail fournie est introuvable ou si une erreur s'est produite lors de la communication avec les services de backend.

listTestArtifact

public abstract 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 abstract 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.

Génère
	IOException

updateTestArtifact

public abstract 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 abstract 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 abstract 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.

Génère
	IOException

uploadAssociations

public abstract 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.

Génère
	IOException

uploadResult

public abstract 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.

Génère
	IOException