InvocationExécution

public class InvocationExecution
extends Object implements IInvocationExecution

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


Classe qui décrit toutes les étapes d'invocation : téléchargement de build, target_prep, exécution de 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é

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 les étapes 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’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 périphérique faisant partie de l’invocation.

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'invocation.

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 certaines informations sur l'appareil principal testé.

IShardHelper createShardHelper ()

Créez un retour du 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 adb utilisée pour l'appel.

getLabPreparersToRun ( IConfiguration config, String deviceName)

Récupérez une 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érez la définition de la balise de test sur les informations de build.

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 ce test.

faireNettoyer

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.

Paramètres
context IInvocationContext : le IInvocationContext de l'invocation.

config IConfiguration : la IConfiguration de ce test.

exception Throwable : l'exception d'origine levée par le test en cours d'exécution.

faireConfiguration

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 requis pour l'exécution du test.

Paramètres
testInfo TestInformation : la TestInformation de l’invocation.

config IConfiguration : la IConfiguration de ce test.

listener ITestLogger : le ITestLogger pour signaler les journaux d'échecs d'installation.

Jetés
BuildError
DeviceNotAvailableException
TargetSetupError

faireDémontage

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 sont-ils démontés associés à l'installation ?

Paramètres
testInfo TestInformation : la TestInformation de l’invocation.

config IConfiguration : la IConfiguration de ce test.

logger ITestLogger : le ITestLogger pour signaler les journaux.

exception Throwable : l'exception d'origine levée par le test en cours d'exécution.

récupérerBuild

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

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

Paramètres
testInfo TestInformation : la TestInformation de l’invocation.

config IConfiguration : la IConfiguration de ce test.

rescheduler IRescheduler : le IRescheduler , pour replanifier des parties de l'invocation pour exécution sur une ou plusieurs autres ressources.

listener ITestInvocationListener : l' ITestInvocation pour signaler les échecs de téléchargement de build.

Retour
boolean Vrai si nous avons téléchargé avec succès la version, faux sinon.

Jetés
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 : appareil à partir duquel signaler les journaux.

listener ITestLogger : Le logger pour les logs.

stage TestInvocation.Stage : L'étape de l'invocation à laquelle nous nous trouvons.

runDevicePostInvocationTearDown

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

Appelez ITestDevice#postInvocationTearDown(Throwable) pour chaque périphérique faisant partie de l’invocation.

Paramètres
context IInvocationContext : le IInvocationContext de l'invocation.

config IConfiguration : la IConfiguration de ce 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'invocation.

Paramètres
context IInvocationContext : le IInvocationContext de l'invocation.

config IConfiguration : la IConfiguration de ce test.

logger ITestLogger : le ITestLogger pour signaler les journaux.

Jetés
DeviceNotAvailableException
TargetSetupError

exécuter des tests

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 : le ITestInvocationListener des résultats de 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 les replanifiera. Si un nombre de partitions n'est pas défini, il reviendra à IShardHelper#shardConfig .

Paramètres
config IConfiguration : la IConfiguration actuelle.

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 vrai si le test a été fragmenté. Sinon, retourne 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

Jetés
DeviceNotAvailableException

créerShardHelper

protected IShardHelper createShardHelper ()

Créez un retour du IShardHelper à utiliser.

Retour
IShardHelper

personnaliserDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

Donnez la possibilité 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 une liste des préparateurs de laboratoire à exécuter sur cet appareil.

Remplacé dans les classes sandbox pour empêcher l'exécution des préparateurs de laboratoire dans 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 l'exécution des préparateurs de laboratoire dans 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

définirTestTag

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

Gérez la définition de la balise de test sur les informations de build.

Paramètres
info IBuildInfo

config IConfiguration