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 |
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. |
boolean | isOrchestrator () Gibt den Wert von |
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 | setOrchestrator (boolean useOrchestrator) Legt die Option --orchestrator fest |
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
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 |
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 |
istOrchestrator
public boolean isOrchestrator ()
Gibt den Wert von ERROR(InstrumentationTest#mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest#mOrchestrator)
zurück.
Kehrt zurück | |
---|---|
boolean |
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 |
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 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 |
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 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 |