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

InvocationExecution

public class InvocationExecution
extends Object implements IInvocationExecution

java.lang.Object
↳	com.android.tradefed.invoker.InvocationExecution

Sous-classes directes connues

DelegatedInvocationExecution, ParentSandboxInvocationExecution, RemoteInvocationExecution, SandboxedInvocationExecution

DelegatedInvocationExecution	`InvocationExecution` qui délèguent l'exécution à un autre binaire Tradefed.
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.

Classe qui décrit toutes les étapes d'invocation : téléchargement de la compilation, préparation de la cible, exécution des tests et nettoyage. Peut être étendu pour remplacer le comportement par défaut de certaines étapes. L'ordre des étapes est déterminé par TestInvocation.

Résumé

Constantes
`String`	`ADB_VERSION_KEY`
`String`	`JAVA_CLASSPATH_KEY`
`String`	`JAVA_VERSION_KEY`

Constructeurs publics
`InvocationExecution()`

Méthodes publiques
`void`	`cleanUpBuilds(IInvocationContext context, IConfiguration config)` Exécutez l'étape de nettoyage du build_provider.
`void`	`doCleanUp(IInvocationContext context, IConfiguration config, Throwable exception)` Exécutez l'étape de nettoyage target_preparer et multi_target_preparer.
`void`	`doSetup(TestInformation testInfo, IConfiguration config, ITestLogger listener)` Exécutez l'étape de configuration target_preparer et multi_target_preparer.
`void`	`doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)` Exécutez l'étape de démontage target_preparer et multi_target_preparer.
`boolean`	`fetchBuild(TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)` Exécutez l'étape build_provider de l'invocation.
`void`	`reportLogs(ITestDevice device, ITestLogger listener, TestInvocation.Stage stage)` Signalez certains journaux d'appareils à différentes étapes de l'invocation.
`void`	`runDevicePostInvocationTearDown(IInvocationContext context, IConfiguration config, Throwable exception)` Appelez `ITestDevice.postInvocationTearDown(Throwable)` pour chaque partie de l'appareil de l'invocation.
`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.
`void`	`runTests(TestInformation info, IConfiguration config, ITestInvocationListener listener)` Exécute le test.
`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 protégées
`void`	`collectAutoInfo(IConfiguration config, TestInformation info)` Collecter automatiquement certaines informations sur l'appareil principal testé.
`IShardHelper`	`createShardHelper()` Créez et renvoyez le `IShardHelper` à utiliser.
`void`	`customizeDevicePreInvocation(IConfiguration config, IInvocationContext context)` Permet de personnaliser certains aspects de l'appareil avant preInvocationSetup.
`String`	`getAdbVersion()` Renvoie la version adb utilisée pour l'appel.
	`getLabPreparersToRun(IConfiguration config, String deviceName)` Récupérez la liste des préparateurs d'atelier à exécuter sur cet appareil.
	`getTargetPreparersToRun(IConfiguration config, String deviceName)` Récupérez une liste de préparateurs cibles à exécuter sur cet appareil.
`void`	`linkExternalDirs(IBuildInfo info, TestInformation testInfo)`
`void`	`logHostAdb(IConfiguration config, ITestLogger logger)` Collectez les journaux à partir de $TMPDIR/adb.$UID.log.
`Throwable`	`runPreparersTearDown(TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun, trackPreparersMap)`
`void`	`setTestTag(IBuildInfo info, IConfiguration config)` Gérer la définition du tag de test dans les informations de compilation.

Constantes

ADB_VERSION_KEY

public static final String ADB_VERSION_KEY

Valeur de constante : "adb_version"

JAVA_CLASSPATH_KEY

public static final String JAVA_CLASSPATH_KEY

Valeur constante : "java_classpath"

JAVA_VERSION_KEY

public static final String JAVA_VERSION_KEY

Valeur de constante : "java_version"

Constructeurs publics

InvocationExecution

public InvocationExecution ()

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 listener)

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.
`listener`	`ITestLogger` : `ITestLogger` pour signaler les journaux d'échec de la configuration.

Génère
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

doTeardown

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

Exécutez l'étape de démontage 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.

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 le téléchargement de la version a réussi, "false" dans le cas contraire.

Génère
`BuildRetrievalError`
`DeviceNotAvailableException`

reportLogs

public void reportLogs (ITestDevice device, 
                ITestLogger listener, 
                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.
`listener`	`ITestLogger` : enregistreur des journaux.
`stage`	`TestInvocation.Stage` : étape de l'invocation à 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'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
`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` : le `IConfiguration` à exécuter
`listener`	`ITestInvocationListener` : `ITestInvocationListener` des résultats du test

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 simplement 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`.

Méthodes protégées

collectAutoInfo

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

Collecter automatiquement certaines informations sur l'appareil principal testé.

Paramètres
`config`	`IConfiguration`
`info`	`TestInformation`

Génère
`DeviceNotAvailableException`

createShardHelper

protected IShardHelper createShardHelper ()

Créez et renvoyez le IShardHelper à utiliser.

Renvoie
`IShardHelper`

customizeDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

Permet de personnaliser certains aspects de l'appareil avant preInvocationSetup.

Paramètres
`config`	`IConfiguration` : configuration de l'appel.
`context`	`IInvocationContext` : contexte d'appel actuel.

getAdbVersion

protected String getAdbVersion ()

Renvoie la version adb utilisée pour l'appel.

Renvoie
`String`

getLabPreparersToRun

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

Récupérez la liste des préparateurs d'atelier à exécuter sur cet appareil.

Remplacé dans les classes de bac à sable pour empêcher l'exécution des préparateurs d'atelier dans l'enfant du bac à sable

Paramètres
`config`	`IConfiguration`
`deviceName`	`String`

Renvoie

getTargetPreparersToRun

protected  getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

Récupérez une liste de préparateurs cibles à exécuter sur cet appareil.

Remplacé dans les classes de bac à sable pour empêcher l'exécution des préparateurs d'atelier dans l'enfant du bac à sable

Paramètres
`config`	`IConfiguration`
`deviceName`	`String`

Renvoie

linkExternalDirs

protected void linkExternalDirs (IBuildInfo info, 
                TestInformation testInfo)

Paramètres
`info`	`IBuildInfo`
`testInfo`	`TestInformation`

logHostAdb

protected void logHostAdb (IConfiguration config, 
                ITestLogger logger)

Collectez les journaux à partir de $TMPDIR/adb.$UID.log.

Paramètres
`config`	`IConfiguration`
`logger`	`ITestLogger`

runPreparersTearDown

protected Throwable runPreparersTearDown (TestInformation testInfo, 
                ITestDevice device, 
                String deviceName, 
                int deviceIndex, 
                ITestLogger logger, 
                Throwable exception, 
                 preparersToRun, 
                 trackPreparersMap)

Paramètres
`testInfo`	`TestInformation`
`device`	`ITestDevice`
`deviceName`	`String`
`deviceIndex`	`int`
`logger`	`ITestLogger`
`exception`	`Throwable`
`preparersToRun`
`trackPreparersMap`

Renvoie
`Throwable`

setTestTag

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

Gérez la définition du tag de test dans les informations de compilation.

Paramètres
`info`	`IBuildInfo`
`config`	`IConfiguration`