RemoteAndroidTestRunner

public class RemoteAndroidTestRunner
extends Object implements IRemoteAndroidTestRunner

java.lang.Object
   ↳ com.android.ddmlib.testrunner.RemoteAndroidTestRunner

Exécute une commande de test Android à distance et signale les résultats.

Résumé

Constructeurs publics

RemoteAndroidTestRunner(String packageName, IShellEnabledDevice remoteDevice)

Constructeur alternatif.

RemoteAndroidTestRunner(String packageName, String runnerName, IShellEnabledDevice remoteDevice)

Constructeur alternatif.

RemoteAndroidTestRunner(String packageName, String runnerName, IShellEnabledDevice remoteDevice, RemoteAndroidTestRunner.StatusReporterMode statusReporterMode)

Crée un test runner Android à distance.

Méthodes publiques

void addBooleanArg(String name, boolean value)

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

void addInstrumentationArg(String name, String value)

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

void cancel()

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

IInstrumentationResultParser createParser(String runName, listeners)

Créez le InstrumentationResultParser qui sera utilisé pour analyser la sortie de l'instrumentation.

String getAmInstrumentCommand()
IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType()

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

String getPackageName()

Renvoie le nom du package de l'application.

String getRunOptions()

Renvoie les options de la commande am instrument.

String getRunnerName()

Renvoie runnerName.

void removeInstrumentationArg(String name)

Supprime un argument précédemment ajouté.

void run(ITestRunListener... listeners)

Exécutez cette série de tests.

void run( listeners)

Exécutez cette série de tests.

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.

void setClassName(String className)

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

void setClassNames(String[] classNames)

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

void setCoverage(boolean coverage)

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

void setCoverageReportLocation(String reportPath)

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

void setDebug(boolean debug)

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

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.

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.

void setMaxTimeout(long maxTimeout, TimeUnit maxTimeUnits)

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

void setMaxtimeToOutputResponse(int maxTimeToOutputResponse)
void setMethodName(String className, String testName)

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

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é.

void setRunOptions(String options)

Définit les options de la commande d'instrument am.

void setTestCollection(boolean collect)

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

void setTestPackageName(String packageName)

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

void setTestSize(IRemoteAndroidTestRunner.TestSize size)

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

Méthodes protégées

String getArgsCommand()

Renvoie la syntaxe complète de la ligne de commande d'instrumentation pour les arguments d'instrumentation fournis.

String getRunnerPath()

Renvoie le chemin d'accès complet du composant d'instrumentation.

Constructeurs publics

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                IShellEnabledDevice remoteDevice)

Constructeur alternatif. Utilise l'exécuteur d'instrumentation par défaut.

Paramètres
packageName String : package d'application Android contenant les tests à exécuter
remoteDevice IShellEnabledDevice : l'appareil Android sur lequel exécuter les tests

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                String runnerName, 
                IShellEnabledDevice remoteDevice)

Constructeur alternatif. Utilise la valeur par défaut statusReporterMode.

Paramètres
packageName String : package d'application Android contenant les tests à exécuter
runnerName String : exécuteur de tests d'instrumentation à exécuter. Si la valeur est nulle, le programme d'exécution par défaut sera utilisé.
remoteDevice IShellEnabledDevice : l'appareil Android sur lequel exécuter les tests

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                String runnerName, 
                IShellEnabledDevice remoteDevice, 
                RemoteAndroidTestRunner.StatusReporterMode statusReporterMode)

Crée un test runner Android à distance.

Paramètres
packageName String : package d'application Android contenant les tests à exécuter
runnerName String : exécuteur de tests d'instrumentation à exécuter. Si la valeur est nulle, le programme d'exécution par défaut sera utilisé.
remoteDevice IShellEnabledDevice : l'appareil Android sur lequel exécuter les tests
statusReporterMode RemoteAndroidTestRunner.StatusReporterMode : mode de signalement de l'état à utiliser pour une commande d'instrument

Méthodes publiques

addBooleanArg

public 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 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 void cancel ()

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

createParser

public IInstrumentationResultParser createParser (String runName, 
                 listeners)

Créez le InstrumentationResultParser qui sera utilisé pour analyser la sortie de l'instrumentation.

Paramètres
runName String : nom de l'exécution à utiliser.
listeners  : écouteurs auxquels signaler les résultats.
Renvoie
IInstrumentationResultParser Instance de InstrumentationResultParser.

getAmInstrumentCommand

public String getAmInstrumentCommand ()

Renvoie
String

getCoverageOutputType

public IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

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

Renvoie
IRemoteAndroidTestRunner.CoverageOutput

getPackageName

public String getPackageName ()

Renvoie le nom du package de l'application.

Renvoie
String

getRunOptions

public String getRunOptions ()

Renvoie les options de la commande am instrument.

Renvoie
String

getRunnerName

public String getRunnerName ()

Renvoie runnerName.

Renvoie
String

removeInstrumentationArg

public 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 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
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

Exécuter

public 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
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

setAdditionalTestOutputLocation

public 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 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 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 void setCoverage (boolean coverage)

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

Paramètres
coverage boolean

setCoverageReportLocation

public void setCoverageReportLocation (String reportPath)

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

Paramètres
reportPath String

setDebug

public 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 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 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 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 void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

Paramètres
maxTimeToOutputResponse int

setMethodName

public void setMethodName (String className, 
                String testName)

Définit les méthodes de test à exécuter uniquement. 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 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é.

setRunOptions

public void setRunOptions (String options)

Définit les options de la commande d'instrument am. Consultez com/android/commands/am/Am.java pour obtenir la liste complète des options.

Paramètres
options String

setTestCollection

public void setTestCollection (boolean collect)

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
collect boolean

setTestPackageName

public 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 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.

Méthodes protégées

getArgsCommand

protected String getArgsCommand ()

Renvoie la syntaxe complète de la ligne de commande d'instrumentation pour les arguments d'instrumentation fournis. Renvoie une chaîne vide si aucun argument n'a été spécifié.

Renvoie
String

getRunnerPath

protected String getRunnerPath ()

Renvoie le chemin d'accès complet du composant d'instrumentation.

Renvoie
String