語言

InstrumentationTestRunner 類別

定義

警告

This class is obsoleted in this android platform

Instrumentation,針對 Android 套件 (應用程式) 執行各種類型的 junit.framework.TestCase。

[Android.Runtime.Register("android/test/InstrumentationTestRunner", DoNotGenerateAcw=true)]
[System.Obsolete("This class is obsoleted in this android platform")]
public class InstrumentationTestRunner : Android.App.Instrumentation
[<Android.Runtime.Register("android/test/InstrumentationTestRunner", DoNotGenerateAcw=true)>]
[<System.Obsolete("This class is obsoleted in this android platform")>]
type InstrumentationTestRunner = class
    inherit Instrumentation
繼承
InstrumentationTestRunner
屬性

備註

Instrumentation,針對 Android 套件 (應用程式) 執行各種類型的 junit.framework.TestCase。

<div class=“特殊參考”><h3>開發者指南</h3>

如需應用程式測試的詳細資訊,請參閱 測試 開發人員指南。

</div>

<h3>典型使用<率/h3><ol><li>寫 junit.framework.TestCase入,針對套件中的類別執行單元、功能或效能測試。 這些通常是子分類來源:<ul><li>android.test.ActivityInstrumentationTestCase2</li><>android.test.ActivityUnitTestCase<><>android.test.AndroidTestCase<><>android.test.ApplicationTestCase<><>android.test.InstrumentationTestCase<><>android.test.ProviderTestCase<><>android.test.ServiceTestCase<><>android.test.SingleLaunchActivityTestCase<><><> set android:targetPackage the attribute of <instrumentation> the element in the test package's manifest. 您應該將屬性值設定為受測目標應用程式的套件名稱。 <li>請使用「adb shell am instrument -w」執行儀器,且不包含可選參數,以執行所有測試(效能測試除外)。 <li>使用「adb shell am instrument -w」執行儀器,並以參數「-e func true」執行所有函數測試。 這些是衍生自 android.test.InstrumentationTestCase的測試。 <li>使用「adb shell am instrument -w」執行儀器,並以參數「-e unit true」執行所有單元測試。 這些測試 不是衍生自 android.test.InstrumentationTestCase 的測試(且不是效能測試)。 <li>使用「adb shell am instrument -w」執行該儀表,並設定參數「-e class」以執行單一 junit.framework.TestCase。 </ol><p/>執行所有測試: adb shell am instrument -w com.android.foo/android.test.InstrumentationTestRunner <p/>執行所有小型測試: adb shell am instrument -w -e small com.android.foo/android.test.InstrumentationTestRunner <p/>執行所有中等測試: adb shell am instrument -w -e medium com.android.foo/android.test.InstrumentationTestRunner <p/>執行所有大型測試: adb shell am instrument -w -e size 大 com.android.foo/android.test.InstrumentationTestRunner <p/>Filter test run 對指定註解的測試執行: adb shell am instrument -w -e annotation com.android.foo.MyAnnotation com.android.foo/android.test.InstrumentationTestRunner <p/> 若與其他選項一起使用,結果的測試執行將包含兩個選項的聯集。 例如,“-e size large -e annotation com.android.foo.MyAnnotation” 只會使用 LargeTest 和 “com.android.foo.MyAnnotation” 註釋來執行測試。 <p/><b>篩選測試執行至 未 給註解的測試:</b> adb shell am instrument -w -e notAnnotation com.android.foo.MyAnnotation com.android.foo/android.test.InstrumentationTestRunner <p/>執行單一測試案例: adb shell am instrument -w -e class com.android.foo.FooTest com.android.foo/android.test.InstrumentationTestRunner <p/>執行單一測試: adb shell am instrument -w -e on class com.android.foo.FooTest#testFoo com.android.foo/android.test.InstrumentationTestRunner <p/>Running multiple tests: adb shell am instrument -w -e class com.android.foo.FooTest,com.android.foo.TooTest p </>以 java 套件執行所有測試: adb shell am instrument -w -e package com.android.foo.subpkg com.android.foo.foo/android.test.InstrumentationTestRunner <p/>包含效能測試: adb shell am instrument -w -e perf true com.android.foo/android.test.InstrumentationTestRunner <p/>若要除錯測試,請在程式碼中設定一個中斷點並傳入: -e debug true <p/>以「僅記錄」模式執行 -e log true 此選項會載入並遍歷所有測試類別與方法,但會跳過實際測試執行。 適用於快速取得檢測命令所要執行之測試的資訊。 <p/>要產生 EMMA 程式碼覆蓋率: -e 覆蓋範圍為真 注意:這需要 emma 儀器化的編譯。 預設情況下,程式碼覆蓋率結果檔會儲存在 /data/<app>/coverage.ec 檔案中,除非被 coverageFile 標誌(見下文) <覆蓋。p/> 若要指定 EMMA 程式碼覆蓋率結果檔案路徑: -e coverageFile /sdcard/myFile.ec <br/> ,以及其他參數。

已取代這個成員。 請改用 AndroidJUnitRunner 。 應該使用 Android測試支持連結庫撰寫新的測試。

Java 文件 android.test.InstrumentationTestRunner。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

建構函式

名稱 Description
InstrumentationTestRunner()
已淘汰.

初始化 InstrumentationTestRunner 類別的新執行個體。

InstrumentationTestRunner(IntPtr, JniHandleOwnership)
已淘汰.

建立 JNI 物件的 Managed 表示法時使用的建構函式;由運行時間呼叫。

欄位

名稱 Description
ReportKeyIdentifier
已淘汰.

如果包含在傳送至 IInstrumentationWatcher 的狀態或最終套件組合中,此索引鍵會識別正在寫入報表的類別。

(繼承來源 Instrumentation)
ReportKeyNameClass
已淘汰.

如果包含在傳送至 IInstrumentationWatcher 的狀態或最終配套中,此索引鍵會識別目前測試類別的名稱。

ReportKeyNameTest
已淘汰.

如果包含在傳送至 IInstrumentationWatcher 的狀態或最終套件組合中,則此機碼會識別目前測試的名稱。

ReportKeyNumCurrent
已淘汰.

如果包含在傳送至 IInstrumentationWatcher 的狀態或最終套件組合中,此索引鍵會識別目前測試的序號。

ReportKeyNumTotal
已淘汰.

如果包含在傳送至 IInstrumentationWatcher 的狀態或最終套件組合中,此機碼會識別正在執行的測試總數。

ReportKeyStack
已淘汰.

如果包含在傳送至 IInstrumentationWatcher 的狀態套件組合中,此機碼會識別描述錯誤或失敗的堆疊追蹤。

ReportKeyStreamresult
已淘汰.

如果包含在傳送至 IInstrumentationWatcher 的狀態或最終套件組合中,此索引鍵會識別一個字元串,而字串可以直接列印至輸出數據流。

(繼承來源 Instrumentation)
ReportValueId
已淘汰.

如果以索引鍵 android.app.Instrumentation#REPORT_KEY_IDENTIFIER儲存,這個值會將 InstrumentationTestRunner 識別為報表的來源。

屬性

名稱 Description
AllocCounts
已淘汰.

傳回與配置計數中目前結果的套件組合。

(繼承來源 Instrumentation)
Arguments
已淘汰.

取得傳遞至此檢測的自變數。

BinderCounts
已淘汰.

傳回此程式之各種系結器計數的套件組合。

(繼承來源 Instrumentation)
Class
已淘汰.

傳回這個 Object的運行時間類別。

(繼承來源 Object)
ComponentName
已淘汰.

傳回此檢測的完整元件名稱。

(繼承來源 Instrumentation)
Context
已淘汰.

傳回此檢測套件的內容。

(繼承來源 Instrumentation)
Handle
已淘汰.

基礎Android實例的句柄。

(繼承來源 Object)
IsProfiling
已淘汰.

檢查是否已啟動此檢測,並啟用程式代碼剖析。

(繼承來源 Instrumentation)
JniIdentityHashCode
已淘汰.

取得由互通執行時指派給此 Java 對等端的身份雜湊碼。

(繼承來源 Object)
JniManagedPeerState
已淘汰.

取得執行時最後指派的狀態旗標。

(繼承來源 JavaObject)
JniPeerMembers
已淘汰.

取得用於存取此 Java 綁定成員的 JNI 元資料。

Loader
已淘汰.

覆寫此選項,以提供封裝類別載入器的訪問許可權。

PeerReference
已淘汰.

取得這個 Java 節點的 JNI 物件參考。

(繼承來源 Object)
ProcessName
已淘汰.

傳回此檢測正在執行的進程名稱。

(繼承來源 Instrumentation)
TargetContext
已淘汰.

傳回所檢測目標應用程式的內容。

(繼承來源 Instrumentation)
ThresholdClass
已淘汰.

此 API 支援適用於 Android 的 Mono 基礎結構,並不適合直接從您的程式代碼使用。

ThresholdType
已淘汰.

此 API 支援適用於 Android 的 Mono 基礎結構,並不適合直接從您的程式代碼使用。

UiAutomation
已淘汰.

UiAutomation取得未設定旗標的 實例。

(繼承來源 Instrumentation)

方法

名稱 Description
AcquireLooperManager(Looper)
已淘汰.

控制指定迴圈程式上的訊息執行,直到呼叫為止 TestLooperManager#release 。

(繼承來源 Instrumentation)
AddMonitor(Instrumentation+ActivityMonitor)
已淘汰.

新增一個 ActivityMonitor,當活動開始時會被檢查。

(繼承來源 Instrumentation)
AddMonitor(IntentFilter, Instrumentation+ActivityResult, Boolean)
已淘汰.

一個方便的 addMonitor(ActivityMonitor) 包裝器,能幫你建立一個與 ActivityMonitor 相符的意圖過濾器,然後回傳它。

(繼承來源 Instrumentation)
AddMonitor(String, Instrumentation+ActivityResult, Boolean)
已淘汰.

一個方便的 addMonitor(ActivityMonitor) 包裝器,可以幫你建立一個與 ActivityMonitor 相符的類別並回傳。

(繼承來源 Instrumentation)
AddResults(Bundle)
已淘汰.

在檢測執行時回報一些結果。

(繼承來源 Instrumentation)
CallActivityOnCreate(Activity, Bundle, PersistableBundle)
已淘汰.

執行活動方法的 Activity#onCreate 呼叫。

(繼承來源 Instrumentation)
CallActivityOnCreate(Activity, Bundle)
已淘汰.

執行活動方法的 Activity#onCreate 呼叫。

(繼承來源 Instrumentation)
CallActivityOnDestroy(Activity)
已淘汰.

透過活動的內部銷毀例程,呼叫其銷毀生命週期。

(繼承來源 Instrumentation)
CallActivityOnNewIntent(Activity, Intent, ComponentCaller)
已淘汰.

和 一樣, #callActivityOnNewIntent(Activity, Intent)但會多一個參數,針對 ComponentCaller 發送意圖的應用程式所關聯的實例。

(繼承來源 Instrumentation)
CallActivityOnNewIntent(Activity, Intent)
已淘汰.

執行活動方法的 Activity#onNewIntent 呼叫。

(繼承來源 Instrumentation)
CallActivityOnPause(Activity)
已淘汰.

執行活動方法的 Activity#onPause 呼叫。

(繼承來源 Instrumentation)
CallActivityOnPictureInPictureRequested(Activity)
已淘汰.

執行活動方法的 Activity#onPictureInPictureRequested 呼叫。

(繼承來源 Instrumentation)
CallActivityOnPostCreate(Activity, Bundle, PersistableBundle)
已淘汰.

執行活動方法的 Activity#onPostCreate 呼叫。

(繼承來源 Instrumentation)
CallActivityOnPostCreate(Activity, Bundle)
已淘汰.

執行活動方法的 Activity#onPostCreate 呼叫。

(繼承來源 Instrumentation)
CallActivityOnRestart(Activity)
已淘汰.

執行活動方法的 Activity#onRestart 呼叫。

(繼承來源 Instrumentation)
CallActivityOnRestoreInstanceState(Activity, Bundle, PersistableBundle)
已淘汰.

執行活動方法的 Activity#onRestoreInstanceState 呼叫。

(繼承來源 Instrumentation)
CallActivityOnRestoreInstanceState(Activity, Bundle)
已淘汰.

執行活動方法的 Activity#onRestoreInstanceState 呼叫。

(繼承來源 Instrumentation)
CallActivityOnResume(Activity)
已淘汰.

執行活動方法的 Activity#onResume 呼叫。

(繼承來源 Instrumentation)
CallActivityOnSaveInstanceState(Activity, Bundle, PersistableBundle)
已淘汰.

執行活動方法的 Activity#onSaveInstanceState 呼叫。

(繼承來源 Instrumentation)
CallActivityOnSaveInstanceState(Activity, Bundle)
已淘汰.

執行活動方法的 Activity#onSaveInstanceState 呼叫。

(繼承來源 Instrumentation)
CallActivityOnStart(Activity)
已淘汰.

執行活動方法的 Activity#onStart 呼叫。

(繼承來源 Instrumentation)
CallActivityOnStop(Activity)
已淘汰.

執行活動方法的 Activity#onStop 呼叫。

(繼承來源 Instrumentation)
CallActivityOnUserLeaving(Activity)
已淘汰.

執行活動方法的 Activity#onUserLeaveHint 呼叫。

(繼承來源 Instrumentation)
CallApplicationOnCreate(Application)
已淘汰.

執行應用程式的 Application#onCreate 方法呼叫。

(繼承來源 Instrumentation)
CheckMonitorHit(Instrumentation+ActivityMonitor, Int32)
已淘汰.

測試現有的 ActivityMonitor 是否遭到攻擊。

(繼承來源 Instrumentation)
Clone()
已淘汰.

建立並傳回這個 對象的複本。

(繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)
已淘汰.

將此對等節點的建置委派給執行時的值管理器。

(繼承來源 JavaObject)
Dispose()
已淘汰.

釋放該 Java 節點所持有的資源。

(繼承來源 Object)
Dispose(Boolean)
已淘汰.

釋放該 Java 節點所持有的資源。

(繼承來源 Object)
DisposeUnlessReferenced()
已淘汰.

請求值管理器處置此對等節點,除非其映射保留該受管理實例。

(繼承來源 JavaObject)
EndPerformanceSnapshot()
已淘汰.

當設定分析被停用時,結束已設定的收集器的快照並儲存其指標。

(繼承來源 Instrumentation)
Equals(Object)
已淘汰.

測試另一個受管理節點是否參考相同的 Java 物件。

(繼承來源 JavaObject)
Equals(Object)
已淘汰.

指出其他物件是否「等於」這個物件。

(繼承來源 Object)
Finish(Result, Bundle)
已淘汰.

終止應用程式的檢測。

(繼承來源 Instrumentation)
GetHashCode()
已淘汰.

傳回此物件的雜湊碼值。

(繼承來源 Object)
GetUiAutomation(UiAutomationFlags)
已淘汰.

UiAutomation取得已設定旗標的 實例。

(繼承來源 Instrumentation)
InvokeContextMenuAction(Activity, Int32, MenuPerformFlags)
已淘汰.

顯示目前焦點檢視的操作功能表,並執行特定的操作功能表項。

(繼承來源 Instrumentation)
InvokeMenuActionSync(Activity, Int32, MenuPerformFlags)
已淘汰.

執行特定的功能表項。

(繼承來源 Instrumentation)
JavaFinalize()
已淘汰.

當垃圾收集決定不再參考物件時,垃圾收集行程在 物件上呼叫。

(繼承來源 Object)
NewActivity(Class, Context, IBinder, Application, Intent, ActivityInfo, ICharSequence, Activity, String, Object)
已淘汰.

執行物件的具現化 Activity 。

(繼承來源 Instrumentation)
NewActivity(Class, Context, IBinder, Application, Intent, ActivityInfo, String, Activity, String, Object)
已淘汰.

執行物件的具現化 Activity 。

(繼承來源 Instrumentation)
NewActivity(ClassLoader, String, Intent)
已淘汰.

執行進程的 Activity 物件具現化。

(繼承來源 Instrumentation)
NewApplication(ClassLoader, String, Context)
已淘汰.

執行進程的 Application 物件具現化。

(繼承來源 Instrumentation)
Notify()
已淘汰.

喚醒正在等候此物件監視器的單一線程。

(繼承來源 Object)
NotifyAll()
已淘汰.

喚醒正在等候此物件監視器的所有線程。

(繼承來源 Object)
OnCreate(Bundle)
已淘汰.

在啟動檢測之前,在載入任何應用程式程式碼之前呼叫。

(繼承來源 Instrumentation)
OnDestroy()
已淘汰.

當檢測的應用程式停止時呼叫,在發生所有一般應用程式清除之後。

(繼承來源 Instrumentation)
OnException(Object, Throwable)
已淘汰.

每當系統擷取應用程式擲回的未處理例外狀況時,就會呼叫此例外狀況。

(繼承來源 Instrumentation)
OnStart()
已淘汰.

檢測線程進入執行的方法。

(繼承來源 Instrumentation)
RemoveMonitor(Instrumentation+ActivityMonitor)
已淘汰.

移除先前用 addMonitor(ActivityMonitor) 新增的 ActivityMonitor。

(繼承來源 Instrumentation)
ResetInTouchMode()
已淘汰.

#setInTouchMode touch mode將重設為裝置預設值。

(繼承來源 Instrumentation)
RunOnMainSync(Action)
已淘汰.

將動作發佈到應用程式的主執行緒,並等待其完成。

(繼承來源 Instrumentation)
RunOnMainSync(IRunnable)
已淘汰.

在應用程式的主要線程上執行呼叫,封鎖直到完成為止。

(繼承來源 Instrumentation)
SendCharacterSync(Keycode)
已淘汰.

將具有指定索引鍵程序代碼的向上和向下索引鍵事件傳送至目前焦點視窗,並等候處理。

(繼承來源 Instrumentation)
SendKeyDownUpSync(Keycode)
已淘汰.

將具有指定索引鍵程序代碼的向上和向下索引鍵事件傳送至目前焦點視窗,並等候處理。

(繼承來源 Instrumentation)
SendKeySync(KeyEvent)
已淘汰.

將索引鍵事件傳送至目前焦點視窗,並等候處理它。

(繼承來源 Instrumentation)
SendPointerSync(MotionEvent)
已淘汰.

將指標事件分派至已檢測應用程式所擁有的視窗,並等候處理它。

(繼承來源 Instrumentation)
SendStatus(Result, Bundle)
已淘汰.

提供應用程式的相關狀態報告。

(繼承來源 Instrumentation)
SendStringSync(String)
已淘汰.

傳送導致指定文字輸入至目前焦點視窗的索引鍵事件,並等候處理。

(繼承來源 Instrumentation)
SendTrackballEventSync(MotionEvent)
已淘汰.

將追蹤球事件分派至目前焦點視窗,並等候處理。

(繼承來源 Instrumentation)
SetAutomaticPerformanceSnapshots()
已淘汰.

啟用自動效能快照並建立其收集器。

(繼承來源 Instrumentation)
SetHandle(IntPtr, JniHandleOwnership)
已淘汰.

設定 Handle 屬性。

(繼承來源 Object)
SetInTouchMode(Boolean)
已淘汰.

強制全域系統進出觸控模式。

(繼承來源 Instrumentation)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)
已淘汰.

在控制區塊中儲存參考值,但不建立 JNI 參考副本。

(繼承來源 JavaObject)
Start()
已淘汰.

建立並啟動要在其中執行檢測的新線程。

(繼承來源 Instrumentation)
StartActivitySync(Intent, Bundle)
已淘汰.

啟動新的活動,並等候它開始執行,再傳回。

(繼承來源 Instrumentation)
StartActivitySync(Intent)
已淘汰.

啟動新的活動,並等候它開始執行,再傳回。

(繼承來源 Instrumentation)
StartAllocCounting()
已淘汰.

在垃圾回收、最終處理及計數器重置後,請求進行舊有配置計算。

(繼承來源 Instrumentation)
StartPerformanceSnapshot()
已淘汰.

當設定效能收集器被停用時,會開始快照。

(繼承來源 Instrumentation)
StartProfiling()
已淘汰.

如果isProfiling() 傳回 true,這個方法將會開始分析。

(繼承來源 Instrumentation)
StopAllocCounting()
已淘汰.

請求在垃圾回收與最終完成後停止舊有配置計數。

(繼承來源 Instrumentation)
StopProfiling()
已淘汰.

如果isProfiling() 傳回 true,則停止分析。

(繼承來源 Instrumentation)
ToArray<T>()
已淘汰.

從這個 Java 陣列包裝器建立一個受管理陣列。

(繼承來源 Object)
ToString()
已淘汰.

傳回物件的字串表示。

(繼承來源 Object)
UnregisterFromRuntime()
已淘汰.

將此 Java 節點從互通執行時中取消註冊。

(繼承來源 Object)
Wait()
已淘汰.

使目前執行緒等待被喚醒,通常是透過 通知 或 中斷。

(繼承來源 Object)
Wait(Int64, Int32)
已淘汰.

使目前執行緒等待被喚醒(通常是透過 通知 或 中斷),或等待一定的實際時間過去。

(繼承來源 Object)
Wait(Int64)
已淘汰.

使目前執行緒等待被喚醒(通常是透過 通知 或 中斷),或等待一定的實際時間過去。

(繼承來源 Object)
WaitForIdle(Action)
已淘汰.

排程主訊息佇列下一個閒置期間的動作,且不等待該時間。

(繼承來源 Instrumentation)
WaitForIdle(IRunnable)
已淘汰.

排程應用程式主線程閑置時的回呼(沒有其他要處理的事件)。

(繼承來源 Instrumentation)
WaitForIdleSync()
已淘汰.

同步等候應用程式閑置。

(繼承來源 Instrumentation)
WaitForMonitor(Instrumentation+ActivityMonitor)
已淘汰.

等待現有的 ActivityMonitor 被觸發。

(繼承來源 Instrumentation)
WaitForMonitorWithTimeout(Instrumentation+ActivityMonitor, Int64)
已淘汰.

等現有的 ActivityMonitor 被觸發,直到逾時結束。

(繼承來源 Instrumentation)

明確介面實作

名稱 Description
IJavaPeerable.Disposed()
已淘汰.

標記此節點為處置,並以disposing設定為 true的呼叫Dispose。

(繼承來源 JavaObject)
IJavaPeerable.Finalized()
已淘汰.

標記此節點為處置,並以disposing設定為 false的呼叫Dispose。

(繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock
已淘汰.

取得此對等端使用的原生控制區塊指標。

(繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)
已淘汰.

儲存執行時提供的身份雜湊碼。

(繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)
已淘汰.

取代儲存的受管理對等狀態旗標。

(繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)
已淘汰.

當引用無效時,更新對等節點並釋放已拋棄節點的控制區塊。

(繼承來源 JavaObject)

擴充方法

名稱 Description
GetJniTypeName(IJavaPeerable)
已淘汰.

取得實例 self類型的 JNI 名稱。

JavaAs<TResult>(IJavaPeerable)
已淘汰.

試著強制self輸入 TResult,檢查 強制在 Java 端是否有效。

JavaCast<TResult>(IJavaObject)
已淘汰.

執行 Android 執行時間檢查的類型轉換。

JavaCast<TResult>(IJavaObject)
已淘汰.

重用相容的受管理對等端或取得請求型態的包裝器。

TryJavaCast<TResult>(IJavaPeerable, TResult)
已淘汰.

試著強制self輸入 TResult,檢查 強制在 Java 端是否有效。

適用於