À 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 dans AOSP, utilisez android-latest-release. 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.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

IInvocationExecution

public interface IInvocationExecution

com.android.tradefed.invoker.IInvocationExecution

Sous-classes indirectes connues

DelegatedInvocationExecution, InvocationExecution, ParentSandboxInvocationExecution, RemoteInvocationExecution, SandboxedInvocationExecution

DelegatedInvocationExecution	`InvocationExecution` qui délèguent l'exécution à un autre binaire Tradefed.
InvocationExecution	Classe qui décrit toutes les étapes d'invocation : téléchargement de la compilation, préparation de la cible, exécution des tests, nettoyage.
ParentSandboxInvocationExecution	Version de `InvocationExecution` pour les actions spéciales d'invocation parentale lors de l'exécution d'un bac à sable.
RemoteInvocationExecution	Implémentation de `InvocationExecution` qui pilote une exécution à distance.
SandboxedInvocationExecution	Exécution spéciale du bac à sable de l'invocation : il s'agit d'InvocationExection lorsque nous sommes dans le bac à sable en train d'exécuter la commande.

Interface décrivant les actions qui seront effectuées lors d'une invocation. L'invocation TestInvocation elle-même garantit l'ordre des appels.

Résumé

Méthodes publiques
`default void`	`cleanUpBuilds(IInvocationContext context, IConfiguration config)` Exécutez l'étape de nettoyage du build_provider.
`default void`	`doCleanUp(IInvocationContext context, IConfiguration config, Throwable exception)` Exécutez l'étape de nettoyage target_preparer et multi_target_preparer.
`default void`	`doSetup(TestInformation testInfo, IConfiguration config, ITestLogger logger)` Exécutez l'étape de configuration target_preparer et multi_target_preparer.
`default void`	`doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)` Exécutez l'étape de suppression de target_preparer et multi_target_preparer.
`default boolean`	`fetchBuild(TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)` Exécutez l'étape build_provider de l'invocation.
`abstract void`	`reportLogs(ITestDevice device, ITestLogger logger, TestInvocation.Stage stage)` Signalez certains journaux d'appareils à différentes étapes de l'invocation.
`default void`	`runDevicePostInvocationTearDown(IInvocationContext context, IConfiguration config, Throwable exception)` Appelez `ITestDevice.postInvocationTearDown(Throwable)` pour chaque partie de l'appareil de l'invocation.
`default void`	`runDevicePreInvocationSetup(IInvocationContext context, IConfiguration config, ITestLogger logger)` Appelez `ERROR(ITestDevice.preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice.preInvocationSetup(IBuildInfo))` pour chaque partie de l'appareil de l'invocation.
`default void`	`runTests(TestInformation info, IConfiguration config, ITestInvocationListener listener)` Exécute le test.
`default boolean`	`shardConfig(IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)` Tentative de partitionnement de la configuration en sous-configurations, à replanifier pour s'exécuter en parallèle sur plusieurs ressources.

Méthodes publiques

cleanUpBuilds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

Exécutez l'étape de nettoyage du build_provider. Associé à la récupération de la compilation.

Paramètres
`context`	`IInvocationContext` : `IInvocationContext` de l'invocation.
`config`	`IConfiguration` : `IConfiguration` de cette exécution de test.

doCleanUp

public void doCleanUp (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

Exécutez l'étape de nettoyage target_preparer et multi_target_preparer. L'appareil se nettoie.

Paramètres
`context`	`IInvocationContext` : `IInvocationContext` de l'invocation.
`config`	`IConfiguration` : `IConfiguration` de cette exécution de test.
`exception`	`Throwable` : exception d'origine générée par l'exécution du test.

doSetup

public void doSetup (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger logger)

Exécutez l'étape de configuration target_preparer et multi_target_preparer. Configure tous les appareils nécessaires à l'exécution du test.

Paramètres
`testInfo`	`TestInformation` : `TestInformation` de l'invocation.
`config`	`IConfiguration` : `IConfiguration` de cette exécution de test.
`logger`	`ITestLogger` : `ITestLogger` pour signaler les journaux d'échec de la configuration.

Génère
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.targetprep.BuildError
	com.android.tradefed.targetprep.TargetSetupError
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

doTeardown

public void doTeardown (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger logger, 
                Throwable exception)

Exécutez l'étape de suppression de target_preparer et multi_target_preparer. Démontage des appareils associés à la configuration.

Paramètres
`testInfo`	`TestInformation` : `TestInformation` de l'invocation.
`config`	`IConfiguration` : `IConfiguration` de cette exécution de test.
`logger`	`ITestLogger` : `ITestLogger` pour signaler les journaux.
`exception`	`Throwable` : exception d'origine générée par l'exécution du test.

Génère
	java.lang.Throwable
`Throwable`

fetchBuild

public boolean fetchBuild (TestInformation testInfo, 
                IConfiguration config, 
                IRescheduler rescheduler, 
                ITestInvocationListener listener)

Exécutez l'étape build_provider de l'invocation.

Paramètres
`testInfo`	`TestInformation` : `TestInformation` de l'invocation.
`config`	`IConfiguration` : `IConfiguration` de cette exécution de test.
`rescheduler`	`IRescheduler` : `IRescheduler`, pour reprogrammer des parties de l'appel à exécuter sur une ou plusieurs autres ressources
`listener`	`ITestInvocationListener` : `ITestInvocation` pour signaler les échecs de téléchargement de compilation.

Renvoie
`boolean`	"True" si la compilation a été téléchargée, "false" dans le cas contraire.

Génère
	com.android.tradefed.build.BuildRetrievalError
	com.android.tradefed.device.DeviceNotAvailableException
`BuildRetrievalError`
`DeviceNotAvailableException`

reportLogs

public abstract void reportLogs (ITestDevice device, 
                ITestLogger logger, 
                TestInvocation.Stage stage)

Signalez certains journaux d'appareils à différentes étapes de l'invocation. Par exemple : logcat.

Paramètres
`device`	`ITestDevice` : appareil à partir duquel les journaux doivent être signalés.
`logger`	`ITestLogger` : enregistreur des journaux.
`stage`	`TestInvocation.Stage` : étape de l'invocation.

runDevicePostInvocationTearDown

public void runDevicePostInvocationTearDown (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

Appelez ITestDevice.postInvocationTearDown(Throwable) pour chaque partie de l'appareil de l'invocation.

Paramètres
`context`	`IInvocationContext` : `IInvocationContext` de l'invocation.
`config`	`IConfiguration` : `IConfiguration` de cette exécution de test.
`exception`	`Throwable` : exception d'origine levée par l'exécution du test, le cas échéant.

runDevicePreInvocationSetup

public void runDevicePreInvocationSetup (IInvocationContext context, 
                IConfiguration config, 
                ITestLogger logger)

Appelez ERROR(ITestDevice.preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice.preInvocationSetup(IBuildInfo)) pour chaque partie de l'appareil de l'invocation.

Paramètres
`context`	`IInvocationContext` : `IInvocationContext` de l'invocation.
`config`	`IConfiguration` : `IConfiguration` de cette exécution de test.
`logger`	`ITestLogger` : `ITestLogger` pour signaler les journaux.

Génère
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.targetprep.TargetSetupError
`DeviceNotAvailableException`
`TargetSetupError`

runTests

public void runTests (TestInformation info, 
                IConfiguration config, 
                ITestInvocationListener listener)

Exécute le test.

Paramètres
`info`	`TestInformation` : `TestInformation` à utiliser pour exécuter les tests.
`config`	`IConfiguration` : `IConfiguration` à exécuter
`listener`	`ITestInvocationListener` : `ITestInvocationListener` des résultats du test

Génère
	java.lang.Throwable
`Throwable`

shardConfig

public boolean shardConfig (IConfiguration config, 
                TestInformation testInfo, 
                IRescheduler rescheduler, 
                ITestLogger logger)

Tentative de partitionnement de la configuration en sous-configurations, à replanifier pour s'exécuter en parallèle sur plusieurs ressources.

Si le nombre de partitions est supérieur à 1, des configurations seront créées pour chaque partition en définissant les index de partition et en les replanifiant. Si aucun nombre de partitions n'est défini,la valeur par défaut est IShardHelper.shardConfig.

Paramètres
`config`	`IConfiguration` : `IConfiguration` actuel.
`testInfo`	`TestInformation` : `TestInformation` contenant les informations sur les tests.
`rescheduler`	`IRescheduler` : `IRescheduler`.
`logger`	`ITestLogger` : `ITestLogger` utilisé pour enregistrer le fichier lors du partitionnement.

Renvoie
`boolean`	"true" si le test a été fragmenté. Sinon, renvoie `false`.