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 |
String | getCoverageTarget () Obtenez le coverTarget précédemment défini via |
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 |
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 |
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 |
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 |
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 |
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 |
setWindowAnimation
public void setWindowAnimation (boolean windowAnimation)
Paramètres | |
---|---|
windowAnimation | boolean |
Méthodes protégées
excludeNonExecuted
protected staticexcludeNonExecuted (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 |