Diese Seite wurde von der Cloud Translation API übersetzt.

InstrumentationTest

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

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

Bekannte direkte Unterklassen

AndroidJUnitTest, CodeCoverageTest

AndroidJUnitTest	Ein Test, bei dem ein Instrumentierungstestpaket mit dem AndroidJUnitRunner auf einem bestimmten Gerät ausgeführt wird.
CodeCoverageTest	Ein Test, bei dem ein Instrumentierungstestpaket auf einem bestimmten Gerät ausgeführt und der Codeabdeckungsbericht generiert wird.

Ein Test, bei dem ein Instrumentierungstestpaket auf einem bestimmten Gerät ausgeführt wird.

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 es, dem Runner weitere benutzerdefinierte Listener hinzuzufügen
`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 Debug-Einstellung für die Instrumentierung ab.
`ITestDevice`	`getDevice()` Holen Sie sich das Testgerät.
`String`	`getForceAbi()`
`long`	`getMaxTimeout()` Gibt das für die Instrumentierung festgelegte maximale Zeitlimit zurück.
`String`	`getPackageName()` Android-Manifest-Paket zum Ausführen abrufen
`String`	`getRunName()` Namen der benutzerdefinierten Testausführung abrufen, der dem Listener zur Verfügung gestellt 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 Modus für die Testerhebung
`void`	`setCollectsTestsShellTimeout(int timeout)` Diese Methode ist veraltet. Diese Methode ist eine Null-Operation.
`void`	`setConfiguration(IConfiguration config)` Fügt den verwendeten `IConfiguration` ein.
`void`	`setCoverageTarget(String coverageTarget)` Legen Sie das Abdeckungsziel für diesen Test fest.
`void`	`setDebug(boolean debug)` Legen Sie die Einstellung für die Instrumentierung zur Fehlerbehebung fest.
`void`	`setDevice(ITestDevice device)` Testgerät einschleusen
`void`	`setEnforceFormat(boolean enforce)` Legen Sie „True“ fest, wenn das AJUR-Ausgabeformat der Instrumentierung erzwungen werden soll.
`void`	`setForceAbi(String abi)` Legt die Option „force-abi“ fest.
`void`	`setInstallFile(File installFile)` Legen Sie die optionale Datei fest, die die Tests enthält.
`void`	`setIsolatedStorage(boolean isolatedStorage)` Legen Sie fest, ob der isolierte Speicher verwendet werden soll.
`void`	`setMethodName(String testMethodName)` Legen Sie optional die Testmethode fest, die ausgeführt werden soll.
`void`	`setMetricCollectors( collectors)` Hiermit wird die Liste der `IMetricCollector`s festgelegt, die für den Testlauf definiert sind.
`void`	`setOrchestrator(boolean useOrchestrator)` Legt die Option „–orchestrator“ fest
`void`	`setPackageName(String packageName)` Legen Sie fest, dass das Android-Manifest-Paket ausgeführt werden soll.
`void`	`setReRunUsingTestFile(boolean reRunUsingTestFile)` Legt die Option „–rerun-from-file“ fest.
`void`	`setRerunMode(boolean rerun)` Optional: Legen Sie den Wiederholungsmodus fest.
`void`	`setRunName(String runName)` Legen Sie den Namen der benutzerdefinierten Testausführung fest, der dem Teilnehmer angezeigt 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) festlegen, nach der die Shell-Ausgabe vom Gerät erwartet wird.
`void`	`setTestFilePathOnDevice(String testFilePathOnDevice)` Optional können Sie den Pfad zu einer Datei auf dem Gerät angeben, die eine Liste der auszuführenden Testklassen und ‑methoden enthalten soll (Format: com.foo.Class#method).
`void`	`setTestPackageName(String testPackageName)` Legt den Testpaketfilter fest.
`void`	`setTestSize(String size)` Optional können Sie die Testgröße festlegen.
`void`	`setTestTimeout(long timeout)` Optional können Sie die maximale Zeit (in Millisekunden) für jeden einzelnen Testlauf festlegen.
`void`	`setTestsToRun( tests)` Legen Sie die Tests fest, die von diesem Instrumentierungstest ausgeführt werden sollen.
`void`	`setWindowAnimation(boolean windowAnimation)`

Geschützte Methoden
`static`	`excludeNonExecuted(TestRunResult results)` Filtern Sie „NOT_EXECUTED“ und „Übersprungen“ heraus, um zu sehen, was noch einmal ausgeführt werden muss.
`String`	`getClassName()` Rufen Sie den Namen der auszuführenden Klasse ab.
`ListInstrumentationParser`	`getListInstrumentationParser()` Ruft die `ListInstrumentationParser` ab, die zum Parsen von Abfragen vom Typ „pm list instrumentation“ verwendet wird.
`String`	`getMethodName()` Testmethode abrufen, die ausgeführt werden soll
`String`	`getTestPackageName()` Holen Sie sich das Java-Testpaket, das ausgeführt werden soll.
`String`	`queryRunnerName()` Das Gerät nach einem zu verwendenden Test-Runner fragen
`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 Konstruktoren

InstrumentationTest

public InstrumentationTest ()

Öffentliche Methoden

addDeviceListeners

public void addDeviceListeners ( extraListeners)

Ermöglicht es, dem Runner weitere benutzerdefinierte Listener hinzuzufügen

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`: den Argumentwert

getAbi

public IAbi getAbi ()

Returns
`IAbi`

getConfiguration

public IConfiguration getConfiguration ()

Ruft die IConfiguration für diesen Test ab.

Returns
`IConfiguration`

getCoverageTarget

public String getCoverageTarget ()

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

Returns
`String`

getDebug

public boolean getDebug ()

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

Returns
`boolean`	Die boolesche Debug-Einstellung.

getDevice

public ITestDevice getDevice ()

Holen Sie sich das Testgerät.

Returns
`ITestDevice`	die `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 ()

Android-Manifest-Paket zum Ausführen abrufen

Returns
`String`

getRunName

public String getRunName ()

Namen der benutzerdefinierten Testausführung abrufen, der dem Listener zur Verfügung gestellt 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 zum Ausführen von Tests.
`listener`	`ITestInvocationListener`: `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 Modus für die Testerhebung

setCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

Diese Methode ist veraltet.
Diese Methode ist eine Nulloperation.

Legen Sie die maximale Zeit in Millisekunden fest, um beim Erfassen von Tests die „maximale Zeit für die Shell-Ausgabeantwort“ zu berücksichtigen.

Parameter
`timeout`	`int`

setConfiguration

public void setConfiguration (IConfiguration config)

Fügt den verwendeten IConfiguration ein.

Parameter
`config`	`IConfiguration`

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

Legen Sie das Abdeckungsziel dieses Tests fest.

Derzeit nicht verwendet. 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 Einstellung für die Instrumentierung zur Fehlerbehebung fest.

Parameter
`debug`	`boolean`: Boolescher Wert, mit dem die Debug-Einstellung für die Instrumentierung festgelegt wird.

setDevice

public void setDevice (ITestDevice device)

Testgerät einschleusen

Parameter
`device`	`ITestDevice`: der zu verwendende `ITestDevice`

setEnforceFormat

public void setEnforceFormat (boolean enforce)

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

Parameter
`enforce`	`boolean`

setForceAbi

public void setForceAbi (String abi)

Legt die Option „force-abi“ fest.

setInstallFile

public void setInstallFile (File installFile)

Legen Sie die optionale 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.

Parameter
`isolatedStorage`	`boolean`

setMethodName

public void setMethodName (String testMethodName)

Legen Sie optional die Testmethode fest, die ausgeführt werden soll.

Parameter
`testMethodName`	`String`

setMetricCollectors

public void setMetricCollectors ( collectors)

Hiermit wird die Liste der IMetricCollectors festgelegt, 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-Manifest-Paket 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)

Optional: Legen Sie den Wiederholungsmodus fest.

Parameter
`rerun`	`boolean`

setRunName

public void setRunName (String runName)

Legen Sie den Namen der benutzerdefinierten Testausführung fest, der dem Teilnehmer angezeigt 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) festlegen, nach der die Shell-Ausgabe vom Gerät erwartet wird.

Parameter
`timeout`	`long`

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

Optional können Sie den Pfad zu einer Datei auf dem Gerät angeben, die eine Liste der auszuführenden Testklassen und ‑methoden (Format: com.foo.Class#method) enthalten soll. Wenn diese Option festgelegt ist, wird automatisch versucht, die Tests mit dieser Testdatei über InstrumentationFileTest noch einmal 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.

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

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

Parameter
`testPackageName`	`String`

setTestSize

public void setTestSize (String size)

Optional können Sie die Testgröße festlegen.

Parameter
`size`	`String`

setTestTimeout

public void setTestTimeout (long timeout)

Optional können Sie die maximale Zeit (in Millisekunden) für jeden einzelnen Testlauf festlegen.

Parameter
`timeout`	`long`

setTestsToRun

public void setTestsToRun ( tests)

Legen Sie die Tests fest, die von diesem Instrumentierungstest 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“ und „Übersprungen“ heraus, um zu sehen, was noch einmal ausgeführt werden muss.

Parameter
`results`	`TestRunResult`

Returns

getClassName

protected String getClassName ()

Rufen Sie den Namen der auszuführenden Klasse ab.

Returns
`String`

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

Ruft die ListInstrumentationParser ab, die zum Parsen von Abfragen vom Typ „pm list instrumentation“ verwendet wird.

Returns
`ListInstrumentationParser`

getMethodName

protected String getMethodName ()

Testmethode abrufen, die ausgeführt werden soll

Returns
`String`

getTestPackageName

protected String getTestPackageName ()

Holen Sie sich das Java-Testpaket, das ausgeführt werden soll.

Returns
`String`

queryRunnerName

protected String queryRunnerName ()

Das Gerät nach einem zu verwendenden Test-Runner fragen

Returns
`String`	der Name des ersten Test Runners, der mit dem Paket übereinstimmt, oder „null“, wenn wir keinen finden.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Parameter
`runner`	`IRemoteAndroidTestRunner`