Master iOS Simulator Debugging: Install, Proxy Setup, and WebView Testing

1. Install & Launch

First install Xcode, then run the command

xcode-select --install

in Terminal to add the Command‑Line Tools.

After installation, locate the Simulator app via Spotlight or press

Command+Shift+G

and enter the path

/Applications/Xcode.app/Contents/Developer/Applications/Simulator.app

to start it.

You can also manage the Simulator from the command line:

List available iOS simulators with

xcrun instruments -s

.

Launch a specific simulator using

xcrun instruments -w <device‑id>

By default only the latest iOS version is available. To add older runtimes, open Device Management (image) and click the plus sign to select “Download more simulator runtime” (image).

2. Configure Proxy

To route simulator network requests to your dev‑server, use

Whistle

together with

Proxifier

.

Install Whistle, start it with

w2 start

, and open

http://127.0.0.1:8899

to set up the dev‑server proxy.

In Proxifier, add an Action rule forwarding traffic to local port

8899

(image), then create a rule for the Simulator application (image). After configuration, requests from the simulator should pass through Whistle.

Note: The first time you use Whistle you must install and trust its certificate as described in the Whistle documentation.

3. Start Debugging

Launch Safari inside the simulator and open the page you want to debug.

On the Mac, enable the Develop menu in Safari Preferences (image).

In the simulator’s Safari, open the page, then select it from the Develop menu on the Mac (image) to begin debugging.

4. WebView Debugging

You can also debug web pages inside an iOS app running on the simulator. Build a simulator‑compatible

.app

package (x86 architecture), drag it onto the simulator, launch the app, and open the target web page. The WebView can then be inspected just like a regular Safari page.

Important: An

.app

built for a physical iPhone cannot run on the simulator because the simulator uses the x86 instruction set.