iOS Simulator

How to install Proxyman Certificate to iOS Simulators

In order to capture the HTTP/HTTPS message from your iOS Simulator devices, please navigate to:

  • Certificate Menu -> Install Certificate on iOS -> Simulators

1. 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 built-in on your installed Xcode, which is more modern and reliable than the legacy approach (Use Python custom scripts).

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 install the Certificate in Step 2

Xcode Preview (SwiftUI)

If you're using Xcode Preview for SwiftUI, you can install the certificate into the Xcode Preview Simulator by following:

  1. Open Xcode with Previewer Mode (SwiftUI).

  2. Open Proxyman -> Certificate Menu -> Install for iOS -> Simulator

  3. Click on the Advanced button -> Install for Xcode Preview

You can read more at: https://github.com/ProxymanApp/Proxyman/issues/1568#issue-1610877870

Manually Install

In Proxyman v4.16.0 or later, you can manually install the certificate to your iOS Simulator in case the Automatic Solution doesn't work.

  1. Certificate Menu -> Install for iOS -> Simulator

  2. In Step 2, click on the ↓ button -> Install Manually…

  3. Drag and drop the certificate to your iOS Simulator

2. Troubleshooting

1. Unable to install the Certificate

If you get errors when clicking on Step 2, please open Xcode -> Preferences -> Location tabs -> Select your Xcode in the Command Line Tools.

2. Get SSL Error from HTTPS Response

  • Opening the Setting app -> General -> About -> Certificate Trust Settings and verifying that Proxyman Certificate is installed and trusted.

If it's not installed:

  • Open the iOS Simulator Setup (Certificate Menu -> Install Certificate on iOS -> Simulator) and click on the 2nd button.

  • Or Try the following step to manually install the Certificate.

3. Some HTTP/HTTPS Requests are missing from Proxyman

Alamofire or URLSession might use the cached response for your request. As a result, the actual request doesn't hit the server. Thus, Proxyman could not capture and display it on the app.

Solution:

  • Disable the cache mechanism on URLSession or Alamofre.

  • Use the No Caching Tool (⌥⌘N)

Manually Install the Certificate

If you cannot install the certificate, you can manually do it:

  1. Open Proxyman -> Certificate Menu -> Export -> Root Certificate as DER -> Save to Desktop Folder

  2. Open the Simulator drag the certificate and drop it on the Simulator screen

  3. Open Setting app (on the Simulator) -> General -> Device Management -> Select the Certificate -> Install

  4. Setting app -> General -> About -> Certificate Trust Settings and verifying that Proxyman Certificate is installed and trusted.

  5. Done ✅

Tutorial

See detailed steps to debug an application on iOS Simulator with Proxyman

Last updated