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 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 |
String | getCoverageTarget () Rufen Sie das zuvor über |
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 |
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 |
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 |
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
Ö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 |
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 |
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 festgelegt, 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 |
setWindowAnimation
public void setWindowAnimation (boolean windowAnimation)
Parameter | |
---|---|
windowAnimation | boolean |
Geschützte Methoden
ausschließenNonExecuted
protected staticexcludeNonExecuted (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 erste Name des 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 |