IRemoteAndroidTestRunner

public interface IRemoteAndroidTestRunner

com.android.ddmlib.testrunner.IRemoteAndroidTestRunner

Interface permettant d'exécuter une commande de test Android à distance et de signaler le résultat à un écouteur.

Résumé

Méthodes publiques

abstract void addBooleanArg(String name, boolean value)

Ajoute un argument booléen à inclure dans la commande d'instrumentation.

abstract void addInstrumentationArg(String name, String value)

Ajoute un argument à inclure dans la commande d'instrumentation.

abstract void cancel()

Demande l'annulation de cette série de tests.

abstract IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType()

Renvoie le type de couverture de test produit par l'exécuteur.

abstract String getPackageName()

Renvoie le nom du package de l'application.

abstract String getRunnerName()

Renvoie runnerName.

abstract void removeInstrumentationArg(String name)

Supprime un argument précédemment ajouté.

abstract void run(ITestRunListener... listeners)

Exécutez cette série de tests.

abstract void run( listeners)

Exécutez cette série de tests.

abstract void setAdditionalTestOutputLocation(String additionalTestDataPath)

Définit l'emplacement de la sortie de test supplémentaire à copier sur l'hôte avant la désinstallation de l'application de test.

abstract void setClassName(String className)

Définit l'exécution des tests uniquement dans cette classe. Doit être appelé avant "run".

abstract void setClassNames(String[] classNames)

Définit les tests à exécuter uniquement dans les classes fournies. Doit être appelé avant "run".

abstract void setCoverage(boolean coverage)

Définit le mode de couverture du code de cette exécution de test.

abstract void setCoverageReportLocation(String reportPath)

Définit l'emplacement des rapports de couverture générés.

abstract void setDebug(boolean debug)

Définit le mode débogage de cette exécution de test.

abstract void setLogOnly(boolean logOnly)

Définit cette série de tests sur le mode journalisation uniquement, ce qui permet d'ignorer l'exécution des tests.

abstract void setMaxTimeToOutputResponse(long maxTimeToOutputResponse, TimeUnit maxTimeUnits)

Définit le délai maximal autorisé entre la sortie de la commande shell exécutant les tests sur les appareils.

abstract void setMaxTimeout(long maxTimeout, TimeUnit maxTimeUnits)

Définit la durée maximale autorisée pour la fin de l'instrumentation.

abstract void setMaxtimeToOutputResponse(int maxTimeToOutputResponse)

Cette méthode est obsolète. Utilisez ERROR(/#setMaxTimeToOutputResponse(long,java.util.concurrent.TimeUnit)).

abstract void setMethodName(String className, String testName)

Définit les méthodes de test à exécuter uniquement. Doit être appelé avant "run".

abstract void setRunName(String runName)

Définissez un nom d'exécution personnalisé à signaler à ITestRunListener sur run().

Si aucune valeur n'est spécifiée, le nom du package est utilisé.

abstract void setTestCollection(boolean collection)

Définit cette exécution de test sur le mode de collecte de tests.

abstract void setTestPackageName(String packageName)

Définit l'exécution de tous les tests du package spécifié. Doit être appelé avant "run".

abstract void setTestSize(IRemoteAndroidTestRunner.TestSize size)

Définit les ensembles pour n'exécuter que les tests de la taille indiquée.

Méthodes publiques

addBooleanArg

public abstract void addBooleanArg (String name, 
                boolean value)

Ajoute un argument booléen à inclure dans la commande d'instrumentation.

Paramètres
name String : nom de l'argument du bundle d'instrumentation
value boolean : valeur de l'argument

addInstrumentationArg

public abstract void addInstrumentationArg (String name, 
                String value)

Ajoute un argument à inclure dans la commande d'instrumentation.

Doit être appelé avant "run". Si un argument portant le nom donné a déjà été fourni, sa valeur sera remplacée.

Paramètres
name String : nom de l'argument du bundle d'instrumentation
value String : valeur de l'argument

Annuler

public abstract void cancel ()

Demande l'annulation de cette série de tests.

getCoverageOutputType

public abstract IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

Renvoie le type de couverture de test produit par l'exécuteur. Consultez la CoverageOutput.

Renvoie
IRemoteAndroidTestRunner.CoverageOutput

getPackageName

public abstract String getPackageName ()

Renvoie le nom du package de l'application.

Renvoie
String

getRunnerName

public abstract String getRunnerName ()

Renvoie runnerName.

Renvoie
String

removeInstrumentationArg

public abstract void removeInstrumentationArg (String name)

Supprime un argument précédemment ajouté.

Paramètres
name String : nom de l'argument du bundle d'instrumentation à supprimer

Exécuter

public abstract void run (ITestRunListener... listeners)

Exécutez cette série de tests.

Méthode pratique pour ERROR(/#run(Collection)).

Paramètres
listeners ITestRunListener : écoute les résultats des tests
Génère
TimeoutException en cas de délai d'expiration de la connexion.
AdbCommandRejectedException si adb rejette la commande.
ShellCommandUnresponsiveException si l'appareil n'a produit aucun résultat de test pendant une période supérieure à la durée maximale de sortie.
si la connexion à l'appareil a été perdue.

Exécuter

public abstract void run ( listeners)

Exécutez cette série de tests.

Paramètres
listeners  : collection d'écouteurs pour les résultats des tests
Génère
TimeoutException en cas de délai d'expiration de la connexion.
AdbCommandRejectedException si adb rejette la commande.
ShellCommandUnresponsiveException si l'appareil n'a produit aucun résultat de test pendant une période supérieure à la durée maximale de sortie.
si la connexion à l'appareil a été perdue.

setAdditionalTestOutputLocation

public abstract void setAdditionalTestOutputLocation (String additionalTestDataPath)

Définit l'emplacement de la sortie de test supplémentaire à copier sur l'hôte avant la désinstallation de l'application de test. Par exemple, les rapports de benchmark générés.

Paramètres
additionalTestDataPath String

setClassName

public abstract void setClassName (String className)

Définit l'exécution des tests uniquement dans cette classe. Doit être appelé avant "run".

Paramètres
className String : nom complet de la classe (par exemple, x.y.z)

setClassNames

public abstract void setClassNames (String[] classNames)

Définit les tests à exécuter uniquement dans les classes fournies. Doit être appelé avant "run".

Si vous fournissez plusieurs classes, vous avez besoin d'un InstrumentationTestRunner compatible avec la syntaxe d'arguments de classes multiples.

Paramètres
classNames String : tableau de noms de classes complets (par exemple, x.y.z)

setCoverage

public abstract void setCoverage (boolean coverage)

Définit le mode de couverture du code de cette exécution de test.

Paramètres
coverage boolean

setCoverageReportLocation

public abstract void setCoverageReportLocation (String reportPath)

Définit l'emplacement des rapports de couverture générés.

Paramètres
reportPath String

setDebug

public abstract void setDebug (boolean debug)

Définit le mode débogage de cette exécution de test. Si la valeur est "true", le programme d'exécution de tests Android attend qu'un débogueur soit associé avant de poursuivre l'exécution des tests.

Paramètres
debug boolean

setLogOnly

public abstract void setLogOnly (boolean logOnly)

Définit cette série de tests sur le mode journalisation uniquement, ce qui permet d'ignorer l'exécution des tests.

Paramètres
logOnly boolean

setMaxTimeToOutputResponse

public abstract void setMaxTimeToOutputResponse (long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

Définit le délai maximal autorisé entre la sortie de la commande shell exécutant les tests sur les appareils.

Cela permet de définir un délai d'expiration au cas où les tests se bloqueraient et ne se termineraient jamais. Cette valeur est différente du délai d'expiration normal de la connexion.

Par défaut, aucun délai avant expiration n'est spécifié.

Paramètres
maxTimeToOutputResponse long : durée maximale pendant laquelle la commande est autorisée à ne produire aucune réponse. Une valeur de 0 signifie que la méthode attendra indéfiniment (jusqu'à ce que receiver annule l'exécution) la sortie de la commande et ne générera jamais d'exception.
maxTimeUnits TimeUnit : unités pour les valeurs non nulles maxTimeToOutputResponse et maxTimeout.

setMaxTimeout

public abstract void setMaxTimeout (long maxTimeout, 
                TimeUnit maxTimeUnits)

Définit la durée maximale autorisée pour la fin de l'instrumentation.

Cela permet de définir un délai d'expiration au cas où les tests se bloqueraient et ne se termineraient jamais. Cette valeur est différente du délai d'expiration normal de la connexion.

Par défaut, aucun délai avant expiration n'est spécifié.

Paramètres
maxTimeout long : durée maximale pendant laquelle la commande est autorisée à ne produire aucune réponse. Une valeur de 0 signifie que la méthode attendra indéfiniment (jusqu'à ce que receiver annule l'exécution) la sortie de la commande et ne générera jamais d'exception.
maxTimeUnits TimeUnit : unités pour les valeurs non nulles maxTimeToOutputResponse et maxTimeout.

setMaxtimeToOutputResponse

public abstract void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

Cette méthode est obsolète.
Utilisez ERROR(/#setMaxTimeToOutputResponse(long,java.util.concurrent.TimeUnit)).

Paramètres
maxTimeToOutputResponse int

setMethodName

public abstract void setMethodName (String className, 
                String testName)

Définit les méthodes de test à exécuter. Doit être appelé avant "run".

Paramètres
className String : nom complet de la classe (par exemple, x.y.z)
testName String : nom de la méthode

setRunName

public abstract void setRunName (String runName)

Définissez un nom d'exécution personnalisé à signaler à ITestRunListener sur run().

Si aucune valeur n'est spécifiée, le nom du package est utilisé.

setTestCollection

public abstract void setTestCollection (boolean collection)

Définit cette exécution de test sur le mode de collecte de tests. Si la valeur est "true", l'exécution du test sera ignorée et tous les arguments de l'exécuteur appropriés requis pour une collecte de test réussie seront définis.

Paramètres
collection boolean

setTestPackageName

public abstract void setTestPackageName (String packageName)

Définit l'exécution de tous les tests du package spécifié. Doit être appelé avant "run".

Paramètres
packageName String : nom de package complet (par exemple, x.y.z)

setTestSize

public abstract void setTestSize (IRemoteAndroidTestRunner.TestSize size)

Définit les ensembles pour n'exécuter que les tests de la taille indiquée. Doit être appelé avant "run".

Paramètres
size IRemoteAndroidTestRunner.TestSize : TestSize à exécuter.