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

Exécution de l'appel

public class InvocationExecution
extends Object implements IInvocationExecution

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

Sous-classes directes connues

DéléguésInvocationExecution, ParentSandboxInvocationExecution, RemoteInvocationExecution et SandboxedInvocationExecution.

DeclativeInvocationExecution	`InvocationExecution`, qui délèguent 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'une dans l'environnement de bac à sable.
RemoteInvocationExecution	Implémentation de `InvocationExecution` qui génère une exécution à distance.
SandboxedInvocationExecution	Exécution spéciale de l'appel dans le bac à sable: il s'agit de l'InvocationExection lorsque nous dans le bac à sable en exécutant la commande.

Classe qui décrit toutes les étapes d'appel: téléchargement de la compilation, target_prep, 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 les étapes de nettoyage "target_preparer" et "multi_target_preparer".
`void`	`doSetup(TestInformation testInfo, IConfiguration config, ITestLogger listener)` Exécutez les étapes de configuration target_preparer et multi_target_preparer.
`void`	`doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)` Exécutez l'étape de suppression 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)` Signalez certains journaux d'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 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 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 segmentation de la configuration en sous-configurations, dont l'exécution sera reprogrammée 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 retour `IShardHelper` à utiliser.
`void`	`customizeDevicePreInvocation(IConfiguration config, IInvocationContext context)` Donnez la possibilité de personnaliser une partie de l'appareil avant preInvocationSetup.
`String`	`getAdbVersion()` Renvoie la version d'adb utilisée pour l'appel.
	`getLabPreparersToRun(IConfiguration config, String deviceName)` Récupère la liste des préparateurs d'atelier à 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)` Récupérez les journaux 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érez la définition du tag de test dans les informations de compilation.

Champs

ADB_VERSION_KEY

public static final String ADB_VERSION_KEY

CLÉ DU CHEMIN D'ACCÈS À LA CLASSE_JAVA

public static final String JAVA_CLASSPATH_KEY

VERSION_JAVA_KEY

public static final String JAVA_VERSION_KEY

Constructeurs publics

Exécution de l'appel

public InvocationExecution ()

Méthodes publiques

cleanUpBuilds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

Exécutez l'étape de nettoyage build_provider. Associé à l'extraction de la compilation.

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 les étapes de nettoyage "target_preparer" et "multi_target_preparer". Est-ce que les appareils nettoient vers le haut.

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 le test en cours d'exécution.

doSetup

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

Exécutez les étapes de configuration target_preparer et multi_target_preparer. Est-ce que tous les appareils se configurent nécessaires à 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 signaler les journaux des échecs de configuration.

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

suppression

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

Exécutez l'étape de suppression de target_preparer et multi_target_preparer. Les appareils se déchirent-ils ? associées à la configuration.

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 rapports sur les journaux.
`exception`	`Throwable`: exception d'origine générée par le test en cours d'exécution.

Extraire

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`, permettant de reprogrammer des parties de l'appel pour exécution sur une ou plusieurs autres ressources
`listener`	`ITestInvocationListener`: `ITestInvocation` pour signaler les échecs de téléchargement de compilation.

Renvoie
`boolean`	"True" si le build a bien été téléchargé, "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'appareil à différentes étapes de l'appel. Par exemple: Logcat.

Paramètres
`device`	`ITestDevice`: appareil à partir duquel les journaux sont générés.
`listener`	`ITestLogger`: enregistreur pour les journaux.
`stage`	`TestInvocation.Stage`: étape de l'appel à laquelle nous nous trouvons.

runDevicePostInvocationSupprimer

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

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

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 le test en cours d'exécution, 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 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 rapports sur les journaux.

Génère
`DeviceNotAvailableException`
`TargetSetupError`

exécuter des tests

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 du test

Configuration de segment

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

Tentative de segmentation de la configuration en sous-configurations, dont l'exécution sera reprogrammée plusieurs ressources en parallèle.

Si le nombre de segments est supérieur à 1, des configurations sont simplement créées pour chaque segment en définir des index de segment et les replanifier. Si aucun nombre de segments n'est défini, IShardHelper#shardConfig

Paramètres
`config`	`IConfiguration`: `IConfiguration` actuelle.
`testInfo`	`TestInformation`: `TestInformation` contenant les informations sur les tests.
`rescheduler`	`IRescheduler`: `IRescheduler`.
`logger`	`ITestLogger`: `ITestLogger` utilisé pour journaliser le fichier lors de la segmentation.

Renvoie
`boolean`	Valeur true si le test a été segmenté. Sinon, renvoyez `false`

Méthodes protégées

collecterAutoInfo

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 retour IShardHelper à utiliser.

Renvoie
`IShardHelper`

customDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

Donnez la possibilité de personnaliser une partie de l'appareil avant preInvocationSetup.

Paramètres
`config`	`IConfiguration`: configuration de l'appel.
`context`	`IInvocationContext`: contexte de l'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ère la liste des préparateurs d'atelier à exécuter sur cet appareil.

Remplacé dans les classes du bac à sable pour empêcher les préparateurs d'atelier de s'exécuter dans le bac à sable. enfant

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.

Remplacé dans les classes du bac à sable pour empêcher les préparateurs d'atelier de s'exécuter dans le bac à sable. enfant

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)

Récupérez les journaux 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`