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.