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

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. Peut être étendu pour remplacer le comportement par défaut de certaines étapes. L'ordre des étapes est déterminé par TestInvocation.

Résumé

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 target_preparer et multi_target_preparer.
`void`	`doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)` Exécutez l'étape de démontage de 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)` Enregistrez certains journaux de l'appareil à différentes étapes de l'appel.
`void`	`runDevicePostInvocationTearDown(IInvocationContext context, IConfiguration config, Throwable exception)` Appelez `ITestDevice.postInvocationTearDown(Throwable)` pour chaque partie de l'appareil de l'appel.
`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.
`void`	`runTests(TestInformation info, IConfiguration config, ITestInvocationListener listener)` Exécute le test.
`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 protégées
`void`	`collectAutoInfo(IConfiguration config, TestInformation info)` Collectez automatiquement certaines informations sur l'appareil principal testé.
`IShardHelper`	`createShardHelper()` Créez un élément et renvoyez l'`IShardHelper` à utiliser.
`void`	`customizeDevicePreInvocation(IConfiguration config, IInvocationContext context)` Permet de personnaliser certains éléments de l'appareil avant preInvocationSetup.
`String`	`getAdbVersion()` Renvoie la version d'adb utilisée pour l'appel.
	`getLabPreparersToRun(IConfiguration config, String deviceName)` Récupérez la liste des préparateurs d'ateliers à exécuter sur cet appareil.
	`getTargetPreparersToRun(IConfiguration config, String deviceName)` Récupérez la liste des 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 de la balise de test sur les informations de compilation.

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

InvocationExecution

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

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.
`listener`	`ITestLogger`: `ITestLogger` pour générer des journaux d'échec de 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 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.

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
`BuildRetrievalError`
`DeviceNotAvailableException`

reportLogs

public void reportLogs (ITestDevice device, 
                ITestLogger listener, 
                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.
`listener`	`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
`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

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

Méthodes protégées

collectAutoInfo

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

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

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

Génère
`DeviceNotAvailableException`

createShardHelper

protected IShardHelper createShardHelper ()

Créez un élément et renvoyez l'IShardHelper à utiliser.

Renvoie
`IShardHelper`

customizeDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

Permet de personnaliser certains éléments 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 d'adb utilisée pour l'appel.

Renvoie
`String`

getLabPreparersToRun

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

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

Remplacement 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 la liste des préparateurs cibles à exécuter sur cet appareil.

Remplacement 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érer la définition de la balise de test sur les informations de compilation.

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