← Blog

xcrun simctl not found? Die zwei Ursachen und die Lösung

25. Oktober 2026 · 5 Min. Lesezeit

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?

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.