この記事の要点

Xcode から iPhone 実機で実行しようとしたときの「iPhone is busy: Preparing debugger support」はエラーではなく準備中の表示 原因: Xcode が iPhone からデバッグ用のシンボル情報を取り込み中。初めて接続した端末や iOS を更新した直後に出る 対処 1: iPhone のロックを解除したまま、ケーブル接続で数分〜十数分待つ（これで解決することが多い） 対処 2: 進まないときは iPhone・Mac・Xcode の再起動、ペアリングのやり直し 端末の iOS が Xcode より新しいと終わらない。Xcode を最新版に更新する

エラー内容

...のiPhone is busy: Preparing debugger support for ...のiPhone
Xcode will continue when ...のiPhone is finished.

Xcode のツールバー（実行先の表示部分）や警告ダイアログにこのメッセージが表示され、Run ボタンを押してもアプリのインストールが始まりません。英語の意味は「iPhone は使用中です: デバッガのサポートを準備しています。完了したら Xcode は続行します」です。

原因: デバッグ用の情報を準備している

Xcode で実機デバッグをするには、その iPhone の iOS バージョンに対応したシンボル情報（システムライブラリのデバッグ用データ）が Mac 側に必要です。端末を初めて接続したときや、iPhone の iOS をアップデートした直後は、Xcode がこの情報を iPhone から取り込んで準備します。この処理が終わるまでの間、このメッセージが表示されます。

取り込むデータ量が多いため、環境によっては数分から十数分かかることがあります。つまり多くの場合、壊れているのではなく待てば終わる状態です。

状況	考えられる原因
初めて接続した iPhone	その iOS バージョンの情報がまだ Mac に無い
iOS をアップデートした直後	新しい iOS 用の情報を取り込み直している
Wi-Fi 経由で接続している	転送が遅く、時間が長くかかる
いつまでも終わらない	iPhone がロックされている、接続が不安定、Xcode が iOS バージョンに未対応

対処法

以下の順番で試してください。上から手軽な順です。

1. 数分〜十数分待つ。Xcode の上部に進捗が表示されている間は、そのまま待つのが一番の近道です（結構これで解決します）
2. iPhone のロックを解除したままにする。画面がロックされると処理が進まないことがあります。待つ間は自動ロックを一時的に「なし」にしておくと確実です
3. USB ケーブルで接続する。Wi-Fi 接続（ネットワーク経由のデバッグ）よりも速く安定します。ケーブルは充電専用ではなくデータ通信対応のものを使います
4. iPhone で起動中のアプリを全て停止する
5. iPhone を再起動する。あわせて Xcode も終了して起動し直します
6. Mac を再起動する
7. ペアリングをやり直す。Xcode のメニュー「Window」→「Devices and Simulators」で対象の iPhone を右クリックして「Unpair Device」を選び、ケーブルを挿し直して iPhone 側で「このコンピュータを信頼」をタップします
8. Xcode を更新する。iPhone の iOS が、インストール済みの Xcode より新しいバージョンだと準備が完了しません。App Store などから最新の Xcode に更新します

それでも直らないときの確認事項

• デベロッパモード: iOS 16 以降では、iPhone の「設定」→「プライバシーとセキュリティ」→「デベロッパモード」をオンにしないと実機実行できません（一度 Xcode と接続すると項目が表示されます）
• ストレージ容量: Mac の空き容量が少ないと、シンボル情報を保存できずに失敗することがあります
• 古いキャッシュ: 以前の取り込みデータが壊れている場合は、ホームフォルダの「ライブラリ/Developer/Xcode/iOS DeviceSupport」内の該当バージョンのフォルダを削除してから接続し直すと、取り込みがやり直されます（削除しても次回接続時に再作成されます）
• ケーブル・ハブ: USB ハブ経由で不安定な場合は、Mac 本体のポートに直接つなぎます

確認方法

準備が完了すると、Xcode のツールバーの実行先に iPhone の名前が通常どおり表示され、メッセージが消えます。「Devices and Simulators」ウィンドウで対象の iPhone を選び、エラー表示が無ければ準備は完了しています。その状態で Run（⌘R）を押し、アプリがインストールされて起動すれば解決です。

次回以降、同じ iOS バージョンの端末を接続したときは、この準備はほとんど時間がかかりません。iOS をアップデートしたら再び待ち時間が発生する、と覚えておくと慌てずに済みます。

よくある質問

Q. 待っている間に Xcode を閉じてもよい？
A. 閉じると準備が中断され、次に開いたときに最初からやり直しになることがあります。初回は時間に余裕のあるときに、Xcode を開いたまま完了を待つのがおすすめです。

Q. 毎回このメッセージが出て時間がかかる
A. 同じ iOS バージョンなら本来は 2 回目以降はすぐに終わります。毎回出る場合は、Mac の空き容量不足で保存に失敗している、または複数の Xcode を切り替えて使っている可能性があります。空き容量と、使用中の Xcode（「Xcode」→「Settings」→「Locations」の Command Line Tools）を確認してください。

Q. シミュレータでも同じメッセージが出る？
A. このメッセージは実機（iPhone・iPad）をデバッグするときのものです。急ぎの動作確認であれば、準備が終わるまでの間はシミュレータで確認を進めるのも一つの方法です。

関連

• Xcodeでアプリを実機起動｜デバイス信頼・開発者モードと起動手順
• Xcodeとは｜iOS・macOS開発統合環境とSwift・シミュレータ・実機ビルド
• Xcode プロジェクトのファイル構成と役割完全ガイド