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 |
void | runDevicePreInvocationSetup ( IInvocationContext context, IConfiguration config, ITestLogger logger) Appelez l' |
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 |
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
protectedgetLabPreparersToRun (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
protectedgetTargetPreparersToRun (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 |