Performance traces¶
| Tool | What it does | Platforms | Needs |
|---|---|---|---|
📈 performanceTrace |
Record a native performance trace | 🤖 🍎 | — |
performanceTrace records an Instruments trace (xctrace) on iOS or a Perfetto trace on Android.
Call it with action: "start" and a template to begin recording. It returns a traceId. Call
it with action: "stop" and that traceId to stop the recorder and get the artifact path and a
summary.
iOS: unsupported Xcode and simulator combinations¶
With some Xcode versions, xctrace never finishes saving a trace on some simulator runtimes.
Stopping such a recording would wait until the stop timeout and return a trace with no data, so
start refuses these combinations before it records:
| Xcode | Simulator runtime |
|---|---|
| 26.6.x | iOS 26.5.x |
A refused start fails with an error that names the Xcode version and the simulator runtime. To
trace, choose one of these:
- Run AutoMobile with Xcode 27.x, for example by starting the daemon with
DEVELOPER_DIR=/Applications/Xcode-27.app/Contents/Developer. - Trace on a simulator with a different iOS runtime.
The check applies to simulators only. If AutoMobile cannot read the Xcode version or the simulator runtime, it records as usual.