Google s'est engagé à promouvoir l'équité raciale pour les communautés noires. Regarde comment.
Cette page a été traduite par l'API Cloud Translation.
Switch to English

InstrumentationTest

public class InstrumentationTest
extends Object implements IDeviceTest , IResumableTest , ITestCollector , IAbiReceiver , IInvocationContextReceiver , IMetricCollectorReceiver

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


Un test qui exécute un package de test d'instrumentation sur un périphérique donné.

Résumé

Des champs

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 ()
String getCoverageTarget ()

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

boolean getDebug ()

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

ITestDevice getDevice ()

Faites tester l'appareil.

String getForceAbi ()
long getMaxTimeout ()

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

String getPackageName ()

Obtenez le package de manifeste Android à exécuter.

String getRunName ()

Obtenez le nom de test personnalisé qui sera fourni à l'écouteur

String getRunnerName ()

Obtient le runner d'instrumentation Android à utiliser.

boolean isResumable ()

void run ( ITestInvocationListener listener)

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

void setAbi ( IAbi abi)
void setBugreportFrequency ( BugreportCollector.Freq freq)

Définissez la fréquence de collecte automatique des rapports de bogue après les échecs des tests.

void setClassName (String testClassName)

Vous pouvez éventuellement définir le nom de la classe de test à exécuter.

void setCollectTestsOnly (boolean shouldCollectTest)

Active ou désactive le mode de collecte de tests

void setCollectsTestsShellTimeout (int timeout)

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

void setCoverageTarget (String coverageTarget)

Définissez l'objectif 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 l'appareil à tester.

void setEnforceFormat (boolean enforce)

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

void setFallbackToSerialRerun (boolean reRunSerially)

Définit l'option --fallback-to-serial-rerun.

void setForceAbi (String abi)

Définit l'option force-abi.

void setInstallFile (File installFile)

Définissez le fichier facultatif à installer contenant les tests.

void setInvocationContext ( IInvocationContext invocationContext)
void setIsolatedStorage (boolean isolatedStorage)

Indiquez si vous souhaitez ou non utiliser le stockage isolé.

void setMethodName (String testMethodName)

Vous pouvez éventuellement définir la méthode de test à exécuter.

void setMetricCollectors ( collectors) setMetricCollectors ( collectors)

Définit la liste des IMetricCollector définis pour le test.

void setPackageName (String packageName)

Définissez le package de manifeste Android pour qu'il s'exécute.

void setReRunUsingTestFile (boolean reRunUsingTestFile)

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

void setRebootBeforeReRun (boolean rebootBeforeReRun)

Définit l'option --reboot-before-rerun.

void setRerunMode (boolean rerun)

Éventuellement, définissez le mode de réexécution.

void setResumeMode (boolean resume)

Éventuellement, définissez le mode de reprise.

void setRunName (String runName)

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

void setRunnerName (String runnerName)

Vous pouvez éventuellement définir le runner d'instrumentation Android à utiliser.

void setShellTimeout (long timeout)

Si vous le souhaitez, définissez la durée maximale (en millisecondes) attendue de la sortie du shell du périphérique.

void setTestFilePathOnDevice (String testFilePathOnDevice)

Si vous le souhaitez, définissez le chemin vers un fichier situé sur le périphérique qui doit contenir une liste de classes et méthodes de test séparées par des lignes (format: méthode com.foo.Class #) à exécuter.

void setTestPackageName (String testPackageName)

Définit le filtre du package de test.

void setTestSize (String size)

Vous pouvez éventuellement définir la taille du test à exécuter.

void setTestTimeout (long timeout)

Si vous le souhaitez, définissez la durée maximale (en millisecondes) pour chaque essai individuel.

void setTestsToRun ( tests) setTestsToRun ( tests)

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

Méthodes protégées

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 le périphérique à utiliser par un testeur.

void setRunnerArgs (IRemoteAndroidTestRunner runner)

Des champs

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

getAbi

public IAbi getAbi ()

Retour
IAbi

getCoverageTarget

public String getCoverageTarget ()

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

Retour
String

getDebug

public boolean getDebug ()

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

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

getDevice

public ITestDevice getDevice ()

Faites tester l'appareil.

Retour
ITestDevice l' ITestDevice

getForceAbi

public String getForceAbi ()

Retour
String

getMaxTimeout

public long getMaxTimeout ()

Renvoie le délai 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 ()

Obtenez le nom de test personnalisé qui sera fourni à l'écouteur

Retour
String

getRunnerName

public String getRunnerName ()

Obtient le runner d'instrumentation Android à utiliser.

Retour
String

isResumable

public boolean isResumable ()

Retour
boolean

courir

public void run ( ITestInvocationListener listener)

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

Paramètres
listener ITestInvocationListener : l' ITestInvocationListener des résultats de test

Jette
DeviceNotAvailableException

setAbi

public void setAbi ( IAbi abi)

Paramètres
abi IAbi

setBugreportFrequency

public void setBugreportFrequency ( BugreportCollector.Freq freq)

Définissez la fréquence de collecte automatique des rapports de bogue après les échecs des tests.

Notez qu'il n'y a _aucun mécanisme de rétroaction_ entre le testeur et le collecteur de rapports de bogues, utilisez donc le paramètre EACH avec précaution: si une grande quantité d'échecs se produit rapidement, le rapport de bogue pour un échec donné pourrait finir par être collecté des dizaines de minutes ou d'heures après la panne respective.

Paramètres
freq BugreportCollector.Freq

setClassName

public void setClassName (String testClassName)

Vous pouvez éventuellement définir 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 de tests

setCollectsTestsShellTimeout

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 tenir compte du «temps maximum de réponse de sortie du shell» lors de la collecte des tests.

Paramètres
timeout int

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

Définissez l'objectif de couverture de ce test.

Actuellement inutilisé. Cette méthode est juste présente donc coverageTarget peut être récupéré plus tard 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 d'instrumentation.

setDevice

public void setDevice ( ITestDevice device)

Injectez l'appareil à tester.

Paramètres
device ITestDevice : l' ITestDevice à utiliser

setEnforceFormat

public void setEnforceFormat (boolean enforce)

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

Paramètres
enforce boolean

setFallbackToSerialRerun

public void setFallbackToSerialRerun (boolean reRunSerially)

Définit l'option --fallback-to-serial-rerun.

Paramètres
reRunSerially 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 contenant les tests.

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

setInvocationContext

public void setInvocationContext ( IInvocationContext invocationContext)

Paramètres
invocationContext IInvocationContext

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

Indiquez si vous souhaitez ou non utiliser le stockage isolé.

Paramètres
isolatedStorage boolean

setMethodName

public void setMethodName (String testMethodName)

Vous pouvez éventuellement définir 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 le test.

Paramètres
collectors

setPackageName

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

setRebootBeforeReRun

public void setRebootBeforeReRun (boolean rebootBeforeReRun)

Définit l'option --reboot-before-rerun.

Paramètres
rebootBeforeReRun boolean

setRerunMode

public void setRerunMode (boolean rerun)

Éventuellement, définissez le mode de réexécution.

Paramètres
rerun boolean

setResumeMode

public void setResumeMode (boolean resume)

Éventuellement, définissez le mode de reprise.

Paramètres
resume boolean

setRunName

public void setRunName (String runName)

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

Paramètres
runName String

setRunnerName

public void setRunnerName (String runnerName)

Vous pouvez éventuellement définir le runner d'instrumentation Android à utiliser.

Paramètres
runnerName String

setShellTimeout

public void setShellTimeout (long timeout)

Éventuellement, définissez la durée maximale (en millisecondes) attendue de la sortie du shell du périphérique.

Paramètres
timeout long

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

Si vous le souhaitez, définissez le chemin vers un fichier situé sur le périphérique qui doit contenir une liste de classes et méthodes de test séparées par des lignes (format: méthode com.foo.Class #) à exécuter. S'il est défini, essaiera automatiquement de réexécuter les tests en utilisant ce fichier de test via InstrumentationFileTest au lieu d'exécuter des commandes adb séparées pour chaque test restant via InstrumentationSerialTest "

Paramètres
testFilePathOnDevice String

setTestPackageName

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)

Vous pouvez éventuellement définir la taille du test à exécuter.

Paramètres
size String

setTestTimeout

public void setTestTimeout (long timeout)

Si vous le souhaitez, définissez la durée maximale (en millisecondes) pour chaque essai individuel.

Paramètres
timeout long

setTestsToRun

public void setTestsToRun ( tests)

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

Paramètres
tests : les tests à exécuter

Méthodes protégées

getClassName

protected String getClassName ()

Obtenez le nom de la classe à exécuter.

Retour
String

getListInstrumentationParser

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

getTestPackageName

protected String getTestPackageName ()

Obtenez le package java de test à exécuter.

Retour
String

queryRunnerName

protected String queryRunnerName ()

Interrogez le périphérique à utiliser par un testeur

Retour
String le nom du premier lanceur de test qui correspond au package ou null si nous n'en trouvons pas.

Jette
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Paramètres
runner IRemoteAndroidTestRunner