Instrumentierungstest

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

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


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 Konstruktoren

InstrumentationTest()

Öffentliche Methoden

void addDeviceListeners( extraListeners)

Ermöglicht das Hinzufügen weiterer benutzerdefinierter Listener für den 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 den IConfiguration für diesen Test ab.

String getCoverageTarget()

Ruft das zuvor über setCoverageTarget(String) festgelegte Einstellung für „AbdeckungTarget“ ab.

boolean getDebug()

Rufen Sie die Debugging-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()

Rufen Sie das Android-Manifestpaket zur Ausführung ab.

String getRunName()

Benutzerdefinierten Testlaufnamen abrufen, der für den Listener bereitgestellt wird

String getRunnerName()

Ruft den zu verwendenden Android-Instrumentierungs-Runner ab.

boolean isOrchestrator()

Gibt den Wert von ERROR(InstrumentationTest#mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest#mOrchestrator) zurück

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 fest, die ausgeführt werden soll.

void setCollectTestsOnly(boolean shouldCollectTest)

Aktiviert oder deaktiviert den Testerfassungsmodus

void setCollectsTestsShellTimeout(int timeout)

<ph type="x-smartling-placeholder"></ph> Diese Methode wurde eingestellt. Diese Methode ist ein Leerbefehl.

void setConfiguration(IConfiguration config)

Injiziertes IConfiguration in Gebrauch.

void setCoverageTarget(String coverageTarget)

Legen Sie das Abdeckungsziel für diesen Test fest.

void setDebug(boolean debug)

Legen Sie die Fehlerbehebungseinstellung für die Instrumentierung fest.

void setDevice(ITestDevice device)

Injizieren Sie das zu testende Gerät.

void setEnforceFormat(boolean enforce)

Legen Sie „True“ fest, wenn das AJUR-Ausgabeformat der Instrumentierung erzwungen wird.

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 auszuführende Testmethode fest.

void setMetricCollectors( collectors)

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

void setOrchestrator(boolean useOrchestrator)

Legt die Option --orchestrator 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 Modus für die erneute Ausführung fest.

void setRunName(String runName)

Legen Sie den Namen der benutzerdefinierten Testausführung fest, der für den Listener bereitgestellt wird

void setRunnerName(String runnerName)

Optional können Sie den zu verwendenden Android-Instrumentierungs-Runner festlegen.

void setShellTimeout(long timeout)

Optional können Sie die maximale Zeit (in Millisekunden) für die Shell-Ausgabe des Geräts festlegen.

void setTestFilePathOnDevice(String testFilePathOnDevice)

Geben Sie optional als Pfad eine Datei auf dem Gerät an, die eine Liste mit Zeilen enthalten sollte. separate Testklassen und -methoden (Format: com.foo.Class#method), die ausgeführt werden sollen.

void setTestPackageName(String testPackageName)

Legt den Testpaketfilter fest.

void setTestSize(String size)

Legen Sie optional die Größe des Tests fest, der ausgeführt werden soll.

void setTestTimeout(long timeout)

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

void setTestsToRun( tests)

Legt 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. und Skipped, um zu erfassen, was erneut ausgeführt werden muss.

String getClassName()

Rufen Sie den auszuführenden Kursnamen ab.

ListInstrumentationParser getListInstrumentationParser()

ListInstrumentationParser abrufen, die zum Parsen von „pm list instrumentation“ verwendet wird Abfragen.

String getMethodName()

Rufen Sie die Testmethode ab, die ausgeführt werden soll.

String getTestPackageName()

Rufen Sie das Java-Testpaket zur Ausführung ab.

String queryRunnerName()

Fragen Sie das Gerät nach einem Test-Runner ab, der verwendet werden soll.

void setRunnerArgs(IRemoteAndroidTestRunner runner)

Felder

TEST_AS_USER_KEY_RUN_TESTS

public static final String RUN_TESTS_AS_USER_KEY

RUN_TESTS_ON_SDK_SANDBOX

public static final String RUN_TESTS_ON_SDK_SANDBOX

Fehlerbehebung

protected boolean mDebug

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

Öffentliche Konstruktoren

Instrumentierungstest

public InstrumentationTest ()

Öffentliche Methoden

addDeviceListeners

public void addDeviceListeners ( extraListeners)

Ermöglicht das Hinzufügen weiterer benutzerdefinierter Listener für den Runner

Parameter
extraListeners

InstrumentationArg hinzufügen

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 Name des Arguments

value String: der Wert des Arguments

getAbi

public IAbi getAbi ()

Returns
IAbi

getConfiguration

public IConfiguration getConfiguration ()

Ruft den IConfiguration für diesen Test ab.

Returns
IConfiguration

getAbdeckungTarget

public String getCoverageTarget ()

Ruft das zuvor über setCoverageTarget(String) festgelegte Einstellung für „AbdeckungTarget“ ab.

Returns
String

Fehler beheben

public boolean getDebug ()

Rufen Sie die Debugging-Einstellung für die Instrumentierung ab.

Returns
boolean Die boolesche Einstellung zur Fehlerbehebung.

getDevice

public ITestDevice getDevice ()

Holen Sie sich das zu testende Gerät.

Returns
ITestDevice ITestDevice

getForceAbi

public String getForceAbi ()

Returns
String

getMaxTimeout

public long getMaxTimeout ()

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

Returns
long

getPackageName

public String getPackageName ()

Rufen Sie das Android-Manifestpaket zur Ausführung ab.

Returns
String

getRunName

public String getRunName ()

Benutzerdefinierten Testlaufnamen abrufen, der für den Listener bereitgestellt wird

Returns
String

getRunnerName

public String getRunnerName ()

Ruft den zu verwendenden Android-Instrumentierungs-Runner ab.

Returns
String

isOrchestrator

public boolean isOrchestrator ()

Gibt den Wert von ERROR(InstrumentationTest#mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest#mOrchestrator) zurück

Returns
boolean

Homerun

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 mit nützlichen Informationen, die ausgeführt werden sollen. Tests durchführen.

listener ITestInvocationListener: die ITestInvocationListener der Testergebnisse

Ausgabe
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)

<ph type="x-smartling-placeholder"></ph> Diese Methode wurde eingestellt.
Diese Methode ist ein No-Op

Legen Sie die maximale Zeit in ms fest, um die maximale Zeit für die Shell-Ausgabeantwort zu berücksichtigen bei der Erfassung Tests durchführen.

Parameter
timeout int

setConfiguration

public void setConfiguration (IConfiguration config)

Injiziertes IConfiguration in Gebrauch.

Parameter
config IConfiguration

Abdeckungsziel festlegen

public void setCoverageTarget (String coverageTarget)

Legen Sie das Abdeckungsziel für diesen Test fest.

Derzeit nicht verwendet. Diese Methode ist gerade vorhanden, sodass „AbdeckungTarget“ später über getCoverageTarget()

Parameter
coverageTarget String

Fehlerbehebung festlegen

public void setDebug (boolean debug)

Legen Sie die Fehlerbehebungseinstellung für die Instrumentierung fest.

Parameter
debug boolean: Boolescher Wert, auf den die Fehlerbehebungseinstellung für die Instrumentierung gesetzt werden soll.

Gerät festlegen

public void setDevice (ITestDevice device)

Injizieren Sie das zu testende Gerät.

Parameter
device ITestDevice: die zu verwendende ITestDevice

setEnforceFormat

public void setEnforceFormat (boolean enforce)

Legen Sie „True“ fest, wenn das AJUR-Ausgabeformat der Instrumentierung erzwungen wird.

Parameter
enforce boolean

SetForceAbi

public void setForceAbi (String abi)

Legt die Force-Abi-Option fest.

Datei installieren

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 auszuführende Testmethode fest.

Parameter
testMethodName String

setMetricCollectors

public void setMetricCollectors ( collectors)

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

Parameter
collectors

SetOrchestrator

public void setOrchestrator (boolean useOrchestrator)

Legt die Option --orchestrator fest

Parameter
useOrchestrator boolean

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 Modus für die erneute Ausführung fest.

Parameter
rerun boolean

setRunName

public void setRunName (String runName)

Legen Sie den Namen der benutzerdefinierten Testausführung fest, der für den Listener bereitgestellt wird

Parameter
runName String

SetRunnerName

public void setRunnerName (String runnerName)

Optional können Sie den zu verwendenden Android-Instrumentierungs-Runner festlegen.

Parameter
runnerName String

setShellTimeout

public void setShellTimeout (long timeout)

Optional können Sie die maximale Zeit (in Millisekunden) für die Shell-Ausgabe des Geräts festlegen.

Parameter
timeout long

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

Geben Sie optional als Pfad eine Datei auf dem Gerät an, die eine Liste mit Zeilen enthalten sollte. separate Testklassen und -methoden (Format: com.foo.Class#method), die ausgeführt werden sollen. Wenn festgelegt, Es wird automatisch versucht, Tests mit dieser Testdatei über InstrumentationFileTest erneut auszuführen, anstatt für jeden verbleibenden Test separate ADB-Befehle auszuführen. durch Wiederholung.

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 Wert ungleich null angegeben wurde

Parameter
testPackageName String

setTestSize

public void setTestSize (String size)

Legen Sie optional die Größe des Tests fest, der ausgeführt werden soll.

Parameter
size String

setTestTimeout

public void setTestTimeout (long timeout)

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

Parameter
timeout long

setTestsToRun

public void setTestsToRun ( tests)

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

Parameter
tests : die auszuführenden Tests

Fensteranimation festlegen

public void setWindowAnimation (boolean windowAnimation)

Parameter
windowAnimation boolean

Geschützte Methoden

ausschließenNicht ausgeführt

protected static  excludeNonExecuted (TestRunResult results)

Filtern Sie "NOT_EXECUTED" heraus. und Skipped, um zu erfassen, was erneut ausgeführt werden muss.

Parameter
results TestRunResult

Returns

GetClassName

protected String getClassName ()

Rufen Sie den auszuführenden Kursnamen ab.

Returns
String

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

ListInstrumentationParser abrufen, die zum Parsen von „pm list instrumentation“ verwendet wird Abfragen.

Returns
ListInstrumentationParser

getMethodName

protected String getMethodName ()

Rufen Sie die Testmethode ab, die ausgeführt werden soll.

Returns
String

getTestPackageName

protected String getTestPackageName ()

Rufen Sie das Java-Testpaket zur Ausführung ab.

Returns
String

queryRunnerName (Abfragename)

protected String queryRunnerName ()

Fragen Sie das Gerät nach einem Test-Runner ab, der verwendet werden soll.

Returns
String den Namen des ersten Test-Runners, der mit dem Paket übereinstimmt, oder null, wenn kein Name gefunden wird.

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Parameter
runner IRemoteAndroidTestRunner