UiAutomation 類別

定義

命名空間:

Android.App

組件:

Mono.Android.dll

模擬使用者動作和螢幕內容的簡介，以與裝置 UI 互動的類別。

[Android.Runtime.Register("android/app/UiAutomation", DoNotGenerateAcw=true)]
public sealed class UiAutomation : Java.Lang.Object

[<Android.Runtime.Register("android/app/UiAutomation", DoNotGenerateAcw=true)>]
type UiAutomation = class
    inherit Object

繼承

Object

Object

UiAutomation

屬性

RegisterAttribute

備註

模擬使用者動作和螢幕內容的簡介，以與裝置 UI 互動的類別。 它依賴平臺協助工具 API 來簡介畫面，並在遠端檢視樹狀結構上執行一些動作。 它也允許插入任意原始輸入事件，以模擬使用者與鍵盤和觸控裝置的互動。 您可以將 UiAutomation 視為特殊類型 android.accessibilityservice.AccessibilityService ，其不提供服務生命週期的勾點，並公開其他適用于 UI 測試自動化的 API。

此類別所公開的 API 是低階，可在開發 UI 測試自動化工具和程式庫時發揮最大彈性。 一般而言，UiAutomation 用戶端應該使用較高層級的程式庫或實作高階函式。 例如，在畫面上執行點選需要建構並插入觸控和向上事件，這些事件必須透過呼叫 #injectInputEvent(InputEvent, boolean) 傳遞至系統。

此類別公開的 API 會跨應用程式運作，讓用戶端能夠撰寫涵蓋跨越多個應用程式之使用案例的測試。 例如，移至設定應用程式來變更設定，然後與另一個行為相依于該設定的應用程式互動。

的 android.app.UiAutomation JAVA 檔。

此頁面的部分是根據 原始碼專案所建立和共用的工作進行修改，並根據中所述的詞彙使用。

欄位

FlagDontSuppressAccessibilityServices	已淘汰. UiAutomation 預設會隱藏協助工具服務。
FlagDontUseAccessibility	已淘汰. UiAutomation 預設會使用協助工具子系統。
RotationFreeze0	已淘汰. 旋轉常數：凍結旋轉至 0 度， (自然方向)
RotationFreeze180	已淘汰. 旋轉常數：凍結旋轉至 180 度。
RotationFreeze270	已淘汰. 旋轉常數：凍結旋轉至 270 度。
RotationFreeze90	已淘汰. 旋轉常數：凍結旋轉至 90 度。
RotationFreezeCurrent	已淘汰. 旋轉常數：凍結旋轉至其目前狀態。
RotationUnfreeze	已淘汰. 旋轉常數：在旋轉裝置時 (解除凍結旋轉會變更其旋轉狀態) 。

屬性

Class	傳回這個 Object 的執行時間類別。 (繼承來源 Object)
Handle	基礎 Android 實例的控制碼。 (繼承來源 Object)
JniIdentityHashCode	模擬使用者動作和螢幕內容的簡介，以與裝置 UI 互動的類別。 (繼承來源 Object)
JniPeerMembers	模擬使用者動作和螢幕內容的簡介，以與裝置 UI 互動的類別。
PeerReference	模擬使用者動作和螢幕內容的簡介，以與裝置 UI 互動的類別。 (繼承來源 Object)
RootInActiveWindow	取得使用中視窗的根 AccessibilityNodeInfo 目錄。
ServiceInfo	取得描述 AccessibilityServiceInfo 此 UiAutomation 的 。 -或- 設定 ， AccessibilityServiceInfo 描述平臺協助工具層如何處理此 UiAutomation。
ThresholdClass	此 API 支援 Mono for Android 基礎結構，並不適合直接從您的程式碼使用。 (繼承來源 Object)
ThresholdType	此 API 支援 Mono for Android 基礎結構，並不適合直接從您的程式碼使用。 (繼承來源 Object)
WindowAnimationFrameStats	取得視窗動畫畫面統計資料。
Windows	取得與內容相關聯的 UiAutomation 畫面視窗 (通常是 android.view.Display#DEFAULT_DISPLAY預設顯示) 。 &lt;p&gt; This method returns only the windows that a sighted user can interact with, as opposed to all windows. &lt;p&gt; For example, if there is a modal dialog shown and the user cannot touch anything behind it, then only the modal window will be reported (assuming it is the top one). For convenience the returned windows are ordered in a descending layer order, which is the windows that are higher in the Z-order are reported first. &lt;p&gt; &lt;strong&gt;Note:&lt;/strong&gt; In order to access the windows you have to opt-in to retrieve the interactive windows by setting the {@link AccessibilityServiceInfo#FLAG_RETRIEVE_INTERACTIVE_WINDOWS</code> flag.
WindowsOnAllDisplays	取得所有顯示器畫面上的視窗。

方法

AdoptShellPermissionIdentity()	針對擁有權限採用殼層 UID 的許可權識別。
AdoptShellPermissionIdentity(String[])	針對擁有權限採用殼層 UID 的許可權識別。
ClearCache()	清除協助工具快取。
ClearWindowAnimationFrameStats()	清除視窗動畫轉譯統計資料。
ClearWindowContentFrameStats(Int32)	清除指定視窗內容的框架統計資料。
Clone()	建立並傳回這個 物件的複本。 (繼承來源 Object)
Dispose()	模擬使用者動作和螢幕內容的簡介，以與裝置 UI 互動的類別。 (繼承來源 Object)
Dispose(Boolean)	模擬使用者動作和螢幕內容的簡介，以與裝置 UI 互動的類別。 (繼承來源 Object)
DropShellPermissionIdentity()	卸載先前呼叫 #adoptShellPermissionIdentity() 所採用的殼層許可權識別。
Equals(Object)	指出其他物件是否「等於」這個物件。 (繼承來源 Object)
ExecuteAndWaitForEvent(IRunnable, UiAutomation+IAccessibilityEventFilter, Int64)	執行命令，並等候特定協助工具事件，最多等候指定的等候逾時。
ExecuteShellCommand(String)	執行 shell 命令。
ExecuteShellCommandRw(String)	執行 shell 命令。
ExecuteShellCommandRwe(String)	執行 shell 命令。
FindFocus(NodeFocus)	尋找具有指定焦點類型的檢視。
GetHashCode()	傳回此物件的雜湊碼值。 (繼承來源 Object)
GetWindowContentFrameStats(Int32)	取得指定視窗的框架統計資料。
GrantRuntimePermission(String, String)	授與執行時間許可權給封裝。
GrantRuntimePermissionAsUser(String, String, UserHandle)	將執行時間許可權授與使用者套件。
InjectInputEvent(InputEvent, Boolean)	插入任意輸入事件的方法。
JavaFinalize()	當垃圾收集判斷物件沒有其他參考時，由物件上的垃圾收集行程呼叫。 (繼承來源 Object)
Notify()	喚醒正在等候此物件的監視器的單一線程。 (繼承來源 Object)
NotifyAll()	喚醒正在等候此物件監視器的所有線程。 (繼承來源 Object)
PerformGlobalAction(GlobalAction)	執行全域動作。
RevokeRuntimePermission(String, String)	撤銷套件的執行時間許可權。
RevokeRuntimePermissionAsUser(String, String, UserHandle)	撤銷套件的執行時間許可權。
SetAnimationScale(Single)	設定系統設定值，以控制動畫的縮放比例。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetOnAccessibilityEventListener(UiAutomation+IOnAccessibilityEventListener)	設定回呼以觀察 的 AccessibilityEvent 資料流程。
SetRotation(UiAutomationRotation)	設定裝置旋轉。
SetRunAsMonkey(Boolean)	設定這個 UiAutomation 是否以「魔子」模式執行。
TakeScreenshot()	擷取螢幕擷取畫面。
TakeScreenshot(Window)	用來擷取視窗的螢幕擷取畫面。
ToArray<T>()	模擬使用者動作和螢幕內容的簡介，以與裝置 UI 互動的類別。 (繼承來源 Object)
ToString()	傳回物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	模擬使用者動作和螢幕內容的簡介，以與裝置 UI 互動的類別。 (繼承來源 Object)
Wait()	讓目前的執行緒等到喚醒為止，通常是藉由 < em > notified < /em > 或 < em > interrupted < /em > 來喚醒。 (繼承來源 Object)
Wait(Int64)	讓目前的執行緒等到喚醒為止，通常是 < 透過 em > notified < /em 或 em > interrupted < /em >> ，或 < 直到經過一定數量的即時為止。 (繼承來源 Object)
Wait(Int64, Int32)	讓目前的執行緒等到喚醒為止，通常是 < 透過 em > notified < /em 或 em > interrupted < /em >> ，或 < 直到經過一定數量的即時為止。 (繼承來源 Object)
WaitForIdle(Int64, Int64)	等候協助工具事件資料流程變成閒置狀態，這不會在 內 idleTimeoutMillis 收到協助工具事件。

事件

AccessibilityEvent

模擬使用者動作和螢幕內容的簡介，以與裝置 UI 互動的類別。

明確介面實作

IJavaPeerable.Disposed()	模擬使用者動作和螢幕內容的簡介，以與裝置 UI 互動的類別。 (繼承來源 Object)
IJavaPeerable.DisposeUnlessReferenced()	模擬使用者動作和螢幕內容的簡介，以與裝置 UI 互動的類別。 (繼承來源 Object)
IJavaPeerable.Finalized()	模擬使用者動作和螢幕內容的簡介，以與裝置 UI 互動的類別。 (繼承來源 Object)
IJavaPeerable.JniManagedPeerState	模擬使用者動作和螢幕內容的簡介，以與裝置 UI 互動的類別。 (繼承來源 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	模擬使用者動作和螢幕內容的簡介，以與裝置 UI 互動的類別。 (繼承來源 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	模擬使用者動作和螢幕內容的簡介，以與裝置 UI 互動的類別。 (繼承來源 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	模擬使用者動作和螢幕內容的簡介，以與裝置 UI 互動的類別。 (繼承來源 Object)

擴充方法

JavaCast<TResult>(IJavaObject)	執行 Android 執行時間檢查的類型轉換。
JavaCast<TResult>(IJavaObject)	模擬使用者動作和螢幕內容的簡介，以與裝置 UI 互動的類別。
GetJniTypeName(IJavaPeerable)	模擬使用者動作和螢幕內容的簡介，以與裝置 UI 互動的類別。