run-ios-simulator

What problem does it solve?

The Run iOS Simulator skill streamlines the process of building and launching iPlug2 iOS apps inside the official iOS Simulator, eliminating repetitive manual steps.

Core Features & Use Cases

• Workspace discovery and selection: Identify the iPlug2 Xcode workspace at the repo root and select the correct one when multiple are present.
• Simulator identification and targeting: List available iOS simulators and UDIDs, choose a target device, and manage UDIDs for deterministic runs.
• Build, install, and launch: Build for the iOS Simulator using xcodebuild, locate the built .app, install on the chosen simulator, and launch with xcrun simctl.
• Use Case: Running a demo app in the Simulator to verify UI and AUv3 plugin integration.

Quick Start

Use this skill to run an iPlug2 iOS app in the iOS Simulator seamlessly.

1. Identify the iPlug2 project: look for an .xcworkspace file in the repo root; if multiple exist, pick the appropriate one.
2. List available simulators and UDIDs: xcrun simctl list devices available; pick a device name and note its UDID.
3. Build for Simulator: xcodebuild -workspace [Workspace].xcworkspace -scheme "iOS-APP with AUv3" -configuration Debug -destination 'platform=iOS Simulator,name=[DeviceName]' build
4. Locate the built app: find ~/Library/Developer/Xcode/DerivedData -name "[Project].app" -path "Debug-iphonesimulator" -type d 2>/dev/null | head -1
5. Boot simulator and install/launch: open -a Simulator; xcrun simctl boot [UDID] 2>/dev/null || true; xcrun simctl install [UDID] "[path/to/[Project].app]"; /usr/libexec/PlistBuddy -c "Print :CFBundleIdentifier" "[path/to/[Project].app]/Info.plist"; xcrun simctl launch [UDID] [bundle.identifier]