Skip to content
WePROXA
Blog
Windows

WePROXA 3.0.0 now supports Windows and macOS. Windows installation is available from the Microsoft Store.

iOS Simulator

WePROXA can capture HTTP/HTTPS traffic from iOS Simulator, making it easy to debug your iOS app’s network requests during development.

Setup

Section titled “Setup”

  1. Start WePROXA and ensure the proxy is running.

  2. Install the CA certificate on the simulator — WePROXA provides a one-click option to install its certificate on the iOS Simulator. Look for the iOS Simulator option in the certificate menu.

  3. Configure the simulator proxy — iOS Simulator respects the macOS system proxy settings. When WePROXA’s system proxy is enabled, simulator traffic will flow through WePROXA automatically.

  4. Launch your app in the simulator and start making network requests.

Viewing Simulator Traffic

Section titled “Viewing Simulator Traffic”

Traffic from iOS Simulator appears in the request list alongside regular traffic. You can use the source view or filters to identify simulator requests.

When WePROXA can resolve the Simulator app bundle, the Apps source view can show the app’s icon next to its traffic. This makes it easier to distinguish multiple Simulator apps while debugging.

Install the certificate from an AI client

Section titled “Install the certificate from an AI client”

If you drive WePROXA through MCP, the same install is available as a tool call:

  1. Call weproxa_certs_getCaInfo to confirm which certificate you are about to install — it returns the CA’s path, SHA-256 fingerprint, expiry, and whether macOS currently trusts it.
  2. Call weproxa_certs_installToIosSimulator.

It targets the booted simulator and needs an explicit udid when several are booted. The call fails with a clear message when no simulator is booted, when the requested udid is not booted, when the CA has not been generated yet (start the proxy once to create it), or when simctl rejects the certificate. It returns the UDID, the device name reported by simctl, and the certificate path that was installed.

Both the certificate menu and the MCP tool run the same install, so they select simulators and report errors identically.

Tips

Section titled “Tips”
  • Make sure the system proxy is enabled in WePROXA for automatic routing
  • If using a custom proxy configuration in your iOS app, point it to WePROXA’s proxy address (shown in Settings)
  • All WePROXA features (breakpoints, map local, repeat, etc.) work with simulator traffic