List all available devices. This includes both physical mobile devices and mobile simulators and emulators. It returns both Android and iOS devices.

List all the installed apps on the device

Launch an app on mobile device. Use this to open a specific app. You can find the package name of the app by calling list_apps_on_device.

Stop and terminate an app on mobile device

Install an app on mobile device

Uninstall an app from mobile device

Get the screen size of the mobile device in pixels

Click on the screen at given x,y coordinates. If clicking on an element, use the list_elements_on_screen tool to find the coordinates.

Double-tap on the screen at given x,y coordinates.

Long press on the screen at given x,y coordinates. If long pressing on an element, use the list_elements_on_screen tool to find the coordinates.

List elements on screen and their coordinates, with display text or accessibility label. Do not cache this result.

Press a button on device

Open a URL in browser on device

Swipe on the screen

Type text into the focused element

Save a screenshot of the mobile device to a file

Take a screenshot of the mobile device. Use this to understand what's on screen, if you need to press an element that is available through view hierarchy then you must list elements on screen instead. Do not cache this result.

Change the screen orientation of the device

Get the current screen orientation of the device

Start recording the screen of a mobile device. The recording runs in the background until stopped with mobile_stop_screen_recording. Returns the path where the recording will be saved.

Stop an active screen recording on a mobile device. Returns the file path, size, and approximate duration of the recording.

List crash reports available on the device

Get the full content of a crash report by its ID. Use mobile_list_crashes to find available crash IDs.

连接/重连目标 App 的 in-app 系统 WebView(自动 adb forward),返回当前页 url/title/路由。读 webview DOM 前必须先调它。

在 webview 页面执行 JS 并返回 JSON 结果(Runtime.evaluate,returnByValue+awaitPromise)。⚠ chrome68 老机型禁用 ?./??,用 a&&a.b。

取 webview 内某元素的 computed CSS + 包围盒(getComputedStyle)。

取 webview 内某元素(默认 body)的 outerHTML 概要(截断,排错 DOM 结构用)。

按可见文本点击 webview 内元素(找最外层匹配且可见者)。

page 级截图(Page.captureScreenshot)并落盘,返回文件路径(不回传 base64)。

抓 N 毫秒内 webview 的网络请求(Network 域:url/method/status/类型)。

断开本工具对 webview 的 CDP 连接,释放该 page 的唯一 CDP socket(把 webview 交给 Appium/chromedriver 前先调它)。

列出目标 App webview 的调试目标(/json/list,自动 adb forward),确认 type:page 页面。

按序回放一段步骤(原生+webview 混合,搭积木)。传 steps(内联数组)或 name(已存 flow)二选一;device=默认设备。step 例:[{op:'launch_app',packageName:'..'},{op:'webview_connect',packageName:'..'},{op:'assert_route',contains:'main'},{op:'tap_text',text:'登录'}]。op 全集见 flows.ts(launch_app/terminate_app/tap/tap_text/press_button/swipe/type_keys/screenshot/wait/log + webview_connect/webview_evaluate/webview_computed_style/webview_click_text/webview_disconnect + assert_route/assert_eval)。

把一段步骤序列存为具名 flow(下次用 run_flow name= 直接回放)。

列出所有已存的具名 flow。