Instrumentierungstest

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

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


Ein Test, der ein Instrumentierungstestpaket auf einem bestimmten Gerät ausführt.

Zusammenfassung

Felder

public static final String RUN_TESTS_AS_USER_KEY

public static final String RUN_TESTS_ON_SDK_SANDBOX

protected boolean mDebug

Öffentliche Konstrukteure

InstrumentationTest ()

Öffentliche Methoden

void addDeviceListeners ( extraListeners) addDeviceListeners ( extraListeners)

Ermöglicht das Hinzufügen weiterer benutzerdefinierter Listener zum Runner

void addInstrumentationArg (String key, String value)

Fügen Sie ein Argument hinzu, das beim Ausführen der Instrumentierungstests angegeben werden soll.

IAbi getAbi ()
IConfiguration getConfiguration ()

Ruft die IConfiguration für diesen Test ab.

String getCoverageTarget ()

Rufen Sie das zuvor über setCoverageTarget(String) festgelegte CoverageTarget ab.

boolean getDebug ()

Rufen Sie die Debugeinstellung für die Instrumentierung ab.

ITestDevice getDevice ()

Holen Sie sich das zu testende Gerät.

String getForceAbi ()
long getMaxTimeout ()

Gibt das für die Instrumentierung festgelegte maximale Timeout zurück.

String getPackageName ()

Holen Sie sich das Android-Manifestpaket zum Ausführen.

String getRunName ()

Rufen Sie den benutzerdefinierten Testlaufnamen ab, der dem Listener bereitgestellt wird

String getRunnerName ()

Ruft den zu verwendenden Android-Instrumentierungsläufer ab.

void run ( TestInformation testInfo, ITestInvocationListener listener)

Führt die Tests aus und meldet das Ergebnis an den Listener.

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

Legen Sie optional den Namen der Testklasse zur Ausführung fest.

void setCollectTestsOnly (boolean shouldCollectTest)

Aktiviert oder deaktiviert den Testerfassungsmodus

void setCollectsTestsShellTimeout (int timeout)

Diese Methode ist veraltet. Diese Methode ist ein no-op

void setConfiguration ( IConfiguration config)

Fügt die verwendete IConfiguration ein.

void setCoverageTarget (String coverageTarget)

Legen Sie das Abdeckungsziel dieses Tests fest.

void setDebug (boolean debug)

Legen Sie die Debug-Einstellung für die Instrumentierung fest.

void setDevice ( ITestDevice device)

Injizieren Sie das zu testende Gerät.

void setEnforceFormat (boolean enforce)

Setzen Sie True, wenn wir das AJUR-Ausgabeformat der Instrumentierung erzwingen.

void setForceAbi (String abi)

Legt die Force-Abi-Option fest.

void setInstallFile (File installFile)

Legen Sie die optionale zu installierende Datei fest, die die Tests enthält.

void setIsolatedStorage (boolean isolatedStorage)

Legen Sie fest, ob der isolierte Speicher verwendet werden soll oder nicht.

void setMethodName (String testMethodName)

Legen Sie optional die Testmethode zum Ausführen fest.

void setMetricCollectors ( collectors) setMetricCollectors ( collectors)

Legt die Liste der für den Testlauf definierten IMetricCollector s fest.

void setPackageName (String packageName)

Legen Sie fest, dass das Android-Manifestpaket ausgeführt werden soll.

void setReRunUsingTestFile (boolean reRunUsingTestFile)

Legt die Option --rerun-from-file fest.

void setRerunMode (boolean rerun)

Legen Sie optional den Wiederholungsmodus fest.

void setRunName (String runName)

Legen Sie den benutzerdefinierten Testlaufnamen fest, der dem Listener bereitgestellt wird

void setRunnerName (String runnerName)

Legen Sie optional den zu verwendenden Android-Instrumentierungs-Runner fest.

void setShellTimeout (long timeout)

Legen Sie optional die maximale Zeit (in Millisekunden) fest, die eine Shell-Ausgabe vom Gerät erwartet wird.

void setTestFilePathOnDevice (String testFilePathOnDevice)

Legen Sie optional den Pfad zu einer Datei fest, die sich auf dem Gerät befindet und eine Liste mit zeilengetrennten Testklassen und Methoden (Format: com.foo.Class#method) enthalten soll, die ausgeführt werden sollen.

void setTestPackageName (String testPackageName)

Legt den Testpaketfilter fest.

void setTestSize (String size)

Legen Sie optional die auszuführende Testgröße fest.

void setTestTimeout (long timeout)

Legen Sie optional die maximale Zeit (in Millisekunden) für jeden einzelnen Testlauf fest.

void setTestsToRun ( tests) setTestsToRun ( tests)

Legen Sie die Sammlung von Tests fest, die von diesem InstrumentationTest ausgeführt werden sollen.

void setWindowAnimation (boolean windowAnimation)

Geschützte Methoden

static excludeNonExecuted ( TestRunResult results)

Filtern Sie „NOT_EXECUTED“ heraus, um nachzuverfolgen, was wiederholt werden muss.

String getClassName ()

Rufen Sie den auszuführenden Klassennamen ab.

ListInstrumentationParser getListInstrumentationParser ()

Rufen Sie den ListInstrumentationParser , der zum Analysieren von Abfragen der „pm list instrumentation“ verwendet wird.

String getMethodName ()

Holen Sie sich die Testmethode zum Ausführen.

String getTestPackageName ()

Holen Sie sich das Test-Java-Paket zum Ausführen.

String queryRunnerName ()

Fragen Sie das Gerät nach einem zu verwendenden Test-Runner ab.

void setRunnerArgs (IRemoteAndroidTestRunner runner)

Felder

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

Öffentliche Konstrukteure

Instrumentierungstest

public InstrumentationTest ()

Öffentliche Methoden

addDeviceListeners

public void addDeviceListeners ( extraListeners)

Ermöglicht das Hinzufügen weiterer benutzerdefinierter Listener zum Runner

Parameter
extraListeners

addInstrumentationArg

public void addInstrumentationArg (String key, 
                String value)

Fügen Sie ein Argument hinzu, das beim Ausführen der Instrumentierungstests angegeben werden soll.

Parameter
key String : der Argumentname

value String : der Argumentwert

getAbi

public IAbi getAbi ()

Kehrt zurück
IAbi

getConfiguration

public IConfiguration getConfiguration ()

Ruft die IConfiguration für diesen Test ab.

Kehrt zurück
IConfiguration

getCoverageTarget

public String getCoverageTarget ()

Rufen Sie das zuvor über setCoverageTarget(String) festgelegte CoverageTarget ab.

Kehrt zurück
String

getDebug

public boolean getDebug ()

Rufen Sie die Debugeinstellung für die Instrumentierung ab.

Kehrt zurück
boolean Die boolesche Debug-Einstellung.

getDevice

public ITestDevice getDevice ()

Holen Sie sich das zu testende Gerät.

Kehrt zurück
ITestDevice das ITestDevice

getForceAbi

public String getForceAbi ()

Kehrt zurück
String

getMaxTimeout

public long getMaxTimeout ()

Gibt das für die Instrumentierung festgelegte maximale Timeout zurück.

Kehrt zurück
long

getPackageName

public String getPackageName ()

Holen Sie sich das Android-Manifestpaket zum Ausführen.

Kehrt zurück
String

getRunName

public String getRunName ()

Rufen Sie den benutzerdefinierten Testlaufnamen ab, der dem Listener bereitgestellt wird

Kehrt zurück
String

getRunnerName

public String getRunnerName ()

Ruft den zu verwendenden Android-Instrumentierungsläufer ab.

Kehrt zurück
String

Lauf

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Führt die Tests aus und meldet das Ergebnis an den Listener.

Parameter
testInfo TestInformation : Das TestInformation Objekt, das nützliche Informationen zum Ausführen von Tests enthält.

listener ITestInvocationListener : der ITestInvocationListener der Testergebnisse

Wirft
DeviceNotAvailableException

setAbi

public void setAbi (IAbi abi)

Parameter
abi IAbi

setClassName

public void setClassName (String testClassName)

Legen Sie optional den Namen der Testklasse zur Ausführung fest.

Parameter
testClassName String

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Aktiviert oder deaktiviert den Testerfassungsmodus

setCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

Diese Methode ist veraltet.
Diese Methode ist ein no-op

Legen Sie die maximale Zeit in ms fest, um beim Sammeln von Tests die „maximale Zeit bis zur Shell-Ausgangsantwort“ zu ermöglichen.

Parameter
timeout int

setKonfiguration

public void setConfiguration (IConfiguration config)

Fügt die verwendete IConfiguration ein.

Parameter
config IConfiguration

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

Legen Sie das Abdeckungsziel dieses Tests fest.

Derzeit unbenutzt. Diese Methode ist nur vorhanden, damit CoverageTarget später über getCoverageTarget() abgerufen werden kann.

Parameter
coverageTarget String

setDebug

public void setDebug (boolean debug)

Legen Sie die Debug-Einstellung für die Instrumentierung fest.

Parameter
debug boolean : boolescher Wert, auf den die Instrumentierungs-Debug-Einstellung gesetzt werden soll.

setDevice

public void setDevice (ITestDevice device)

Injizieren Sie das zu testende Gerät.

Parameter
device ITestDevice : das zu verwendende ITestDevice

setEnforceFormat

public void setEnforceFormat (boolean enforce)

Setzen Sie True, wenn wir das AJUR-Ausgabeformat der Instrumentierung erzwingen.

Parameter
enforce boolean

setForceAbi

public void setForceAbi (String abi)

Legt die Force-Abi-Option fest.

setInstallFile

public void setInstallFile (File installFile)

Legen Sie die optionale zu installierende Datei fest, die die Tests enthält.

Parameter
installFile File : das installierbare ERROR(/File)

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

Legen Sie fest, ob der isolierte Speicher verwendet werden soll oder nicht.

Parameter
isolatedStorage boolean

setMethodName

public void setMethodName (String testMethodName)

Legen Sie optional die Testmethode zum Ausführen fest.

Parameter
testMethodName String

setMetricCollectors

public void setMetricCollectors ( collectors)

Legt die Liste der für den Testlauf definierten IMetricCollector s fest.

Parameter
collectors

setPackageName

public void setPackageName (String packageName)

Legen Sie fest, dass das Android-Manifestpaket ausgeführt werden soll.

Parameter
packageName String

setReRunUsingTestFile

public void setReRunUsingTestFile (boolean reRunUsingTestFile)

Legt die Option --rerun-from-file fest.

Parameter
reRunUsingTestFile boolean

setRerunMode

public void setRerunMode (boolean rerun)

Legen Sie optional den Wiederholungsmodus fest.

Parameter
rerun boolean

setRunName

public void setRunName (String runName)

Legen Sie den benutzerdefinierten Testlaufnamen fest, der dem Listener bereitgestellt wird

Parameter
runName String

setRunnerName

public void setRunnerName (String runnerName)

Legen Sie optional den zu verwendenden Android-Instrumentierungs-Runner fest.

Parameter
runnerName String

setShellTimeout

public void setShellTimeout (long timeout)

Legen Sie optional die maximale Zeit (in Millisekunden) fest, die eine Shell-Ausgabe vom Gerät erwartet wird.

Parameter
timeout long

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

Legen Sie optional den Pfad zu einer Datei fest, die sich auf dem Gerät befindet und eine Liste mit zeilengetrennten Testklassen und Methoden (Format: com.foo.Class#method) enthalten soll, die ausgeführt werden sollen. Wenn gesetzt, wird automatisch versucht, Tests mit dieser Testdatei über InstrumentationFileTest erneut auszuführen, anstatt separate adb-Befehle für jeden verbleibenden Test über rerun auszuführen.

Parameter
testFilePathOnDevice String

setTestPackageName

public void setTestPackageName (String testPackageName)

Legt den Testpaketfilter fest.

Wenn nicht null, werden nur Tests innerhalb des angegebenen Java-Pakets ausgeführt.

Wird ignoriert, wenn für setClassName(String) ein Nicht-Null-Wert angegeben wurde

Parameter
testPackageName String

setTestSize

public void setTestSize (String size)

Legen Sie optional die auszuführende Testgröße fest.

Parameter
size String

setTestTimeout

public void setTestTimeout (long timeout)

Legen Sie optional die maximale Zeit (in Millisekunden) für jeden einzelnen Testlauf fest.

Parameter
timeout long

setTestsToRun

public void setTestsToRun ( tests)

Legen Sie die Sammlung von Tests fest, die von diesem InstrumentationTest ausgeführt werden sollen.

Parameter
tests : die auszuführenden Tests

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

Parameter
windowAnimation boolean

Geschützte Methoden

ExcludeNonExecuted

protected static  excludeNonExecuted (TestRunResult results)

Filtern Sie „NOT_EXECUTED“ heraus, um nachzuverfolgen, was wiederholt werden muss.

Parameter
results TestRunResult

Kehrt zurück

getClassName

protected String getClassName ()

Rufen Sie den auszuführenden Klassennamen ab.

Kehrt zurück
String

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

Rufen Sie den ListInstrumentationParser , der zum Analysieren von Abfragen der „pm list instrumentation“ verwendet wird.

Kehrt zurück
ListInstrumentationParser

getMethodName

protected String getMethodName ()

Holen Sie sich die Testmethode zum Ausführen.

Kehrt zurück
String

getTestPackageName

protected String getTestPackageName ()

Holen Sie sich das Test-Java-Paket zum Ausführen.

Kehrt zurück
String

queryRunnerName

protected String queryRunnerName ()

Fragen Sie das Gerät nach einem zu verwendenden Test-Runner ab.

Kehrt zurück
String der erste Name des Testläufers, der mit dem Paket übereinstimmt, oder null, wenn wir keinen finden.

Wirft
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Parameter
runner IRemoteAndroidTestRunner