iOS Instruments Performance CLI

Instructions

When helping with iOS app performance optimization using Instruments command line tools:

1. Setup Analysis Environment

CRITICAL: Always use device UUID, never device names

• Get device UUID: xcrun simctl list devices available | grep "iPhone"
• Device names like "iPhone 17 Pro" are ambiguous and will fail
• Use UUID format: F464E766-555C-4B95-B8CC-763702A70791

Clean installation state (REQUIRED)

• Always uninstall app before profiling: xcrun simctl uninstall $DEVICE_UUID <bundle id>
• Multiple app installations cause "process is ambiguous" errors
• Alternative: Completely erase simulator for cleanest state