À partir du 27 mars 2025, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main pour créer et contribuer à AOSP. Pour en savoir plus, consultez la section Modifications apportées à AOSP.

Cette page a été traduite par l'API Cloud Translation.

IInvocationExecution

public interface IInvocationExecution

com.android.tradefed.invoker.IInvocationExecution

Sous-classes indirectes connues

DelegatedInvocationExecution, InvocationExecution, ParentSandboxInvocationExecution, RemoteInvocationExecution, SandboxedInvocationExecution

DelegatedInvocationExecution	`InvocationExecution` qui délègue 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'appel parent lors de l'exécution d'un bac à sable.
RemoteInvocationExecution	Implémentation de `InvocationExecution` qui gère une exécution à distance.
SandboxedInvocationExecution	Exécution spéciale du bac à sable de l'appel: il s'agit de l'exécution de l'appel lorsque nous sommes dans le bac à sable et que nous exécutons la commande.

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

Résumé

Méthodes publiques
`default void`	`cleanUpBuilds(IInvocationContext context, IConfiguration config)` Exécutez l'étape de nettoyage 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 démontage 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'appel.
`abstract void`	`reportLogs(ITestDevice device, ITestLogger logger, TestInvocation.Stage stage)` Enregistrez certains journaux de l'appareil à différentes étapes de l'appel.
`default void`	`runDevicePostInvocationTearDown(IInvocationContext context, IConfiguration config, Throwable exception)` Appelez `ITestDevice.postInvocationTearDown(Throwable)` pour chaque partie de l'appareil de l'appel.
`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'appel.
`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 fractionnement de la configuration en sous-configurations, à reprogrammer pour s'exécuter sur plusieurs ressources en parallèle.

Méthodes publiques

cleanUpBuilds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

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

Paramètres
`context`	`IInvocationContext`: `IInvocationContext` de l'appel.
`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. Les appareils sont-ils nettoyés ?

Paramètres
`context`	`IInvocationContext`: `IInvocationContext` de l'appel.
`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. Effectue la configuration de tous les appareils requise pour l'exécution du test.

Paramètres
`testInfo`	`TestInformation`: `TestInformation` de l'appel.
`config`	`IConfiguration`: `IConfiguration` de cette exécution de test.
`logger`	`ITestLogger`: `ITestLogger` pour générer des journaux d'échec de configuration.

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

doTeardown

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

Exécutez l'étape de démontage de target_preparer et multi_target_preparer. Les appareils associés à la configuration sont-ils supprimés ?

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

Génère
	Jetable

fetchBuild

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

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

Paramètres
`testInfo`	`TestInformation`: `TestInformation` de l'appel.
`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 la compilation.

Renvoie
`boolean`	"True" si la compilation a bien été téléchargée, ou "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)

Enregistrez certains journaux de l'appareil à différentes étapes de l'appel. Par exemple: logcat.

Paramètres
`device`	`ITestDevice`: appareil à partir duquel envoyer les journaux.
`logger`	`ITestLogger`: enregistreur des journaux.
`stage`	`TestInvocation.Stage`: étape de l'appel à laquelle nous nous trouvons.

runDevicePostInvocationTearDown

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

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

Paramètres
`context`	`IInvocationContext`: `IInvocationContext` de l'appel.
`config`	`IConfiguration`: `IConfiguration` de cette exécution de test.
`exception`	`Throwable`: l'exception d'origine généré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'appel.

Paramètres
`context`	`IInvocationContext`: `IInvocationContext` de l'appel.
`config`	`IConfiguration`: `IConfiguration` de cette exécution de test.
`logger`	`ITestLogger`: `ITestLogger` pour générer des 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` avec lequel exécuter les tests.
`config`	`IConfiguration`: `IConfiguration` à exécuter
`listener`	`ITestInvocationListener`: `ITestInvocationListener` des résultats des tests

Génère
	Jetable

shardConfig

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

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

Si le nombre de fragments est supérieur à 1, il crée simplement des configurations pour chaque fragment en définissant des indices de fragment et les replanifie. Si aucun nombre de shards 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`: le `IRescheduler`.
`logger`	`ITestLogger`: `ITestLogger` utilisé pour journaliser le fichier lors du fractionnement.

Renvoie
`boolean`	"True" si le test a été fractionné. Sinon, renvoyez `false`.