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の更新を確認すると効果的です。
