# iOS Setup

## Prerequisites[​](#prerequisites "Direct link to Prerequisites")

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

## Physical device[​](#physical-device "Direct link to 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[​](#simulator "Direct link to 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[​](#troubleshooting "Direct link to Troubleshooting")

### Device not recognized[​](#device-not-recognized "Direct link to Device not recognized")

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

### Simulator won't start[​](#simulator-wont-start "Direct link to Simulator won't start")

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