Test d'instrumentation

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

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


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

Résumé

Champs

public static final String RUN_TESTS_AS_USER_KEY

public static final String RUN_TESTS_ON_SDK_SANDBOX

protected boolean mDebug

protected boolean mInstrumentSdkInSandbox

protected boolean mInstrumentSdkSandbox

Constructeurs publics

InstrumentationTest()

Méthodes publiques

void addDeviceListeners( extraListeners)

Permet d'ajouter des écouteurs personnalisés à l'exécuteur.

void addInstrumentationArg(String key, String value)

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

IAbi getAbi()
IConfiguration getConfiguration()

Récupère les IConfiguration pour ce test.

String getCoverageTarget()

Obtenez la couvertureTarget précédemment définie via setCoverageTarget(String).

boolean getDebug()

Obtenir le paramètre de débogage d'instrumentation

ITestDevice getDevice()

Faites tester l'appareil.

String getForceAbi()
long getMaxTimeout()

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

String getPackageName()

Obtenez le package manifeste Android à exécuter.

String getRunName()

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

String getRunnerName()

Récupère l'exécuteur d'instrumentation Android à utiliser.

boolean isOrchestrator()

Affiche la valeur de ERROR(InstrumentationTest#mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest#mOrchestrator).

void run(TestInformation testInfo, ITestInvocationListener listener)

Exécute les tests et communique les résultats à l'écouteur.

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

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

void setCollectTestsOnly(boolean shouldCollectTest)

Active ou désactive le mode de collecte test

void setCollectsTestsShellTimeout(int timeout)

<ph type="x-smartling-placeholder"></ph> Cette méthode est obsolète. Cette méthode est une opération no-op

void setConfiguration(IConfiguration config)

Il injecte les IConfiguration en cours d'utilisation.

void setCoverageTarget(String coverageTarget)

Définissez la couverture cible 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 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 de force-abi.

void setInstallFile(File installFile)

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

void setIsolatedStorage(boolean isolatedStorage)

Indiquez si vous souhaitez utiliser le stockage isolé.

void setMethodName(String testMethodName)

Si vous le souhaitez, définissez la méthode de test à exécuter.

void setMetricCollectors( collectors)

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

void setOrchestrator(boolean useOrchestrator)

Définit l'option --orchestrator

void setPackageName(String packageName)

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

void setReRunUsingTestFile(boolean reRunUsingTestFile)

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

void setRerunMode(boolean rerun)

Vous pouvez également définir le mode de réexécution.

void setRunName(String runName)

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

void setRunnerName(String runnerName)

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

void setShellTimeout(long timeout)

Vous pouvez également définir le délai maximal (en millisecondes) attendu pour la sortie de l'interface système de l'appareil.

void setTestFilePathOnDevice(String testFilePathOnDevice)

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

void setTestPackageName(String testPackageName)

Définit le filtre de package de test.

void setTestSize(String size)

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

void setTestTimeout(long timeout)

Vous pouvez également définir la durée maximale (en millisecondes) de chaque exécution de test.

void setTestsToRun( tests)

Définissez la collection de tests à exécuter par cet InstrumentationTest.

void setWindowAnimation(boolean windowAnimation)

Méthodes protégées

static excludeNonExecuted(TestRunResult results)

Filtrer "NOT_EXECUTED" et "Ignoré" pour déterminer ce qui doit être réexécuté.

String getClassName()

Obtenez le nom de la classe à exécuter.

ListInstrumentationParser getListInstrumentationParser()

Obtenir le ListInstrumentationParser utilisé pour analyser "pm list instrumentation" requêtes.

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 lanceur de test puisse l'utiliser.

void setRunnerArgs(IRemoteAndroidTestRunner runner)

Champs

EXÉCUTER_LES_TESTS_AS_USER_KEY

public static final String RUN_TESTS_AS_USER_KEY

EXÉCUTER_TESTS_ON_SDK_SANDBOX

public static final String RUN_TESTS_ON_SDK_SANDBOX

mDebug

protected boolean mDebug

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

Constructeurs publics

Test d'instrumentation

public InstrumentationTest ()

Méthodes publiques

addDeviceListeners

public void addDeviceListeners ( extraListeners)

Permet d'ajouter des écouteurs personnalisés à l'exécuteur.

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: nom de l'argument

value String: valeur de l'argument

getAbi

public IAbi getAbi ()

Renvoie
IAbi

getConfiguration

public IConfiguration getConfiguration ()

Récupère les IConfiguration pour ce test.

Renvoie
IConfiguration

getcoverTarget

public String getCoverageTarget ()

Obtenez la couvertureTarget précédemment définie via setCoverageTarget(String).

Renvoie
String

getDebug

public boolean getDebug ()

Obtenir le paramètre de débogage d'instrumentation

Renvoie
boolean Paramètre de débogage booléen.

getDevice

public ITestDevice getDevice ()

Faites tester l'appareil.

Renvoie
ITestDevice l'/le/la ITestDevice

getForceAbi

public String getForceAbi ()

Renvoie
String

getMaxTimeout

public long getMaxTimeout ()

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

Renvoie
long

getPackageName

public String getPackageName ()

Obtenez le package manifeste Android à exécuter.

Renvoie
String

getRunName

public String getRunName ()

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

Renvoie
String

NomgetRunner

public String getRunnerName ()

Récupère l'exécuteur d'instrumentation Android à utiliser.

Renvoie
String

Exécuter

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Exécute les tests et communique les résultats à l'écouteur.

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

listener ITestInvocationListener: ITestInvocationListener des résultats du test

Génère
DeviceNotAvailableException

setAbi

public void setAbi (IAbi abi)

Paramètres
abi IAbi

setClassName

public void setClassName (String testClassName)

Vous pouvez également 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 test

setCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

<ph type="x-smartling-placeholder"></ph> Cette méthode est obsolète.
Cette méthode est une opération no-op

Définissez le délai maximal en ms pour autoriser le "délai maximal de réponse de l'interface système" lors de la collecte tests.

Paramètres
timeout int

Définir une configuration

public void setConfiguration (IConfiguration config)

Il injecte les IConfiguration en cours d'utilisation.

Paramètres
config IConfiguration

setcoverTarget

public void setCoverageTarget (String coverageTarget)

Définissez la couverture cible de ce test.

Actuellement inutilisé. Cette méthode est simplement présente, ce qui permet de récupérer la valeur couvertureTarget 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 d'instrumentation.

Définir l'appareil

public void setDevice (ITestDevice device)

Injectez l'appareil testé.

Paramètres
device ITestDevice: 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

setForceAbi

public void setForceAbi (String abi)

Définit l'option de force-abi.

setInstallFile

public void setInstallFile (File installFile)

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

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

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

Indiquez si vous souhaitez utiliser le stockage isolé.

Paramètres
isolatedStorage boolean

setMethodName

public void setMethodName (String testMethodName)

Si vous le souhaitez, définissez la méthode de test à exécuter.

Paramètres
testMethodName String

setMetricCollectors

public void setMetricCollectors ( collectors)

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

Paramètres
collectors

setOrchestrator

public void setOrchestrator (boolean useOrchestrator)

Définit l'option --orchestrator

Paramètres
useOrchestrator boolean

setPackageName

public void setPackageName (String packageName)

Définissez le package 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

Définir le mode de réexécution

public void setRerunMode (boolean rerun)

Vous pouvez également définir le mode de réexécution.

Paramètres
rerun boolean

setRunName

public void setRunName (String runName)

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

Paramètres
runName String

Nom de l'exécuteur (setRunner)

public void setRunnerName (String runnerName)

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

Paramètres
runnerName String

setShellTimeout

public void setShellTimeout (long timeout)

Vous pouvez également définir le délai maximal (en millisecondes) attendu pour la sortie de l'interface système de l'appareil.

Paramètres
timeout long

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

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

Paramètres
testFilePathOnDevice String

setTestPackageName

public void setTestPackageName (String testPackageName)

Définit le filtre de package de test.

Si la valeur n'est pas "null", 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 également définir la taille du test à exécuter.

Paramètres
size String

setTestTimeout

public void setTestTimeout (long timeout)

Vous pouvez également définir la durée maximale (en millisecondes) de chaque exécution de test.

Paramètres
timeout long

setTestsToRun

public void setTestsToRun ( tests)

Définissez la collection de tests à exécuter par cet InstrumentationTest.

Paramètres
tests : tests à exécuter

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

Paramètres
windowAnimation boolean

Méthodes protégées

ExclureNonExécuté

protected static  excludeNonExecuted (TestRunResult results)

Filtrer "NOT_EXECUTED" et "Ignoré" pour déterminer ce qui doit être réexécuté.

Paramètres
results TestRunResult

Renvoie

getClassName

protected String getClassName ()

Obtenez le nom de la classe à exécuter.

Renvoie
String

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

Obtenir le ListInstrumentationParser utilisé pour analyser "pm list instrumentation" requêtes.

Renvoie
ListInstrumentationParser

getMethodName

protected String getMethodName ()

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

Renvoie
String

GetTestPackageName

protected String getTestPackageName ()

Obtenez le package Java de test à exécuter.

Renvoie
String

Nom de l'exécuteur de requête

protected String queryRunnerName ()

Interrogez l'appareil pour qu'un lanceur de test puisse l'utiliser.

Renvoie
String le nom du premier lanceur de test correspondant au package ou la valeur "null" si nous n'en trouvons pas.

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Paramètres
runner IRemoteAndroidTestRunner