iOS Simulator

In order to capture the HTTP/HTTPS message from your iOS Simulator devices, please navigate to:
Certificate Menu -> Install Certificate on iOS -> Simulators
iOS Simulator Setup Guide
It works for iOS, iPadOS, tvOS and watchOS.
The following photo describes three steps:
1.Install Root Proxyman Certificate on your machine: You can follow the macOS Guide.
2.Install Proxyman Certificate to all available simulators, which you have opened at least one time.
3.Reset the Simulator: Proxyman tries to reset all simulators, so it will load the new Certificate.
From Proxyman 2.19.0+, Proxyman uses the simctl command line to perform tasks. 
simctl is a built-in on your installed Xcode, which is modern and reliable than the legacy approach (Use custom scripts). If simctl doesn't work, you can switch back to the legacy in Preference -> Advanced Tab -> Use the `simctl` for iOS Simulators.
This step only installs on Simulators, which you have open at least one time
For instance, if you would like to debug on iPhone X Simulator, please make sure to open the iPhone X Simulator first, then installing the Certificate in Step 2 
Troubleshooting
1. I am still unable to see HTTPS Response and get SSL Error from my iOS Simulator
Opening the Setting app -> General -> About -> Certificate Trust Settings and verify that Proxyman Certificate is installed and trusted
Proxyman Certificate is installed and trusted properly
If it's not installed, please open the iOS Simulator Setup (Certificate Menu -> Install Certificate on iOS -> Simulator) and click on the 2nd button.
If it does not work again, please try using Legacy Code in Proxyman Preference -> Advanced -> Un-check `Use simctl for iOS Simulator` then trying again.
Alternative approach
If you could not install the certificate, you can manually do it:
1.Export the Proxyman Certificate: Certificate Menu -> Export Proxyman Certificate -> Select Desktop folder and Save
2.Open the Simulator and drag the certificate and drop it on the Simulator screen
3.Quit the Simulator and re-open 
SSL Proxying
After the installation, we can start capture and view HTTPS messages by following SSL Proxying Doc ​
Tutorial
See detailed steps to debug an application on iOS Simulator with Proxyman

Debug on Devices - Previous

iOS Device

Next - Debug on Devices

tvOS & watchOS

Last modified 9mo ago

Copy link

Contents

iOS Simulator Setup Guide