InstrumentationTest

public class InstrumentationTest
extends Object implements IDeviceTest , IRemoteTest , ITestCollector , IAbiReceiver , IConfigurationReceiver , IMetricCollectorReceiver

java.lang.Object
com.android.tradefed.testtype.InstrumentationTest


Un test qui exécute un package de test d'instrumentation sur un appareil donné.

Résumé

Des champs

public static final String RUN_TESTS_AS_USER_KEY

public static final String RUN_TESTS_ON_SDK_SANDBOX

protected boolean mDebug

Constructeurs publics

InstrumentationTest ()

Méthodes publiques

void addDeviceListeners ( extraListeners) addDeviceListeners ( extraListeners)

Permet d'ajouter plus d'écouteurs personnalisés au coureur

void addInstrumentationArg (String key, String value)

Ajoutez un argument à fournir lors de l'exécution des tests d'instrumentation.

IAbi getAbi ()
IConfiguration getConfiguration ()

Obtient le IConfiguration pour ce test.

String getCoverageTarget ()

Obtenez le coverTarget précédemment défini via setCoverageTarget(String) .

boolean getDebug ()

Obtenez le paramètre de débogage de l'instrumentation.

ITestDevice getDevice ()

Procurez-vous l'appareil à tester.

String getForceAbi ()
long getMaxTimeout ()

Renvoie le délai d'expiration maximal défini pour l'instrumentation.

String getPackageName ()

Obtenez le package de manifeste Android à exécuter.

String getRunName ()

Obtenir le nom d'exécution de test personnalisé qui sera fourni à l'auditeur

String getRunnerName ()

Obtient l'exécuteur d'instrumentation Android à utiliser.

void run ( TestInformation testInfo, ITestInvocationListener listener)

Exécute les tests et rapporte le résultat à l'auditeur.

void setAbi ( IAbi abi)
void setClassName (String testClassName)

Facultativement, définissez le nom de la classe de test à exécuter.

void setCollectTestsOnly (boolean shouldCollectTest)

Active ou désactive le mode de collecte des tests

void setCollectsTestsShellTimeout (int timeout)

Cette méthode est obsolète. Cette méthode est un no-op

void setConfiguration ( IConfiguration config)

Injecte la IConfiguration en cours d'utilisation.

void setCoverageTarget (String coverageTarget)

Définissez la cible de couverture de ce test.

void setDebug (boolean debug)

Définissez le paramètre de débogage de l'instrumentation.

void setDevice ( ITestDevice device)

Injectez le dispositif sous test.

void setEnforceFormat (boolean enforce)

Définissez True si nous appliquons le format de sortie AJUR de l'instrumentation.

void setForceAbi (String abi)

Définit l'option force-abi.

void setInstallFile (File installFile)

Définissez le fichier facultatif à installer qui contient les tests.

void setIsolatedStorage (boolean isolatedStorage)

Définissez si vous souhaitez ou non utiliser le stockage isolé.

void setMethodName (String testMethodName)

Facultativement, définissez la méthode de test à exécuter.

void setMetricCollectors ( collectors) setMetricCollectors ( collectors)

Définit la liste des IMetricCollector définis pour l'exécution du test.

void setPackageName (String packageName)

Définissez le package de manifeste Android à exécuter.

void setReRunUsingTestFile (boolean reRunUsingTestFile)

Définit l'option --rerun-from-file.

void setRerunMode (boolean rerun)

Définissez éventuellement le mode de réexécution.

void setRunName (String runName)

Définissez le nom d'exécution de test personnalisé qui sera fourni à l'écouteur

void setRunnerName (String runnerName)

Si vous le souhaitez, définissez l'outil d'exécution d'instrumentation Android à utiliser.

void setShellTimeout (long timeout)

Facultativement, définissez la durée maximale (en millisecondes) d'attente de la sortie du shell de l'appareil.

void setTestFilePathOnDevice (String testFilePathOnDevice)

Définissez éventuellement le chemin d'accès à un fichier situé sur l'appareil qui doit contenir une liste de classes et de méthodes de test séparées par des lignes (format : com.foo.Class#method) à exécuter.

void setTestPackageName (String testPackageName)

Définit le filtre du package de test.

void setTestSize (String size)

Définissez éventuellement la taille du test à exécuter.

void setTestTimeout (long timeout)

Définissez éventuellement la durée maximale (en millisecondes) pour chaque exécution de test individuelle.

void setTestsToRun ( tests) setTestsToRun ( tests)

Définissez la collection de tests qui doivent être exécutés par cet InstrumentationTest.

void setWindowAnimation (boolean windowAnimation)

Méthodes protégées

static excludeNonExecuted ( TestRunResult results)

Filtrez "NOT_EXECUTED" dans le but de suivre ce qui doit être réexécuté.

String getClassName ()

Obtenez le nom de la classe à exécuter.

ListInstrumentationParser getListInstrumentationParser ()

Obtenez le ListInstrumentationParser utilisé pour analyser les requêtes 'pm list instrumentation'.

String getMethodName ()

Obtenez la méthode de test à exécuter.

String getTestPackageName ()

Obtenez le package Java de test à exécuter.

String queryRunnerName ()

Interrogez l'appareil pour qu'un exécuteur de test l'utilise.

void setRunnerArgs (IRemoteAndroidTestRunner runner)

Des champs

RUN_TESTS_AS_USER_KEY

public static final String RUN_TESTS_AS_USER_KEY

RUN_TESTS_ON_SDK_SANDBOX

public static final String RUN_TESTS_ON_SDK_SANDBOX

mDebug

protected boolean mDebug

Constructeurs publics

InstrumentationTest

public InstrumentationTest ()

Méthodes publiques

addDeviceListeners

public void addDeviceListeners ( extraListeners)

Permet d'ajouter plus d'écouteurs personnalisés au coureur

Paramètres
extraListeners

addInstrumentationArg

public void addInstrumentationArg (String key, 
                String value)

Ajoutez un argument à fournir lors de l'exécution des tests d'instrumentation.

Paramètres
key String : le nom de l'argument

value String : la valeur de l'argument

obtenirAbi

public IAbi getAbi ()

Retour
IAbi

obtenirConfiguration

public IConfiguration getConfiguration ()

Obtient le IConfiguration pour ce test.

Retour
IConfiguration

getCoverageTarget

public String getCoverageTarget ()

Obtenez le coverTarget précédemment défini via setCoverageTarget(String) .

Retour
String

getDebug

public boolean getDebug ()

Obtenez le paramètre de débogage de l'instrumentation.

Retour
boolean Le paramètre de débogage booléen.

getDevice

public ITestDevice getDevice ()

Procurez-vous l'appareil à tester.

Retour
ITestDevice l' ITestDevice

getForceAbi

public String getForceAbi ()

Retour
String

getMaxTimeout

public long getMaxTimeout ()

Renvoie le délai d'expiration maximal défini pour l'instrumentation.

Retour
long

getPackageName

public String getPackageName ()

Obtenez le package de manifeste Android à exécuter.

Retour
String

getRunName

public String getRunName ()

Obtenir le nom d'exécution de test personnalisé qui sera fourni à l'auditeur

Retour
String

getRunnerName

public String getRunnerName ()

Obtient l'exécuteur d'instrumentation Android à utiliser.

Retour
String

courir

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Exécute les tests et rapporte le résultat à l'auditeur.

Paramètres
testInfo TestInformation : L'objet TestInformation contenant des informations utiles pour exécuter des tests.

listener ITestInvocationListener : l' ITestInvocationListener des résultats des tests

Lance
DeviceNotAvailableException

setAbi

public void setAbi (IAbi abi)

Paramètres
abi IAbi

setClassName

public void setClassName (String testClassName)

Facultativement, définissez le nom de la classe de test à exécuter.

Paramètres
testClassName String

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Active ou désactive le mode de collecte des tests

setCollectsTestsShellTimeoutsetCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

Cette méthode est obsolète.
Cette méthode est un no-op

Définissez le temps maximum en ms pour permettre le "temps maximum de réponse de sortie du shell" lors de la collecte des tests.

Paramètres
timeout int

setConfiguration

public void setConfiguration (IConfiguration config)

Injecte la IConfiguration en cours d'utilisation.

Paramètres
config IConfiguration

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

Définissez la cible de couverture de ce test.

Actuellement inutilisé. Cette méthode est juste présente afin que coverTarget puisse être récupéré ultérieurement via getCoverageTarget()

Paramètres
coverageTarget String

setDebug

public void setDebug (boolean debug)

Définissez le paramètre de débogage de l'instrumentation.

Paramètres
debug boolean : valeur booléenne sur laquelle définir le paramètre de débogage de l'instrumentation.

setDevice

public void setDevice (ITestDevice device)

Injectez le dispositif sous test.

Paramètres
device ITestDevice : l' ITestDevice à utiliser

setEnforceFormatsetEnforceFormat

public void setEnforceFormat (boolean enforce)

Définissez True si nous appliquons le format de sortie AJUR de l'instrumentation.

Paramètres
enforce boolean

setForceAbi

public void setForceAbi (String abi)

Définit l'option force-abi.

setInstallFile

public void setInstallFile (File installFile)

Définissez le fichier facultatif à installer qui contient les tests.

Paramètres
installFile File : l' ERROR(/File)

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

Définissez si vous souhaitez ou non utiliser le stockage isolé.

Paramètres
isolatedStorage boolean

setMethodName

public void setMethodName (String testMethodName)

Facultativement, définissez la méthode de test à exécuter.

Paramètres
testMethodName String

setMetricCollectors

public void setMetricCollectors ( collectors)

Définit la liste des IMetricCollector définis pour l'exécution du test.

Paramètres
collectors

setPackageNamesetPackageName

public void setPackageName (String packageName)

Définissez le package de manifeste Android à exécuter.

Paramètres
packageName String

setReRunUsingTestFile

public void setReRunUsingTestFile (boolean reRunUsingTestFile)

Définit l'option --rerun-from-file.

Paramètres
reRunUsingTestFile boolean

setRerunMode

public void setRerunMode (boolean rerun)

Définissez éventuellement le mode de réexécution.

Paramètres
rerun boolean

setRunName

public void setRunName (String runName)

Définissez le nom d'exécution de test personnalisé qui sera fourni à l'écouteur

Paramètres
runName String

setRunnerName

public void setRunnerName (String runnerName)

Si vous le souhaitez, définissez l'outil d'exécution d'instrumentation Android à utiliser.

Paramètres
runnerName String

setShellTimeout

public void setShellTimeout (long timeout)

Facultativement, définissez la durée maximale (en millisecondes) d'attente de la sortie du shell de l'appareil.

Paramètres
timeout long

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

Définissez éventuellement le chemin d'accès à un fichier situé sur l'appareil qui doit contenir une liste de classes et de méthodes de test séparées par des lignes (format : com.foo.Class#method) à exécuter. S'il est défini, il tentera automatiquement de réexécuter les tests à l'aide de ce fichier de test via InstrumentationFileTest au lieu d'exécuter des commandes adb distinctes pour chaque test restant via la réexécution.

Paramètres
testFilePathOnDevice String

setTestPackageNamesetTestPackageName

public void setTestPackageName (String testPackageName)

Définit le filtre du package de test.

S'il n'est pas nul, seuls les tests du package Java donné seront exécutés.

Sera ignoré si une valeur non nulle a été fournie à setClassName(String)

Paramètres
testPackageName String

setTestSize

public void setTestSize (String size)

Définissez éventuellement la taille du test à exécuter.

Paramètres
size String

setTestTimeout

public void setTestTimeout (long timeout)

Définissez éventuellement la durée maximale (en millisecondes) pour chaque exécution de test individuelle.

Paramètres
timeout long

setTestsToRunsetTestsToRun

public void setTestsToRun ( tests)

Définissez la collection de tests qui doivent être exécutés par cet InstrumentationTest.

Paramètres
tests : les tests à faire

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

Paramètres
windowAnimation boolean

Méthodes protégées

excludeNonExecuted

protected static  excludeNonExecuted (TestRunResult results)

Filtrez "NOT_EXECUTED" dans le but de suivre ce qui doit être réexécuté.

Paramètres
results TestRunResult

Retour

getClassName

protected String getClassName ()

Obtenez le nom de la classe à exécuter.

Retour
String

getListInstrumentationParsergetListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

Obtenez le ListInstrumentationParser utilisé pour analyser les requêtes 'pm list instrumentation'.

Retour
ListInstrumentationParser

getMethodName

protected String getMethodName ()

Obtenez la méthode de test à exécuter.

Retour
String

getTestPackageNamegetTestPackageName

protected String getTestPackageName ()

Obtenez le package Java de test à exécuter.

Retour
String

queryRunnerName

protected String queryRunnerName ()

Interrogez l'appareil pour qu'un exécuteur de test l'utilise.

Retour
String le nom du premier testeur qui correspond au package ou null si nous n'en trouvons aucun.

Lance
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Paramètres
runner IRemoteAndroidTestRunner