Simulators

Mavster targets iOS through the standard iOS Simulator. You manage your simulator inventory in Xcode; Mavster discovers what's available and drives whichever one you select in the Preview Connection picker.

Downloading a simulator runtime

If Mavster's picker shows no simulators, you don't have any iOS runtime installed.

1. Open Xcode → Settings → Platforms.
2. Click + and download an iOS runtime (any recent iOS version).
3. Open Xcode → Window → Devices and Simulators → Simulators tab and create a new iPhone simulator with that runtime if one doesn't exist by default.

Mavster will see the new device on its next refresh.

What Mavster shows in the picker

• Only iPhone simulators — iPad simulators are not supported yet.
• Running simulators appear at the top, then available (stopped) ones below.
• A simulator is reported as Booted (No Window) when the underlying simulator process is booted but the Simulator app isn't open. Click refresh in the picker to update this.

Multiple Mavster windows and the same simulator

When a Mavster window connects to a simulator, it reserves it for that window. A second Mavster window that tries to use the same simulator will see:

Simulator is already in use by Window N.

The picker also annotates simulators that are already in use by another window so you can tell at a glance which devices are free.

Common "no simulators found" causes

• Xcode Command Line Tools are missing or pointing at the wrong path — see Xcode & command-line tools.
• No iOS runtime is installed — open Xcode → Settings → Platforms and download one.
• The only simulators you have are iPads — iPad simulators are not supported yet. Create an iPhone simulator.
• A simulator boots but Mavster reports Booted (No Window). Click refresh in the picker, or open the Simulator app from Spotlight.