iOS Simulator

Automate iOS Simulator workflows: build, launch, interact with apps, and capture artifacts.

Fundamentals

Build and launch

cd <project-dir>
xcodegen generate 2>&1  # if project.yml exists
xcodebuild -project *.xcodeproj -scheme <scheme> \
  -destination 'platform=iOS Simulator,name=<device>' build 2>&1 | tail -5
xcrun simctl boot "<device>" 2>&1 || true
open -a Simulator
APP_PATH=$(find ~/Library/Developer/Xcode/DerivedData/<project>-*/Build/Products/Debug-iphonesimulator/*.app -maxdepth 0 | head -1)
xcrun simctl install "<device>" "$APP_PATH"
xcrun simctl launch "<device>" <bundle-id>
sleep 3

Simulator interaction

See references/simulator-interaction.md for coordinate mapping, click patterns, and device info.

Key constraints

• Simulator clicks are unreliable for nav bar buttons and back navigation
• Always relaunch app to navigate to deep screens rather than trying back buttons
• Wait 3+ seconds after launch before clicking
• Use focus click + real click pattern for reliable interaction
• Query window position fresh each time — it shifts between sessions

Workflows