Skip to content

Commit ada6a4d

Browse files
majdukovicclaude
andcommitted
README: clarify iOS sim must be booted before xcrun simctl install
Beginners hitting `xcrun simctl install booted` with no device booted get an opaque error. Added the explicit boot step (and a fallback to the Xcode Devices and Simulators window) so the install sequence is self-contained. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 60f7009 commit ada6a4d

1 file changed

Lines changed: 9 additions & 6 deletions

File tree

README.md

Lines changed: 9 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -57,17 +57,20 @@ adb install -r FrontRow.apk
5757
The `.app` inside is a Release build for the iOS Simulator on Apple Silicon (`arm64`). It will not run on a physical iPhone or on Intel Macs.
5858

5959
```bash
60-
# Unzip
60+
# 1. Unzip the artifact
6161
unzip FrontRow.app.zip
62-
# Pick a booted simulator (or boot one in Xcode/Simulator.app first)
63-
xcrun simctl list devices booted
64-
# Install
62+
63+
# 2. Make sure a simulator is booted. If `xcrun simctl list devices booted`
64+
# prints no devices, open Xcode → Window → Devices and Simulators and
65+
# boot any iOS 18+ iPhone, or run:
66+
xcrun simctl boot "iPhone 17 Pro" # or any device from `xcrun simctl list devices`
67+
68+
# 3. Install + launch
6569
xcrun simctl install booted FrontRow.app
66-
# Launch
6770
xcrun simctl launch booted app.frontrow.qa
6871
```
6972

70-
Tip: you can also drag-and-drop the unzipped `FrontRow.app` onto the simulator window. Same result.
73+
Tip: you can also drag-and-drop the unzipped `FrontRow.app` onto a running Simulator window — same effect.
7174

7275
**For a real iPhone**: you'll need to build from source with your own provisioning profile (see [Quick start](#quick-start)). A signed `.ipa` for TestFlight may land in a later release.
7376

0 commit comments

Comments
 (0)