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

protected boolean mInstrumentSdkInSandbox

protected boolean mInstrumentSdkSandbox

Öffentliche Bauträger

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 bereitgestellt 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 Debug-Einstellung 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 Zeitlimit zurück.

String getPackageName ()

Holen Sie sich das Android-Manifestpaket zur Ausführung.

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 die Ergebnisse dem Listener.

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

Legen Sie optional den Namen der Testklasse fest, die ausgeführt werden soll.

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 für diesen Test 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 auf „Ausführen“ fest.

void setMetricCollectors ( collectors) setMetricCollectors ( collectors)

Legt die Liste der IMetricCollector s fest, die für den Testlauf definiert sind.

void setPackageName (String packageName)

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

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, während der eine Shell-Ausgabe vom Gerät erwartet wird.

void setTestFilePathOnDevice (String testFilePathOnDevice)

Legen Sie optional den Pfad zu einer Datei auf dem Gerät fest, die eine Liste der auszuführenden zeilengetrennten Testklassen und -methoden (Format: com.foo.Class#method) enthalten soll.

void setTestPackageName (String testPackageName)

Legt den Testpaketfilter fest.

void setTestSize (String size)

Legen Sie optional die Testgröße für die Ausführung 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 zu verfolgen, was erneut ausgeführt werden muss.

String getClassName ()

Rufen Sie den Klassennamen ab, der ausgeführt werden soll.

ListInstrumentationParser getListInstrumentationParser ()

Rufen Sie den ListInstrumentationParser ab, der zum Parsen von „PM-Listeninstrumentierungs“-Abfragen verwendet wird.

String getMethodName ()

Lassen Sie die Testmethode ausführen.

String getTestPackageName ()

Holen Sie sich das Test-Java-Paket zur Ausführung.

String queryRunnerName ()

Fragen Sie das Gerät nach einem Testläufer 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

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

Öffentliche Bauträger

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 bereitgestellt 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 Debug-Einstellung 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 Zeitlimit zurück.

Kehrt zurück
long

getPackageName

public String getPackageName ()

Holen Sie sich das Android-Manifestpaket zur Ausführung.

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

laufen

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Führt die Tests aus und meldet die Ergebnisse dem Listener.

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

listener ITestInvocationListener : der ITestInvocationListener der Testergebnisse

Würfe
DeviceNotAvailableException

setAbi

public void setAbi (IAbi abi)

Parameter
abi IAbi

setClassName

public void setClassName (String testClassName)

Legen Sie optional den Namen der Testklasse fest, die ausgeführt werden soll.

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-Ausgabeantwort“ zu berücksichtigen.

Parameter
timeout int

setConfiguration

public void setConfiguration (IConfiguration config)

Fügt die verwendete IConfiguration ein.

Parameter
config IConfiguration

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

Legen Sie das Abdeckungsziel für diesen Test fest.

Derzeit unbenutzt. Diese Methode ist nur vorhanden, damit coverTarget 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 festgelegt 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 : die 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 auf „Ausführen“ fest.

Parameter
testMethodName String

setMetricCollectors

public void setMetricCollectors ( collectors)

Legt die Liste der IMetricCollector s fest, die für den Testlauf definiert sind.

Parameter
collectors

setPackageName

public void setPackageName (String packageName)

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

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, während der 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 auf dem Gerät fest, die eine Liste der auszuführenden zeilengetrennten Testklassen und -methoden (Format: com.foo.Class#method) enthalten soll. Wenn diese Option festgelegt ist, wird automatisch versucht, Tests mithilfe dieser Testdatei über InstrumentationFileTest erneut auszuführen, anstatt für jeden verbleibenden Test separate ADB-Befehle über „Rerun“ auszuführen.

Parameter
testFilePathOnDevice String

setTestPackageName

public void setTestPackageName (String testPackageName)

Legt den Testpaketfilter fest.

Bei einem Wert ungleich Null werden nur Tests innerhalb des angegebenen Java-Pakets ausgeführt.

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

Parameter
testPackageName String

setTestSize

public void setTestSize (String size)

Legen Sie optional die Testgröße für die Ausführung 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

ausschließenNonExecuted

protected static  excludeNonExecuted (TestRunResult results)

Filtern Sie „NOT_EXECUTED“ heraus, um zu verfolgen, was erneut ausgeführt werden muss.

Parameter
results TestRunResult

Kehrt zurück

getClassName

protected String getClassName ()

Rufen Sie den Klassennamen ab, der ausgeführt werden soll.

Kehrt zurück
String

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

Rufen Sie den ListInstrumentationParser ab, der zum Parsen von „PM-Listeninstrumentierungs“-Abfragen verwendet wird.

Kehrt zurück
ListInstrumentationParser

getMethodName

protected String getMethodName ()

Lassen Sie die Testmethode ausführen.

Kehrt zurück
String

getTestPackageName

protected String getTestPackageName ()

Holen Sie sich das Test-Java-Paket zur Ausführung.

Kehrt zurück
String

queryRunnerName

protected String queryRunnerName ()

Fragen Sie das Gerät nach einem Testläufer ab.

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

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Parameter
runner IRemoteAndroidTestRunner