UiAutomatorTestScope

fun activeWindowRoot(): AccessibilityNodeInfo

Returns the active window root node. Note that calling this method after startApp, startActivity or startIntent without waiting for the app to be visible, will return the active window root at the time of starting the app, i.e. the root of the launcher if starting from there.

fun clearAppData(): Unit

Clears the instrumentation test target app data.

fun onView(timeoutMs: Long = 10000, pollIntervalMs: Long = 100, block: AccessibilityNodeInfo.() -> Boolean): UiObject2

Performs a DFS on the accessibility tree starting from the root node in the active window and returns the first node matching the given block. The node is returned as an UiObject2 that allows interacting with it. Internally it works searching periodically every pollIntervalMs.

Example:

onView { textAsString == "Search" }.click()

fun onViewOrNull(
    timeoutMs: Long = 10000,
    pollIntervalMs: Long = 100,
    block: AccessibilityNodeInfo.() -> Boolean
): UiObject2?

Performs a DFS on the accessibility tree starting from the root node in the active window and returns the first node matching the given block. The node is returned as an UiObject2 that allows interacting with it. Internally it works searching periodically every pollIntervalMs.

Example:

onView { textAsString == "Search" }.click()

fun onViews(timeoutMs: Long = 10000, pollIntervalMs: Long = 100, block: AccessibilityNodeInfo.() -> Boolean): List<UiObject2>

Performs a DFS on the accessibility tree starting from the root node in the active window and returns the first node matching the given block. The node is returned as an UiObject2 that allows interacting with it. Internally it works searching periodically every pollIntervalMs.

Example:

node.onViews { isClass(Button::class.java) }

fun pressBack(): Boolean

Press the back key.

fun pressDelete(count: Int): Unit

Similar to type but presses the delete key for the given count times.

fun pressEnter(): Boolean

Press the enter key.

fun pressHome(): Boolean

Press the home key.

fun startActivity(clazz: Class<*>): Unit

Starts an activity with the given class.

fun startActivity(packageName: String, activityName: String): Unit

Starts an activity with the given packageName and activityName.

fun startApp(): Unit

Starts the instrumentation test target app using the target app package name.

fun startApp(packageName: String): Unit

Starts the app with the given packageName.

fun startIntent(intent: Intent): Unit

Starts the given intent.

fun type(text: String): Unit

Types the given text string simulating key press through Instrumentation.sendKeySync. This is similar to tapping the keys on a virtual keyboard and will trigger the same listeners in the target app, as opposed to AccessibilityNodeInfo.setText that programmaticaly sets the given text in the target node.

fun unregisterWatchers(): Unit

Unregisters all the watchers previously registered with watchFor.

fun waitForAppToBeVisible(
    appPackageName: String = instrumentation.targetContext.packageName,
    timeoutMs: Long = 10000
): Boolean

Waits for an application to become visible. Note that internally it checks if an accessibility node with the given appPackageName exists in the accessibility tree.

fun waitForStableInActiveWindow(
    stableTimeoutMs: Long = 3000,
    stableIntervalMs: Long = 500,
    stablePollIntervalMs: Long = 50,
    requireStableScreenshot: Boolean = true
): StableResult

Waits for the root node of the active window to become stable.

A node is considered stable when it and its descendants have not changed over an interval of time. Optionally also the node image can be checked. Internally it works checking periodically that the internal properties of the node have not changed.

fun <T : Any?> watchFor(watcher: ScopedUiWatcher<T>, block: T.() -> Unit): WatcherRegistration

Registers a watcher for this androidx.test.uiautomator.UiAutomatorTestScope to handle unexpected UI elements. Internally this method uses the existing UiDevice.registerWatcher api. When the given ScopedUiWatcher.isVisible condition is satisfied, then the given block is executed. scope. This method returns a handler with the WatcherRegistration to unregister it before the block is complete. Note that this api helps with unexpected ui elements, such as system dialogs, and that for expected dialogs the onView api should be used.

Usage:

@Test fun myTest() = uiAutomator {

    // Registers a watcher for a permission dialog.
    watchFor(PermissionDialog) { clickAllow() }

    // Registers a watcher for a custom dialog and unregisters it.
    val registration = watchFor(MyDialog) { clickSomething() }
    // Do something...
    registration.unregister()
}

fun windowRoots(): List<AccessibilityNodeInfo>

Returns all the window roots on all the displays.

fun windows(): List<AccessibilityWindowInfo>

Returns all the windows on all the displays.