Skip to main content

iOS Setup

Prerequisites

  • macOS (required)
  • Xcode installed from the Mac App Store
  • Xcode command line tools: xcode-select --install

Physical device

  1. Connect your iOS device via USB
  2. Tap Trust when prompted on the device
  3. Verify in Xcode that the device appears

Then confirm MobileCLI sees it:

mobilecli devices

Simulator

# List available simulators
xcrun simctl list devices available

# Boot a simulator
xcrun simctl boot "iPhone 16"
open -a Simulator

Or boot directly with MobileCLI:

mobilecli device boot --device <simulator-id>

Troubleshooting

Device not recognized

  • Update to the latest Xcode
  • Disconnect and reconnect
  • Re-trust the computer on the device

Simulator won't start

  • Reset the simulator: xcrun simctl erase <device_udid>
  • Verify command line tools: xcode-select --install