iOS シミュレータ
macOS 上の Proxyman で iOS シミュレータの HTTP/HTTPS 通信をキャプチャします。証明書の自動セットアップ、手動インストール、通信が表示されない場合の確認方法を解説します。
Mac 上の Proxyman を使用して、iOS シミュレータから送信される HTTP/HTTPS リクエストをキャプチャして確認します。まずは証明書の自動インストールを試してください。インストールに失敗した場合は、後述の手動手順を使用してください。
始める前に、Xcode をインストールし、デバッグしたいシミュレータを一度は開いておいてください。アプリでリクエストを再現する間は、Proxyman を起動したままにしてください。HTTPS の通信を確認するには、証明書をインストールして信頼させたうえで、対象ドメインの SSL Proxying を有効にします。
Proxyman でシミュレータ向けのセットアップガイドを開きます：
- Certificate メニュー → Install Certificate on iOS → Simulators
動画
1. iOS シミュレータのセットアップガイド
iOS シミュレータのセットアップ
iOS、iPadOS、tvOS、watchOS、visionOS に対応しています。
セットアップガイドには 3 つの手順があります：
- Mac に Root Proxyman Certificate をインストールします。macOS ガイドの手順に従ってください。
- 一度は開いたことがあるすべてのシミュレータに Proxyman 証明書をインストールします（Prepare Simulators をクリック）。
- シミュレータを再起動: Proxyman はすべてのシミュレータを再起動し、新しい証明書を読み込ませます。
Proxyman 2.19.0 以降では、これらの作業に simctl コマンドラインを使用します。
simctl は Xcode に含まれています。従来の方法（カスタムの Python スクリプト）よりも新しく、信頼性の高い方法です。
この手順では、一度は開いたことがあるシミュレータにのみ証明書をインストールします。
たとえば iPhone X Simulator でデバッグするには、まず iPhone X Simulator を開き、手順 2 で証明書をインストールしてください。
Xcode Preview（SwiftUI）
SwiftUI の Xcode Preview を使用している場合は、Xcode Preview シミュレータに証明書をインストールできます：
- SwiftUI のプレビューキャンバスを表示した状態で Xcode を開きます。
- Proxyman を開き、Certificate メニュー → Install Certificate on iOS → Simulators を選択します。
- 手順 2 で、Prepare Simulators ボタンの横にある ↓ ボタンをクリックし、Install to Xcode Preview (SwiftUI) を選択します。
詳しくは GitHub issue #1568 をご覧ください。
手動でインストールする
Proxyman v4.16.0 以降では、自動インストールがうまくいかない場合に、iOS シミュレータへ証明書を手動でインストールできます。
- Certificate メニュー → Install Certificate on iOS → Simulators
- 手順 2 で、Prepare Simulators ボタンの横にある ↓ ボタンをクリックし、Install Manually… を選択します。
証明書を手動でインストール
- 証明書を iOS シミュレータにドラッグ＆ドロップします。
証明書をシミュレータにドラッグしてから、信頼させます
- iOS シミュレータで 設定 アプリ → 一般 → 情報 → 証明書信頼設定 を開き、Proxyman CA 証明書を見つけてスイッチをオンにします。
- 完了
2. トラブルシューティング
リクエストの一覧が空の場合は、まず 通信が表示されない場合のチェックリスト を使って、記録、フィルタ、プロキシの設定を確認してください。リクエストは表示されるのに HTTPS が失敗する場合は、証明書のインストールと SSL Proxying を確認してください。以下のセクションでは、インストールのエラーとキャッシュされたリクエストについて説明します。
1. 証明書をインストールできない
手順 2 のボタンをクリックしてエラーが出る場合は、Xcode → Settings → Locations タブを開き、Command Line Tools で使用中の Xcode を選択してください。
2. HTTPS レスポンスで SSL エラーが発生する
- 設定 アプリ → 一般 → 情報 → 証明書信頼設定 を開き、Proxyman 証明書がインストールされて信頼されていることを確認します。
インストールされていない場合：
- iOS シミュレータのセットアップ（Certificate メニュー → Install Certificate on iOS → Simulators）を開き、手順 2 のボタンをクリックします。
- または、下の 証明書をエクスポートして手動でインストールする の手順を試してください。
3. 一部の HTTP/HTTPS リクエストが Proxyman に表示されない
Alamofire や URLSession が、リクエストに対してキャッシュされたレスポンスを使用することがあります。その結果、実際のリクエストはサーバーに届かず、Proxyman でキャプチャも表示もできません。
解決方法：
- URLSession または Alamofire のキャッシュの仕組みを無効にします。
- No Caching ツール（⌥⌘N）を使用します。
証明書をエクスポートして手動でインストールする
証明書をインストールできない場合は、手動でインストールできます：
- Proxyman を開き、Certificate メニュー → Export → Root Certificate as DER を選択して、デスクトップ フォルダに保存します。
- Simulator を開き、証明書を Simulator の画面にドラッグ＆ドロップします。
- （Simulator 上の）設定 アプリ → 一般 → VPN とデバイス管理（古い iOS では デバイス管理）を開き、証明書を選択して インストール をタップします。
- 設定 アプリ → 一般 → 情報 → 証明書信頼設定 を開き、Proxyman 証明書がインストールされて信頼されていることを確認します。
- 完了 ✅
チュートリアル
Proxyman で iOS シミュレータ上のアプリをデバッグする詳しい手順は、こちらの記事をご覧ください。