InvocationExécution

public class InvocationExecution
extends Object implements IInvocationExecution en implements IInvocationExecution

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

Sous-classes directes connues DelegatedInvocationExecution , ParentSandboxInvocationExecution , RemoteInvocationExecution , SandboxedInvocationExecution DéléguéInvocationExécution InvocationExecution qui déléguer l'exécution à un autre binaire Tradefed. ParentSandboxInvocationExécution Version de InvocationExecution pour les actions spéciales d'invocation de parent lors de l' exécution d' un bac à sable. RemoteInvocationExecution La mise en œuvre de InvocationExecution qui entraîne une exécution à distance. SandboxInvocationExécution Exécution spéciale de l'invocation en sandbox : il s'agit de l'InvocationExection lorsque nous sommes à l'intérieur du sandbox en cours d'exécution de la commande.

---

Classe qui décrit toutes les étapes d'appel : téléchargement de build, target_prep, run tests, clean up. Peut être étendu pour remplacer le comportement par défaut de certaines étapes. Ordre des étapes est entraîné par TestInvocation .

Sommaire

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 les étapes de configuration target_preparer et multi_target_preparer.
void	doTeardown (TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception) Exécutez les étapes de suppression 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) Invoquer le ITestDevice#postInvocationTearDown(Throwable) pour chaque partie de l' appareil de l'invocation.
void	runDevicePreInvocationSetup (IInvocationContext context, IConfiguration config, ITestLogger logger) Invoke l' 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'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 fragmenter la configuration en sous-configurations, à replanifier 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 le périphérique principal testé.
IShardHelper	createShardHelper () Créer un retour de la 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.
	getPreparersToRun ( IConfiguration config, String deviceName) Récupérez une liste de préparateurs à exécuter sur cet appareil.
void	logHostAdb ( IConfiguration config, ITestLogger logger) Collectez les journaux de $TMPDIR/adb.$UID.log.
void	runPreparersSetup (TestInformation testInfo, IConfiguration config, ITestLogger listener)
Throwable	runPreparersTearDown (TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun) runPreparersTearDown (TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun)
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 : la IInvocationContext de l'invocation.
config	IConfiguration : le IConfiguration de cette série de tests.

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.

Paramètres
context	IInvocationContext : la IInvocationContext de l'invocation.
config	IConfiguration : le IConfiguration de cette série de tests.
exception	Throwable : l'exception originale lancée par l'exécution du test.

faireConfiguration

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

Exécutez les étapes de configuration target_preparer et multi_target_preparer. Effectue toutes les configurations de périphériques requises pour que le test s'exécute.

Paramètres
testInfo	TestInformation : la TestInformation de l'invocation.
config	IConfiguration : le IConfiguration de cette série de tests.
listener	ITestLogger : le ITestLogger pour signaler les journaux des échecs de configuration.

Jetés
BuildError
DeviceNotAvailableException
TargetSetupError

faireDémonter

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

Exécutez les étapes de suppression target_preparer et multi_target_preparer. Est-ce que les appareils se détruisent associés à la configuration.

Paramètres
testInfo	TestInformation : la TestInformation de l'invocation.
config	IConfiguration : le IConfiguration de cette série de tests.
logger	ITestLogger : le ITestLogger à signaler les journaux.
exception	Throwable : l'exception originale lancé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 : la TestInformation de l'invocation.
config	IConfiguration : le IConfiguration de cette série de tests.
rescheduler	IRescheduler : le IRescheduler , pour le rééchelonnement des parties de l'appel pour une exécution sur une autre ressource (s)
listener	ITestInvocationListener : le ITestInvocation aux défaillances du rapport build de téléchargement.

Retour
boolean	Vrai si nous avons réussi à télécharger le build, 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 : Le dispositif de signaler les journaux de.
listener	ITestLogger : L'enregistreur pour les journaux.
stage	TestInvocation.Stage : L'étape de l'appel que nous sommes.

runDevicePostInvocationTearDown

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

Invoquer le ITestDevice#postInvocationTearDown(Throwable) pour chaque partie de l' appareil de l'invocation.

Paramètres
context	IInvocationContext : la IInvocationContext de l'invocation.
config	IConfiguration : le IConfiguration de cette série de tests.
exception	Throwable : l'exception originale lancée par le fonctionnement de test le cas échéant.

runDevicePreInvocationSetup

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

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

Paramètres
context	IInvocationContext : la IInvocationContext de l'invocation.
config	IConfiguration : le IConfiguration de cette série de tests.
logger	ITestLogger : le ITestLogger à signaler les journaux.

Jetés
DeviceNotAvailableException
TargetSetupError

exécuterTests

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

Exécute le test.

Paramètres
info	TestInformation : le TestInformation pour exécuter des tests avec.
config	IConfiguration : le IConfiguration à terme
listener	ITestInvocationListener : le ITestInvocationListener des résultats des tests

shardConfig

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

Essayez de fragmenter la configuration en sous-configurations, à replanifier 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 indices de partition et en les replanifiant. Si un nombre de tesson est pas défini, il fallback à IShardHelper#shardConfig .

Paramètres
config	IConfiguration : le courant IConfiguration .
testInfo	TestInformation : la TestInformation tenant les informations des tests.
rescheduler	IRescheduler : le IRescheduler .
logger	ITestLogger : ITestLogger utilisé pour le fichier journal pendant sharding.

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

Méthodes protégées

collectAutoInfo

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

Collectez automatiquement des informations sur le périphérique principal testé.

Paramètres
config	IConfiguration
info	TestInformation

Jetés
DeviceNotAvailableException

createShardHelper

protected IShardHelper createShardHelper ()

Créer un retour de la IShardHelper à utiliser.

Retour
IShardHelper

CustomizeDevicePreInvocation

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

getAdbVersion

protected String getAdbVersion ()

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

Retour
String

getPreparersToRun

protected  getPreparersToRun (IConfiguration config, 
                String deviceName)

Récupérez une liste de préparateurs à 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 de $TMPDIR/adb.$UID.log.

Paramètres
config	IConfiguration
logger	ITestLogger

runPreparersSetup

protected void runPreparersSetup (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger listener)

Paramètres
testInfo	TestInformation
config	IConfiguration
listener	ITestLogger

Jetés
BuildError
DeviceNotAvailableException
TargetSetupError

runPréparateursTearDown

protected Throwable runPreparersTearDown (TestInformation testInfo, 
                ITestDevice device, 
                String deviceName, 
                int deviceIndex, 
                ITestLogger logger, 
                Throwable exception, 
                 preparersToRun)

Paramètres
testInfo	TestInformation
device	ITestDevice
deviceName	String
deviceIndex	int
logger	ITestLogger
exception	Throwable
preparersToRun

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