xcrun simctl not found? Die zwei Ursachen und die Lösung
Sie tippen xcrun simctl list und bekommen statt der Simulatoren einen Fehler. Zwei verschiedene Probleme verursachen das, und sie brauchen verschiedene Lösungen. Der Fehlertext verrät Ihnen, welches Sie haben.
Uns traf das zweite auf einem ganzen Rack neuer Mac minis. Xcode war installiert, und xcodebuild -version funktionierte. Trotzdem wäre jeder Build für den iOS-Simulator fehlgeschlagen. Hier steht, was jeder Fehler bedeutet. Dazu die genauen Befehle, die ihn behoben haben.
Welchen Fehler haben Sie?
| Sie sehen | Das bedeutet | Prüfen mit | Lösung |
|---|---|---|---|
| xcrun: unable to find utility "simctl" | Die Command Line Tools sind ausgewählt, nicht Xcode | xcode-select -p | sudo xcode-select -s /Applications/Xcode.app |
| simctl: No such file or directory | Der erste Start von Xcode lief nie | xcodebuild -checkFirstLaunchStatus | sudo xcodebuild -runFirstLaunch |
Ursache 1: Die Command Line Tools sind ausgewählt
Das ist die Meldung:
xcrun: error: unable to find utility "simctl", not a developer tool or in PATH
Die Command Line Tools liefern Compiler und git, aber keine Simulatoren. Sind sie das aktive Entwicklerverzeichnis, sucht xcrun dort und findet kein simctl. Prüfen Sie, welches aktiv ist:
xcode-select -p # /Library/Developer/CommandLineTools (the problem) # /Applications/Xcode.app/Contents/Developer (what you want)
Richten Sie es auf Xcode aus. Nehmen Sie den echten Pfad, falls Ihr Xcode eine Version im Namen trägt.
sudo xcode-select -s /Applications/Xcode.app xcrun simctl list runtimes
Ursache 2: Der erste Start von Xcode lief nie
Dieser Fall sieht seltsamer aus. Xcode ist ausgewählt, und simctl selbst schlägt fehl:
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
Beim ersten Öffnen installiert Xcode einige Systempakete. Eines davon ist CoreSimulator, in /Library/Developer/PrivateFrameworks. Das simctl in Xcode ist ein kleines Skript, das an dieses Framework weiterreicht. Wurde Xcode installiert, aber nie geöffnet, fehlt das Framework.
Auf CI-Maschinen und headless Macs ist das häufig. Dort öffnet niemand Xcode. Werkzeuge, die Xcode für Sie installieren, etwa xcodes, kopieren die App, führen aber den ersten Start nicht aus. Sie können es prüfen:
xcodebuild -checkFirstLaunchStatus; echo $? # 69 means first launch has not run. 0 means it has.
Die Lösung sind zwei Befehle:
# 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
Auf unseren M6 minis mit Xcode 26.6 dauerte der erste Befehl 8 Sekunden. Der zweite lud die iOS-26.5-Runtime in etwa viereinhalb Minuten herunter und belegte etwa 9 GB Speicherplatz. Eine Apple-ID war nicht nötig. Danach:
xcrun simctl list runtimes == Runtimes == iOS 26.5 (26.5 - 23F77) - com.apple.CoreSimulator.SimRuntime.iOS-26-5
Einen CI-Mac sich selbst prüfen lassen
Die Falle: xcodebuild -version funktioniert auf einem Mac mit diesem Problem ganz normal. Ein Health Check, der darauf aufbaut, besteht, und der erste Simulator-Build scheitert. Prüfen Sie stattdessen, was Sie wirklich brauchen:
Diese Prüfungen laufen jetzt, wenn ein Mac zu unserer Flotte kommt. Auf jeder MacRun-Maschine ist der erste Start von Xcode erledigt und eine iOS-Simulator-Runtime installiert. Der erste Build darauf funktioniert also einfach.
Fragen
- Warum sagt xcrun, dass es simctl nicht findet?
- Meist ist das aktive Entwicklerverzeichnis das der Command Line Tools, nicht Xcode. Die Command Line Tools enthalten keine Simulator-Werkzeuge. Richten Sie xcode-select mit sudo xcode-select -s /Applications/Xcode.app auf Xcode aus und versuchen Sie es erneut.
- Was bedeutet "simctl: No such file or directory"?
- Xcode ist ausgewählt, aber seine Pakete für den ersten Start wurden nie installiert. Diese Pakete legen CoreSimulator in /Library/Developer/PrivateFrameworks ab. Führen Sie sudo xcodebuild -runFirstLaunch aus, um sie zu installieren.
- Braucht xcodebuild -downloadPlatform iOS eine Apple-ID?
- Nein. Auf unseren Macs mit Xcode 26.6 hat es die iOS-26.5-Simulator-Runtime ohne Anmeldung heruntergeladen und installiert. Das dauerte etwa viereinhalb Minuten und belegte etwa 9 GB Speicherplatz.
- Wie prüfe ich vor einem Build, ob ein CI-Mac bereit ist?
- Führen Sie xcodebuild -checkFirstLaunchStatus aus. Es gibt 0 zurück, wenn der erste Start erledigt ist. Führen Sie dann xcrun simctl list runtimes aus und suchen Sie nach mindestens einer iOS-Zeile.
Rechnen Sie selbst nach mit dem Kostenrechner oder mieten Sie einen Runner.