Debugging an iOS App

Physical device

1. Make sure the iPhone/iPad is on the same Wi-Fi network as your Mac.
2. On the Mac, start capture (⌘R), then click Connect Device (QR icon) in the toolbar.
3. Scan the QR code with the iPhone’s camera — this opens Safari to the CA install URL and downloads a configuration profile. On the same network as a Mac but don’t want to scan a QR code? Use the AirDrop share button next to the certificate in Settings → Certificate to send the CA profile directly to the iPhone instead.
4. Install the profile: Settings → General → VPN & Device Management → TonyProxy CA → Install.
5. Trust it fully: Settings → General → About → Certificate Trust Settings → enable full trust for TonyProxy CA. Skipping this step is the #1 cause of “installed but still not decrypting” — see Certificate Problems.
6. Set the Wi-Fi proxy: Settings → Wi-Fi → (i) next to your network → Configure Proxy → Manual → enter your Mac’s LAN IP and the port shown in TonyProxy (9090 by default).

Simulator

The iOS Simulator shares your Mac’s network stack, so once TonyProxy is set as this Mac’s system proxy (automatic once capture starts and the helper daemon is approved), Simulator traffic routes through it with no extra proxy configuration. You still need to trust the CA — install it via Settings → Certificate → Install on the Mac, or open the cert install URL directly inside Safari in the Simulator and trust it the same way as the physical-device steps above.

Certificate pinning

Apps using certificate pinning (checking the server’s exact cert instead of trusting any CA in the chain) will keep failing even with the CA trusted — that’s the app’s own defense against MITM proxies like this one working as designed. See HTTPS Decryption Issues.