PC パソコン

Xcode『Unable to boot the Simulator』の原因と解決方法

XcodeでiOS Simulatorを起動しようとした際に、Unable to boot the Simulator と表示され、シミュレータが起動できないことがあります。

このエラーは、SimulatorやCoreSimulatorサービスの一時的な不調、仮想端末データの破損、ランタイムの不整合、Xcode更新後のキャッシュ問題などで発生します。

主な原因

  • CoreSimulatorサービスが不安定になっている
  • 特定のSimulator端末データが破損している
  • インストール済みのiOS Simulator Runtimeに問題がある
  • Xcode更新後に古いキャッシュや端末情報が残っている
  • macOSの空き容量不足や一時的なシステム不調

代表的な発生状況

代表的には次のような状況で発生します。

  • Xcodeをアップデートした直後
  • 新しいiOS Simulator Runtimeを追加した直後
  • Simulatorを強制終了した後
  • 特定の仮想iPhoneだけ起動できない
  • macOS再起動前後でCoreSimulatorの状態が不整合になった

まず確認すること

1. 別のSimulatorが起動できるか確認する

Xcode上部の実行先から別のiPhone Simulatorを選択して起動します。別端末だけ起動できる場合は、元の仮想端末データが破損している可能性が高いです。

2. 使用可能なSimulatorを確認する

xcrun simctl list devices

Unavailable と表示される端末がないか確認します。

3. macOSの空き容量を確認する

Simulatorは仮想端末ごとに数GB以上の容量を使用することがあります。空き容量が極端に少ない場合は、不要なSimulatorやDerivedDataを整理します。

解決方法1:SimulatorとXcodeを再起動する

まずSimulatorとXcodeを終了し、再度起動します。それでも改善しない場合はmacOSも再起動します。

一時的なCoreSimulatorの不調であれば、再起動だけで解消することがあります。

解決方法2:CoreSimulatorサービスを再起動する

ターミナルで次のコマンドを実行します。

killall -9 com.apple.CoreSimulator.CoreSimulatorService

その後Xcodeを開き直してSimulatorを起動します。

解決方法3:問題のSimulatorをシャットダウンして初期化する

すべてのSimulatorを停止します。

xcrun simctl shutdown all

特定端末を初期化する場合は、Xcodeの Window > Devices and Simulators から対象Simulatorを選び、Erase Contents and Settingsを実行します。

コマンドで全Simulatorを初期化する場合は次を使用できます。

xcrun simctl erase all

注意: eraseを実行するとSimulator内に保存されたアプリ、設定、テストデータが削除されます。

解決方法4:壊れたSimulatorを削除して作り直す

特定端末だけ起動できない場合は、Devices and Simulators画面から問題のSimulatorを削除し、新しいSimulatorを作成します。

不要になったUnavailable端末は次のコマンドでも削除できます。

xcrun simctl delete unavailable

解決方法5:Simulator Runtimeを再インストールする

複数のSimulatorが同じiOSバージョンで起動できない場合は、そのSimulator Runtime自体に問題がある可能性があります。

Xcodeの設定画面から Platforms または対応するコンポーネント管理画面を開き、対象iOS Runtimeを削除して再ダウンロードします。

解決方法6:DerivedDataを削除する

ビルドキャッシュの不整合が疑われる場合はDerivedDataを削除します。

rm -rf ~/Library/Developer/Xcode/DerivedData/*

削除後、Xcodeを再起動してプロジェクトを再ビルドします。

解決方法7:Xcodeの選択状態を確認する

複数バージョンのXcodeをインストールしている場合、コマンドラインツールが別のXcodeを参照していることがあります。

xcode-select -p

必要に応じて使用するXcodeへ切り替えます。

sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

解決方法8:XcodeとmacOSを更新する

新しいiOS Simulator Runtimeを古いXcodeで扱っている場合や、XcodeとmacOSの組み合わせが古い場合は正常に起動できないことがあります。使用中のmacOSで利用可能な最新安定版Xcodeへ更新し、必要ならmacOSも更新します。

注意点

  • xcrun simctl erase all はすべてのSimulatorデータを消去します。
  • Simulator Runtimeの再インストールはダウンロード容量が大きくなることがあります。
  • 実機で正常に動作していてもSimulator固有の問題で起動できない場合があります。
  • 複数Xcode環境では、xcode-select の参照先を必ず確認してください。

まとめ

Unable to boot the Simulator は、CoreSimulatorサービスの不調や仮想端末データ、Simulator Runtime、Xcodeキャッシュの不整合などで発生します。

まず別Simulatorで再現するか確認し、Xcode・macOSの再起動、CoreSimulatorサービス再起動、対象Simulatorの初期化や再作成を順に試してください。それでも解決しない場合はSimulator Runtimeの再インストール、DerivedData削除、XcodeとmacOSの更新を確認すると効果的です。