device_snapshot
Manage device sessions and capture UI snapshots. action=open starts a session (required before other device_ tools). action=snapshot returns the accessibility tree with @ref identifiers for device_press/device_fill. action=close ends the session. Use attachOnly=true on action=open to skip launching the app when it is already running (avoids relaunch-induced bundle races).
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
action | `enum: open | close | snapshot` | No | 'snapshot' |
appId | string | No | App bundle ID — required for action=open (e.g. “com.example.app”) | ||
platform | `enum: ios | android` | No | ||
sessionName | string | No | Session name override (default: auto-generated) | ||
attachOnly | boolean | No | action=open only: skip launching the app. Requires the app to be already running. Use when connecting to an already-active dev session to avoid bundle-load races. |
device_snapshot()