xcrun simctlが見つからない? 2つの原因と直し方
xcrun simctl listと入力すると、シミュレータの一覧ではなくエラーが出る。この原因は2つあり、直し方も違います。どちらなのかは、エラーの文面でわかります。
当社では、新しいMac miniのラック全体で2つめの問題に遭遇しました。Xcodeはインストール済みで、xcodebuild -versionも動きました。それでもiOSシミュレータのビルドはすべて失敗するところでした。それぞれのエラーの意味と、実際に直したコマンドを説明します。
どちらのエラーですか?
| 表示されるエラー | 意味 | 確認方法 | 直し方 |
|---|---|---|---|
| xcrun: unable to find utility "simctl" | XcodeではなくCommand Line Toolsが選択されている | xcode-select -p | sudo xcode-select -s /Applications/Xcode.app |
| simctl: No such file or directory | Xcodeの初回起動処理が実行されていない | xcodebuild -checkFirstLaunchStatus | sudo xcodebuild -runFirstLaunch |
原因1:Command Line Toolsが選択されている
メッセージは次のとおりです。
xcrun: error: unable to find utility "simctl", not a developer tool or in PATH
Command Line Toolsにはコンパイラとgitが入っていますが、シミュレータはありません。これがアクティブなデベロッパディレクトリだと、xcrunはそこを探してsimctlを見つけられません。どちらがアクティブか確認します。
xcode-select -p # /Library/Developer/CommandLineTools (the problem) # /Applications/Xcode.app/Contents/Developer (what you want)
Xcodeに向けます。Xcodeの名前にバージョンが入っている場合は、実際のパスを使ってください。
sudo xcode-select -s /Applications/Xcode.app xcrun simctl list runtimes
原因2:Xcodeの初回起動処理が実行されていない
こちらはもっと奇妙に見えます。Xcodeは選択されているのに、simctl自体が失敗します。
Install Started Install Failed: Authorization is required to install the packages. /Applications/Xcode.app/Contents/Developer/usr/bin/simctl: line 15: /Library/Developer/PrivateFrameworks/CoreSimulator.framework/Versions/A/Resources/bin/simctl: No such file or directory
Xcodeを初めて開くと、いくつかのシステムパッケージがインストールされます。そのひとつが/Library/Developer/PrivateFrameworksにあるCoreSimulatorです。Xcode内のsimctlは小さなスクリプトで、処理をこのフレームワークに渡します。Xcodeをインストールしても一度も開いていなければ、このフレームワークはありません。
これはCIマシンやヘッドレスのMacでよく起きます。誰もそこでXcodeを開かないからです。xcodesのようにXcodeをインストールしてくれるツールは、アプリをコピーしますが初回起動処理は実行しません。次のように確認できます。
xcodebuild -checkFirstLaunchStatus; echo $? # 69 means first launch has not run. 0 means it has.
直し方はコマンド2つです。
# 1. install Xcode's first-launch packages, including CoreSimulator sudo xcodebuild -runFirstLaunch # 2. install an iOS simulator runtime if there is none sudo xcodebuild -downloadPlatform iOS
Xcode 26.6を入れた当社のM6 miniでは、1つめのコマンドは8秒で終わりました。2つめはiOS 26.5のランタイムを約4分半でダウンロードし、ディスクを約9 GB使いました。Apple IDは不要でした。その後の結果です。
xcrun simctl list runtimes == Runtimes == iOS 26.5 (26.5 - 23F77) - com.apple.CoreSimulator.SimRuntime.iOS-26-5
CI用のMacに自分自身をチェックさせる
落とし穴は、この問題があるMacでもxcodebuild -versionが普通に動くことです。これを使ったヘルスチェックは通り、最初のシミュレータビルドで失敗します。代わりに、本当に必要なものを確認しましょう。
当社では現在、Macをフリートに加えるときにこれらのチェックを実行しています。MacRunのマシンはどれも、Xcodeの初回起動処理が済み、iOSシミュレータのランタイムもインストール済みです。そのため、最初のビルドからそのまま動きます。
よくある質問
- xcrunがsimctlを見つけられないのはなぜですか?
- 多くの場合、アクティブなデベロッパディレクトリがXcodeではなくCommand Line Toolsになっているためです。Command Line Toolsにはシミュレータのツールがありません。sudo xcode-select -s /Applications/Xcode.app でxcode-selectをXcodeに向けてから、もう一度試してください。
- 「simctl: No such file or directory」とはどういう意味ですか?
- Xcodeは選択されていますが、初回起動時のパッケージがインストールされていません。これらのパッケージはCoreSimulatorを/Library/Developer/PrivateFrameworksに配置します。sudo xcodebuild -runFirstLaunch を実行してインストールしてください。
- xcodebuild -downloadPlatform iOSにはApple IDが必要ですか?
- いいえ。Xcode 26.6を入れた当社のMacでは、サインインなしでiOS 26.5のシミュレータランタイムをダウンロードしてインストールできました。所要時間は約4分半で、ディスクを約9 GB使いました。
- ビルドの前に、CI用のMacの準備ができているか確認するには?
- xcodebuild -checkFirstLaunchStatus を実行します。初回起動が済んでいれば0を返します。次に xcrun simctl list runtimes を実行し、iOSの行が少なくとも1つあるか確認します。