List connected Android devices and emulators

List available Android Virtual Devices

Start an Android emulator. Waits up to 60s for it to come online.

Take a screenshot of the Android device. Returns the image for visual analysis. Optionally saves to a file path.

Get the UI element hierarchy of the current screen. Returns interactive elements with their bounds, text, resource IDs, and state. Use this to find elements before tapping.

Tap at specific screen coordinates

Tap a UI element by its resource-id, text, or content-desc. Finds the element in the UI tree and taps its center.

Tap element then wait for UI to settle and return the new UI tree. Combines tap + wait + get_ui_tree into a single fast operation.

Type text into the currently focused input field

Press a hardware/software key

Perform a swipe gesture on the screen

Scroll down repeatedly until an element matching the given criteria is visible

Wait for a UI element to appear on screen. Polls every 500ms.

Launch an Android app by package name

Install an APK file on the device

Get the currently displayed app and activity

Run an arbitrary ADB shell command

Get device logcat output. Use to find crashes, exceptions, and errors after reproducing a bug.

Clear the logcat buffer. Call this before reproducing a bug to get clean logs.

Get device details: model, manufacturer, Android version, API level, screen size, and DPI.

Pull a file from the Android device to the local filesystem.