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

InvocationExécution

public class InvocationExecution
extends Object implements IInvocationExecution

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

Sous-classes directes connues

DelegatedInvocationExecution , ParentSandboxInvocationExecution , RemoteInvocationExecution , SandboxedInvocationExecution

DelegatedInvocationExecutionDelegatedInvocationExecution	`InvocationExecution` qui délègue l'exécution à un autre binaire Tradefed.
ParentSandboxInvocationExecution	Version de `InvocationExecution` pour les actions spéciales d'appel parent lors de l'exécution d'un sandbox.
RemoteInvocationExecutionRemoteInvocationExecution	Implémentation de `InvocationExecution` qui pilote une exécution à distance.
SandboxedInvocationExecution	Exécution sandbox spéciale de l'invocation : il s'agit de l'InvocationExection lorsque nous sommes à l'intérieur du sandbox exécutant la commande.

Classe qui décrit toutes les étapes d'invocation : build download, target_prep, run tests, clean up. Peut être étendu pour remplacer le comportement par défaut de certaines étapes. L'ordre des étapes est piloté par TestInvocation .

Résumé

Des champs
`public static final String`	`ADB_VERSION_KEY`
`public static final String`	`JAVA_CLASSPATH_KEY`
`public static final String`	`JAVA_VERSION_KEY`

Constructeurs publics
`InvocationExecution ()`

Méthodes publiques
`void`	`cleanUpBuilds ( IInvocationContext context, IConfiguration config)` Exécutez l'étape de nettoyage 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 de 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'appel.
`void`	`reportLogs ( ITestDevice device, ITestLogger listener, TestInvocation.Stage stage)` Signalez certains journaux de périphérique à différentes étapes de l'appel.
`void`	`runDevicePostInvocationTearDown ( IInvocationContext context, IConfiguration config, Throwable exception)` Appelez `ITestDevice#postInvocationTearDown(Throwable)` pour chaque appareil faisant partie de l'appel.
`void`	`runDevicePreInvocationSetup ( IInvocationContext context, IConfiguration config, ITestLogger logger)` Appelez l' `ERROR(ITestDevice#preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice#preInvocationSetup(IBuildInfo))` pour chaque appareil faisant partie de l'appel.
`void`	`runTests ( TestInformation info, IConfiguration config, ITestInvocationListener listener)` Exécute le test.
`boolean`	`shardConfig ( IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)` Essayez de diviser la configuration en sous-configurations, à reprogrammer pour s'exécuter sur plusieurs ressources en parallèle.

Méthodes protégées
`void`	`collectAutoInfo ( IConfiguration config, TestInformation info)` Collectez automatiquement des informations sur l'appareil principal testé.
`IShardHelper`	`createShardHelper ()` Créez un retour de l' `IShardHelper` à utiliser.
`void`	`customizeDevicePreInvocation ( IConfiguration config, IInvocationContext context)` Donnez une chance de personnaliser une partie 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 de laboratoire à 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`	`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)` `runPreparersTearDown ( TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun, trackPreparersMap)` `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 de la balise de test sur les informations de construction.

Des champs

ADB_VERSION_KEY

public static final String ADB_VERSION_KEY

JAVA_CLASSPATH_KEY

public static final String JAVA_CLASSPATH_KEY

JAVA_VERSION_KEY

public static final String JAVA_VERSION_KEY

Constructeurs publics

InvocationExécution

public InvocationExecution ()

Méthodes publiques

cleanUpBuilds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

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

Paramètres
`context`	`IInvocationContext` : le `IInvocationContext` de l'invocation.
`config`	`IConfiguration` : la `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. Est-ce que les appareils nettoient.

Paramètres
`context`	`IInvocationContext` : le `IInvocationContext` de l'invocation.
`config`	`IConfiguration` : la `IConfiguration` de cette exécution de test.
`exception`	`Throwable` : l'exception d'origine levée par le test en cours d'exécution.

doSetup

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

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

Paramètres
`testInfo`	`TestInformation` : le `TestInformation` de l'invocation.
`config`	`IConfiguration` : la `IConfiguration` de cette exécution de test.
`listener`	`ITestLogger` : l' `ITestLogger` pour rapporter les journaux d'échecs d'installation.

Lance
`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. Les appareils se démontent-ils associés à la configuration.

Paramètres
`testInfo`	`TestInformation` : le `TestInformation` de l'invocation.
`config`	`IConfiguration` : la `IConfiguration` de cette exécution de test.
`logger`	`ITestLogger` : l' `ITestLogger` pour rapporter les logs.
`exception`	`Throwable` : l'exception d'origine levée par le test en cours d'exécution.

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` : le `TestInformation` de l'invocation.
`config`	`IConfiguration` : la `IConfiguration` de cette exécution de test.
`rescheduler`	`IRescheduler` : le `IRescheduler` , pour replanifier des parties de l'invocation pour exécution sur une ou plusieurs autres ressources
`listener`	`ITestInvocationListener` : `ITestInvocation` pour signaler les échecs de téléchargement de build.

Retour
`boolean`	Vrai si nous avons réussi à télécharger la construction, faux sinon.

Lance
`BuildRetrievalError`
`DeviceNotAvailableException`

rapportJournaux

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

Signalez certains journaux de périphérique à différentes étapes de l'appel. Par exemple : logcat.

Paramètres
`device`	`ITestDevice` : L'appareil à partir duquel signaler les journaux.
`listener`	`ITestLogger` : L'enregistreur pour les logs.
`stage`	`TestInvocation.Stage` : L'étape de l'invocation à laquelle nous sommes.

runDevicePostInvocationTearDown

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

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

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

runDevicePreInvocationSetup

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

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

Paramètres
`context`	`IInvocationContext` : le `IInvocationContext` de l'invocation.
`config`	`IConfiguration` : la `IConfiguration` de cette exécution de test.
`logger`	`ITestLogger` : l' `ITestLogger` pour rapporter les logs.

Lance
`DeviceNotAvailableException`
`TargetSetupError`

runTests

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

Exécute le test.

Paramètres
`info`	`TestInformation` : le `TestInformation` avec lequel exécuter les tests.
`config`	`IConfiguration` : la `IConfiguration` à exécuter
`listener`	`ITestInvocationListener` : l' `ITestInvocationListener` des résultats des tests

shardConfig

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

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

Si un nombre de partitions est supérieur à 1, il créera simplement des configurations pour chaque partition en définissant des index de partition et en les replanifiant. Si un nombre de fragments n'est pas défini, il reviendrait à IShardHelper#shardConfig .

Paramètres
`config`	`IConfiguration` : la `IConfiguration` courante.
`testInfo`	`TestInformation` : le `TestInformation` contenant les informations des tests.
`rescheduler`	`IRescheduler` : le `IRescheduler` .
`logger`	`ITestLogger` : `ITestLogger` utilisé pour enregistrer le fichier pendant le partitionnement.

Retour
`boolean`	true si le test a été fragmenté. Sinon retourner `false`

Méthodes protégées

collectAutoInfo

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

Collectez automatiquement des informations sur l'appareil principal testé.

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

Lance
`DeviceNotAvailableException`

createShardHelper

protected IShardHelper createShardHelper ()

Créez un retour de l' IShardHelper à utiliser.

Retour
`IShardHelper`

personnaliserDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

Donnez une chance de personnaliser une partie de l'appareil avant preInvocationSetup.

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

getAdbVersion

protected String getAdbVersion ()

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

Retour
`String`

getLabPreparersToRun

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

Récupérez la liste des préparateurs de laboratoire à exécuter sur cet appareil.

Remplacé dans les classes sandbox pour empêcher les préparateurs de laboratoire d'être exécutés à l'intérieur de l'enfant sandbox

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

Retour

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 sandbox pour empêcher les préparateurs de laboratoire d'être exécutés à l'intérieur de l'enfant sandbox

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

Retour

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`

Retour
`Throwable`

setTestTag

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

Gérer la définition de la balise de test sur les informations de construction.

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