run-ios-simulator

Build and launch iPlug2 iOS apps in the iOS Simulator with xcodebuild and xcrun simctl.

152|37|Updated Feb 3, 2020
One-click install
npx skills add https://github.com/iPlug2/iPlug2OOS --skill run-ios-simulator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: run-ios-simulator
Source: https://github.com/iPlug2/iPlug2OOS/tree/main/.claude/skills/run-ios-simulator
Command: npx skills add https://github.com/iPlug2/iPlug2OOS --skill run-ios-simulator

SYSTEM DOCUMENTATION & REQUIREMENTS

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]

Frequently Asked Questions about run-ios-simulator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build and run an iPlug2 iOS app in the Simulator from the command line?

To build and run an iPlug2 iOS app in the Simulator, use xcodebuild to compile the workspace for an iOS Simulator destination, then use xcrun simctl to install and launch the built .app file using its UDID and bundle identifier.

How do I find the UDID of an available iOS Simulator for xcodebuild deployment?

Find the UDID of an available iOS Simulator by running the command 'xcrun simctl list devices available', which lists all simulator targets and their corresponding UDIDs needed for deterministic xcrun simctl boot and install commands.

Where does Xcode store the built .app file for iOS Simulator testing?

Xcode stores the built .app file for iOS Simulator testing within the DerivedData directory, specifically under a path containing 'Debug-iphonesimulator', which you can locate using the find command before installing it via xcrun simctl.

Can I test AUv3 plugin integration in an iPlug2 project using the iOS Simulator?

Yes, you can test AUv3 plugin integration in an iPlug2 project by building the 'iOS-APP with AUv3' scheme using xcodebuild and deploying the resulting application to the iOS Simulator to verify the UI and plugin functionality.

How do I launch an installed app in the iOS Simulator using simctl?

Launch an installed app in the iOS Simulator using simctl by first extracting the CFBundleIdentifier from the app's Info.plist using PlistBuddy, then executing 'xcrun simctl launch [UDID] [bundle.identifier]' on the booted simulator.