native-app-profiling

# Native App Performance Profiling (CLI) ## Overview Record Time Profiler via `xctrace`, extract samples, symbolicate, and identify hotspots without opening Instruments. ## Quick Start ### 1) Record Time Profiler **Attach to running process:** ```bash # Get the PID first pgrep -x "AppName" # Record for 90 seconds xcrun xctrace record \ --template 'Time Profiler' \ --time-limit 90s \ --output /tmp/App.trace \ --attach <pid> ``` **Launch and record:** ```bash xcrun xctrace record \ --template 'Time Profiler' \ --time-limit 90s \ --output /tmp/App.trace \ --launch -- /path/to/App.app/Contents/MacOS/App ``` ### 2) Export Time Samples List available schemas in the trace: ```bash xcrun xctrace export --input /tmp/App.trace --toc ``` Export time profile data: ```bash xcrun xctrace export \ --input /tmp/App.trace \ --xpath '/trace-toc/run/data/table[@schema="time-profile"]' \ --output /tmp/time-profile.xml ``` ### 3) Get Load Address for Symbolication While the app is running, get the `__TEXT` segment load address: ```bash vmmap <pid> | grep "__TEXT" ``` Look for the load address (typically starts with `0x1...`). ### 4) Symbolicate Stack Frames Use `atos` to symbolicate addresses: ```bash atos -o /path/to/App.app/Contents/MacOS/App -l 0x100000000 <address> ``` ## Workflow Notes - **Correct binary**: Confirm you're profiling the right build (local vs /Applications) - **Trigger the slow path**: During capture, perform the act...