InstrumentationTestRunner Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ein Instrumentation Objekt, das verschiedene Arten von junit.framework.TestCaseS für ein Android-Paket (Anwendung) ausführt.
[Android.Runtime.Register("android/test/InstrumentationTestRunner", DoNotGenerateAcw=true)]
public class InstrumentationTestRunner : Android.App.Instrumentation[<Android.Runtime.Register("android/test/InstrumentationTestRunner", DoNotGenerateAcw=true)>]
type InstrumentationTestRunner = class
inherit Instrumentation- Vererbung
- Attribute
Hinweise
Ein Instrumentation Objekt, das verschiedene Arten von junit.framework.TestCaseS für ein Android-Paket (Anwendung) ausführt.
<div class="special reference"><h3>Developer Guides</h3>
Weitere Informationen zu Anwendungstests finden Sie im Handbuch für Testentwickler .
</Div>
<h3>Typische Verwendung</h3><ol><li>Write junit.framework.TestCases, die Einheiten-, Funktions- oder Leistungstests für die Klassen in Ihrem Paket ausführen. In der Regel sind dies Unterklassen von: <ul><li>android.test.ActivityInstrumentationTestCase2</li><<android.test.ActivityUnitTestCase>/li/li><android.test.AndroidTestCase></li><android.test.ApplicationTestCase></>><<android.test.InstrumentationTestCaseli/li/li<>>android.test.ProviderTestCase</>><android.test.ServiceTestCase<li/>><android.test.SingleLaunchActivityTestCase<li></ul><li>Legen Sie das android:targetPackage Attribut des <instrumentation> Elements im Manifest des Testpakets fest. Sie sollten den Attributwert auf den Paketnamen der Zielanwendung unter Test festlegen. <li>Führen Sie die Instrumentierung mit "adb shell am instrument -w" ohne optionale Argumente aus, um alle Tests auszuführen (außer Leistungstests). <li>Führen Sie die Instrumentierung mit "adb shell am instrument -w" mit dem Argument "-e func true" aus, um alle funktionalen Tests auszuführen. Dies sind Tests, die von android.test.InstrumentationTestCase. <li>Führen Sie die Instrumentierung mit "adb shell am instrument -w" mit dem Argument "-e unit true" aus, um alle Komponententests auszuführen. Dies sind Tests, die nichtvon android.test.InstrumentationTestCase (und sind keine Leistungstests) abgeleitet sind. <li>Führen Sie die Instrumentierung mithilfe von "adb shell am instrument -w" aus, wobei das Argument '-e Class' so festgelegt ist, dass eine Einzelne junit.framework.TestCaseausgeführt wird. </ol><p/><b>Alle Tests ausführen:</b> adb shell am instrument -w com.android.foo/android.test.InstrumentationTestRunner <p/><b>Alle kleinen Tests ausführen:</b> adb shell am instrument -w -e size small com.android.foo/android.test.InstrumentationTestRunner <p/><b>Ausführen aller mittleren Tests:</b> adb shell am instrument -w -e size medium com.android.foo/android.test.InstrumentationTestRunner <p/><b>Ausführen aller großen Tests:</b> adb shell am instrument -w -e size large com.android.foo/android.test.InstrumentationTestRunner <p/><b>Filter test run to tests with given annotation:</b> adb shell am instrument -w -e annotation com.android.foo.MyAnnotation com.android.foo/android.test.InstrumentationTestRunner <p/> If used with other options, the result test run will contain the union of the two options. z. B. "-e size large -e annotation com.android.foo.MyAnnotation" führt nur Tests mit den LargeTest Anmerkungen "com.android.foo.MyAnnotation" aus. <p/>b Filter test run to tests without given annotation:/b> adb shell am instrument -w -e notAnnotation com.android.foo.MyAnnotation com.android.foo/android.test.InstrumentationTestRunner <p/><b Running a single testcase:</bdb shell am instrument -w -e class com.android.foo.FooTest com.android.foo/android.test.InstrumentationTestRunner <p/><b>>Running a single test:<</b>>>< adb shell am instrument -w -e class com.android.foo.FooTest#testFoo com.android.foo/android.test.InstrumentationTestRunner <p/><b>Running multiple tests:</b> adb shell am instrument -w -e class com.android.foo.FooTest,com.android.foo.TooTest com.android.foo/android.test.InstrumentationTestRunner <p/><b>Ausführen aller Tests in einem Java-Paket:</b> adb shell am instrument -w -e package com.android.foo.subpkg com.android.foo/android.test.InstrumentationTestRunner <p/><b>Including performance tests:/b> adb shell am instrument -w -e perf true com.android.foo/android.test.InstrumentationTestRunner <p/><b>To debug your tests, set a break point in your code and pass:<</b> -e debug true <p/><b>To run in 'log only' mode</b> -e log true Diese Option wird geladen und durchlaufen alle Testklassen und Methoden, aber die tatsächliche Testausführung umgehen. Nützlich für das schnelle Abrufen von Informationen zu den Tests, die von einem Instrumentierungsbefehl ausgeführt werden sollen. <p/><b>Um EMMA-Codeabdeckung zu generieren:</b> -e coverage true Hinweis: Dies erfordert einen emma instrumentierten Build. Standardmäßig wird die Codeabdeckungsergebnissedatei in einer Datei "/data/<app>/coverage.ec" gespeichert, es sei denn, sie wird durch das Flag "coverageFile" (siehe unten) <p/><b> Überschrieben, um zusätzlich zu den anderen Argumenten den Dateipfad der EMMA-Codeabdeckungsergebnisse anzugeben:</b> -e coverageFile /sdcard/myFile.ec <br/>
Dieses Mitglied ist veraltet. Verwenden Sie stattdessen AndroidJUnitRunner . Neue Tests sollten mithilfe der Android-Testunterstützungsbibliothek geschrieben werden.
Java-Dokumentation für android.test.InstrumentationTestRunner.
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.
Konstruktoren
| InstrumentationTestRunner() | |
| InstrumentationTestRunner(IntPtr, JniHandleOwnership) |
Ein Konstruktor, der beim Erstellen verwalteter Darstellungen von JNI-Objekten verwendet wird; wird von der Laufzeit aufgerufen. |
Felder
| ReportKeyIdentifier |
Wenn sie im Status- oder endgültigen Bundle enthalten ist, das an ein IInstrumentationWatcher gesendet wird, identifiziert dieser Schlüssel die Klasse, die den Bericht schreibt. (Geerbt von Instrumentation) |
| ReportKeyNameClass |
Wenn sie im Status- oder endgültigen Bundle enthalten ist, das an ein IInstrumentationWatcher gesendet wird, identifiziert dieser Schlüssel den Namen der aktuellen Testklasse. |
| ReportKeyNameTest |
Wenn der Status oder das endgültige Bundle an ein IInstrumentationWatcher gesendet wird, identifiziert dieser Schlüssel den Namen des aktuellen Tests. |
| ReportKeyNumCurrent |
Wenn der Status oder das endgültige Bundle an ein IInstrumentationWatcher gesendet wird, identifiziert dieser Schlüssel die Sequenznummer des aktuellen Tests. |
| ReportKeyNumTotal |
Wenn der Status oder das endgültige Bundle an ein IInstrumentationWatcher gesendet wird, identifiziert dieser Schlüssel die Gesamtanzahl der Tests, die ausgeführt werden. |
| ReportKeyStack |
Wenn in das an ein IInstrumentationWatcher gesendete Statusbundle enthalten ist, identifiziert dieser Schlüssel eine Stapelablaufverfolgung, die einen Fehler oder Fehler beschreibt. |
| ReportKeyStreamresult |
Wenn sie im Status- oder endgültigen Bundle enthalten ist, das an ein IInstrumentationWatcher gesendet wird, identifiziert dieser Schlüssel eine Zeichenfolge, die einfach in den Ausgabedatenstrom gedruckt werden kann. (Geerbt von Instrumentation) |
| ReportValueId |
Dieser Wert identifiziert instrumentationTestRunner als Quelle des Berichts, wenn er mit dem Schlüssel |
Eigenschaften
| AllocCounts |
Gibt ein Bündel mit den aktuellen Ergebnissen aus der Zuordnungszählung zurück. (Geerbt von Instrumentation) |
| Arguments |
Rufen Sie die Argumente ab, die an diese Instrumentierung übergeben werden. |
| BinderCounts |
Gibt ein Bündel mit den Zählungen für verschiedene Sammelordneranzahlen für diesen Prozess zurück. (Geerbt von Instrumentation) |
| Class |
Gibt die Laufzeitklasse dieses Werts |
| ComponentName |
Gibt den vollständigen Komponentennamen dieser Instrumentierung zurück. (Geerbt von Instrumentation) |
| Context |
Gibt den Kontext des Pakets dieser Instrumentierung zurück. (Geerbt von Instrumentation) |
| Handle |
Das Handle für die zugrunde liegende Android-Instanz. (Geerbt von Object) |
| IsProfiling |
Überprüfen Sie, ob diese Instrumentierung mit aktivierter Profilerstellung gestartet wurde. (Geerbt von Instrumentation) |
| JniIdentityHashCode |
Ein |
| JniPeerMembers |
Ein |
| Loader |
Überschreiben Sie dies, um zugriff auf das Klassenladeprogramm Ihres Pakets zu ermöglichen. |
| PeerReference |
Ein |
| ProcessName |
Geben Sie den Namen des Prozesses zurück, in dem diese Instrumentierung ausgeführt wird. (Geerbt von Instrumentation) |
| TargetContext |
Gibt einen Kontext für die Zielanwendung zurück, die instrumentiert wird. (Geerbt von Instrumentation) |
| ThresholdClass |
Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. |
| ThresholdType |
Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. |
| UiAutomation |
Ruft die |
Methoden
| AcquireLooperManager(Looper) |
Übernimmt die Steuerung der Ausführung von Nachrichten auf dem angegebenen Looper, bis |
| AddMonitor(Instrumentation+ActivityMonitor) |
Fügen Sie ein neues |
| AddMonitor(IntentFilter, Instrumentation+ActivityResult, Boolean) |
Fügen Sie ein neues |
| AddMonitor(String, Instrumentation+ActivityResult, Boolean) |
Fügen Sie ein neues |
| AddResults(Bundle) |
Melden Sie einige Ergebnisse in der Mitte der Instrumentierungsausführung. (Geerbt von Instrumentation) |
| CallActivityOnCreate(Activity, Bundle) |
Ausführen des Aufrufs |
| CallActivityOnCreate(Activity, Bundle, PersistableBundle) |
Ausführen des Aufrufs |
| CallActivityOnDestroy(Activity) | (Geerbt von Instrumentation) |
| CallActivityOnNewIntent(Activity, Intent) |
Ausführen des Aufrufs |
| CallActivityOnPause(Activity) |
Ausführen des Aufrufs |
| CallActivityOnPictureInPictureRequested(Activity) |
Ausführen des Aufrufs |
| CallActivityOnPostCreate(Activity, Bundle) |
Ausführen des Aufrufs |
| CallActivityOnPostCreate(Activity, Bundle, PersistableBundle) |
Ausführen des Aufrufs |
| CallActivityOnRestart(Activity) |
Ausführen des Aufrufs |
| CallActivityOnRestoreInstanceState(Activity, Bundle) |
Ausführen des Aufrufs |
| CallActivityOnRestoreInstanceState(Activity, Bundle, PersistableBundle) |
Ausführen des Aufrufs |
| CallActivityOnResume(Activity) |
Ausführen des Aufrufs |
| CallActivityOnSaveInstanceState(Activity, Bundle) |
Ausführen des Aufrufs |
| CallActivityOnSaveInstanceState(Activity, Bundle, PersistableBundle) |
Ausführen des Aufrufs |
| CallActivityOnStart(Activity) |
Ausführen des Aufrufs |
| CallActivityOnStop(Activity) |
Ausführen des Aufrufs |
| CallActivityOnUserLeaving(Activity) |
Ausführen des Aufrufs |
| CallApplicationOnCreate(Application) |
Ausführen des Aufrufs |
| CheckMonitorHit(Instrumentation+ActivityMonitor, Int32) |
Testen Sie, ob ein vorhandener |
| Clone() |
Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object) |
| Dispose() |
Ein |
| Dispose(Boolean) |
Ein |
| EndPerformanceSnapshot() | (Geerbt von Instrumentation) |
| Equals(Object) |
Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist. (Geerbt von Object) |
| Finish(Result, Bundle) |
Beenden Sie die Instrumentierung der Anwendung. (Geerbt von Instrumentation) |
| GetHashCode() |
Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object) |
| GetUiAutomation(UiAutomationFlags) |
Ruft die |
| InvokeContextMenuAction(Activity, Int32, MenuPerformFlags) |
Zeigen Sie das Kontextmenü für die aktuell fokussierte Ansicht an und führt ein bestimmtes Kontextmenüelement aus. (Geerbt von Instrumentation) |
| InvokeMenuActionSync(Activity, Int32, MenuPerformFlags) |
Führen Sie ein bestimmtes Menüelement aus. (Geerbt von Instrumentation) |
| JavaFinalize() |
Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind. (Geerbt von Object) |
| NewActivity(Class, Context, IBinder, Application, Intent, ActivityInfo, ICharSequence, Activity, String, Object) |
Instanziierung eines |
| NewActivity(Class, Context, IBinder, Application, Intent, ActivityInfo, String, Activity, String, Object) |
Instanziierung eines |
| NewActivity(ClassLoader, String, Intent) |
Instanziierung des Objekts des |
| NewApplication(ClassLoader, String, Context) |
Instanziierung des Objekts des |
| Notify() |
Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object) |
| NotifyAll() |
Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object) |
| OnCreate(Bundle) |
Wird aufgerufen, wenn die Instrumentation gestartet wird, bevor ein Anwendungscode geladen wurde. (Geerbt von Instrumentation) |
| OnDestroy() |
Wird aufgerufen, wenn die instrumentierte Anwendung beendet wird, nachdem alle normalen Anwendungsbereinigungen aufgetreten sind. (Geerbt von Instrumentation) |
| OnException(Object, Throwable) |
Dies wird aufgerufen, wenn das System eine unbehandelte Ausnahme erfasst, die von der Anwendung ausgelöst wurde. (Geerbt von Instrumentation) |
| OnStart() |
Methode, bei der der Instrumentierungsthread ausgeführt wird. (Geerbt von Instrumentation) |
| RemoveMonitor(Instrumentation+ActivityMonitor) |
Entfernen Sie eine |
| ResetInTouchMode() |
Setzt den |
| RunOnMainSync(Action) |
Ein |
| RunOnMainSync(IRunnable) |
Führen Sie einen Aufruf des Hauptthreads der Anwendung aus, der blockiert wird, bis er abgeschlossen ist. (Geerbt von Instrumentation) |
| SendCharacterSync(Keycode) |
Sendet Up- und Down-Schlüsselereignisse mit dem angegebenen Schlüsselcode an das aktuell fokussierte Fenster und wartet darauf, dass es verarbeitet wird. (Geerbt von Instrumentation) |
| SendKeyDownUpSync(Keycode) |
Sendet Up- und Down-Schlüsselereignisse mit dem angegebenen Schlüsselcode an das aktuell fokussierte Fenster und wartet darauf, dass es verarbeitet wird. (Geerbt von Instrumentation) |
| SendKeySync(KeyEvent) |
Sendet ein Schlüsselereignis an das aktuell fokussierte Fenster und wartet darauf, dass es verarbeitet wird. (Geerbt von Instrumentation) |
| SendPointerSync(MotionEvent) |
Verteilt ein Zeigerereignis in ein Fenster, das der instrumentierten Anwendung gehört, und wartet darauf, dass es verarbeitet wird. (Geerbt von Instrumentation) |
| SendStatus(Result, Bundle) |
Geben Sie einen Statusbericht über die Anwendung an. (Geerbt von Instrumentation) |
| SendStringSync(String) |
Sendet die wichtigsten Ereignisse, die dazu führen, dass der angegebene Text in das aktuell fokussierte Fenster eingegeben wird, und wartet darauf, dass er verarbeitet wird. (Geerbt von Instrumentation) |
| SendTrackballEventSync(MotionEvent) |
Verteilt ein Trackball-Ereignis in das aktuell fokussierte Fenster und wartet darauf, dass es verarbeitet wird. (Geerbt von Instrumentation) |
| SetAutomaticPerformanceSnapshots() | (Geerbt von Instrumentation) |
| SetHandle(IntPtr, JniHandleOwnership) |
Legt die Handle-Eigenschaft fest. (Geerbt von Object) |
| SetInTouchMode(Boolean) |
Erzwingen Sie das globale System im oder außerhalb des Touchmodus. (Geerbt von Instrumentation) |
| Start() |
Erstellen und starten Sie einen neuen Thread, in dem die Instrumentation ausgeführt werden soll. (Geerbt von Instrumentation) |
| StartActivitySync(Intent) |
Starten Sie eine neue Aktivität, und warten Sie, bis sie ausgeführt wird, bevor Sie zurückkehren. (Geerbt von Instrumentation) |
| StartActivitySync(Intent, Bundle) |
Starten Sie eine neue Aktivität, und warten Sie, bis sie ausgeführt wird, bevor Sie zurückkehren. (Geerbt von Instrumentation) |
| StartAllocCounting() | (Geerbt von Instrumentation) |
| StartPerformanceSnapshot() | (Geerbt von Instrumentation) |
| StartProfiling() |
Diese Methode beginnt mit der Profilerstellung, wenn isProfiling() "true" zurückgibt. (Geerbt von Instrumentation) |
| StopAllocCounting() | (Geerbt von Instrumentation) |
| StopProfiling() |
Beendet die Profilerstellung, wenn isProfiling() true zurückgibt. (Geerbt von Instrumentation) |
| ToArray<T>() |
Ein |
| ToString() |
Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object) |
| UnregisterFromRuntime() |
Ein |
| Wait() |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em> oder <em>unterbrochen</em>.<>< (Geerbt von Object) |
| Wait(Int64) |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
| Wait(Int64, Int32) |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
| WaitForIdle(Action) |
Ein |
| WaitForIdle(IRunnable) |
Planen Sie einen Rückruf für den Zeitpunkt, an dem der Hauptthread der Anwendung im Leerlauf verläuft (es sind keine weiteren Ereignisse zum Verarbeiten vorhanden). (Geerbt von Instrumentation) |
| WaitForIdleSync() |
Warten Sie synchron, bis die Anwendung im Leerlauf ist. (Geerbt von Instrumentation) |
| WaitForMonitor(Instrumentation+ActivityMonitor) |
Warten Sie, bis ein vorhandener |
| WaitForMonitorWithTimeout(Instrumentation+ActivityMonitor, Int64) |
Warten Sie, bis das |
Explizite Schnittstellenimplementierungen
| IJavaPeerable.Disposed() |
Ein |
| IJavaPeerable.DisposeUnlessReferenced() |
Ein |
| IJavaPeerable.Finalized() |
Ein |
| IJavaPeerable.JniManagedPeerState |
Ein |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Ein |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Ein |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Ein |
Erweiterungsmethoden
| JavaCast<TResult>(IJavaObject) |
Führt eine android-laufzeitgecheckte Typkonvertierung aus. |
| JavaCast<TResult>(IJavaObject) |
Ein |
| GetJniTypeName(IJavaPeerable) |
Ein |