xcrun simctl introuvable ? Les deux causes et la solution
Vous tapez xcrun simctl list et vous obtenez une erreur au lieu des simulateurs. Deux problèmes différents en sont la cause, et ils demandent des corrections différentes. Le texte de l’erreur vous dit lequel vous avez.
Nous sommes tombés sur le second sur tout un rack de Mac mini neufs. Xcode était installé et xcodebuild -version marchait. Pourtant, chaque build sur simulateur iOS aurait échoué. Voici ce que signifie chaque erreur, et les commandes exactes qui l’ont corrigée.
Quelle erreur avez-vous ?
| Vous voyez | Cela signifie | Pour confirmer | Correction |
|---|---|---|---|
| xcrun: unable to find utility "simctl" | Les Command Line Tools sont sélectionnés, pas Xcode | xcode-select -p | sudo xcode-select -s /Applications/Xcode.app |
| simctl: No such file or directory | Le premier lancement de Xcode n’a jamais eu lieu | xcodebuild -checkFirstLaunchStatus | sudo xcodebuild -runFirstLaunch |
Cause 1 : les Command Line Tools sont sélectionnés
Voici le message :
xcrun: error: unable to find utility "simctl", not a developer tool or in PATH
Les Command Line Tools fournissent les compilateurs et git, mais aucun simulateur. S’ils sont le répertoire développeur actif, xcrun cherche là et ne trouve pas simctl. Vérifiez lequel est actif :
xcode-select -p # /Library/Developer/CommandLineTools (the problem) # /Applications/Xcode.app/Contents/Developer (what you want)
Pointez-le vers Xcode. Utilisez le vrai chemin si le nom de votre Xcode contient une version.
sudo xcode-select -s /Applications/Xcode.app xcrun simctl list runtimes
Cause 2 : le premier lancement de Xcode n’a jamais eu lieu
Celle-ci est plus étrange. Xcode est sélectionné, et c’est simctl lui-même qui échoue :
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
Quand vous ouvrez Xcode pour la première fois, il installe quelques paquets système. L’un d’eux est CoreSimulator, dans /Library/Developer/PrivateFrameworks. Le simctl de Xcode est un petit script qui passe la main à ce framework. Si Xcode a été installé mais jamais ouvert, le framework n’est pas là.
C’est courant sur les machines de CI et les Mac sans écran. Personne n’y ouvre Xcode. Les outils qui installent Xcode pour vous, comme xcodes, copient l’app mais ne lancent pas son premier lancement. Vous pouvez le vérifier :
xcodebuild -checkFirstLaunchStatus; echo $? # 69 means first launch has not run. 0 means it has.
La correction tient en deux commandes :
# 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
Sur nos Mac mini M6 avec Xcode 26.6, la première commande a pris 8 secondes. La seconde a téléchargé le runtime iOS 26.5 en environ quatre minutes et demie, et occupé environ 9 Go de disque. Elle n’a demandé aucun identifiant Apple. Ensuite :
xcrun simctl list runtimes == Runtimes == iOS 26.5 (26.5 - 23F77) - com.apple.CoreSimulator.SimRuntime.iOS-26-5
Faire vérifier un Mac de CI par lui-même
Le piège : xcodebuild -version fonctionne très bien sur un Mac qui a ce problème. Un contrôle de santé fondé sur cette commande passe, et le premier build sur simulateur échoue. Vérifiez plutôt ce dont vous avez vraiment besoin :
Nous lançons désormais ces vérifications quand un Mac rejoint notre parc. Chaque machine MacRun arrive avec le premier lancement de Xcode fait et un runtime de simulateur iOS installé. Le premier build marche donc du premier coup.
Questions
- Pourquoi xcrun dit-il qu’il ne trouve pas simctl ?
- En général, parce que le répertoire développeur actif est celui des Command Line Tools, pas Xcode. Les Command Line Tools n’ont aucun outil de simulateur. Pointez xcode-select vers Xcode avec sudo xcode-select -s /Applications/Xcode.app et réessayez.
- Que signifie "simctl: No such file or directory" ?
- Xcode est sélectionné, mais ses paquets de premier lancement n’ont jamais été installés. Ces paquets placent CoreSimulator dans /Library/Developer/PrivateFrameworks. Lancez sudo xcodebuild -runFirstLaunch pour les installer.
- xcodebuild -downloadPlatform iOS demande-t-il un identifiant Apple ?
- Non. Sur nos Mac avec Xcode 26.6, il a téléchargé et installé le runtime du simulateur iOS 26.5 sans connexion. Cela a pris environ quatre minutes et demie et occupé environ 9 Go de disque.
- Comment vérifier qu’un Mac de CI est prêt avant un build ?
- Lancez xcodebuild -checkFirstLaunchStatus, qui renvoie 0 quand le premier lancement est fait. Lancez ensuite xcrun simctl list runtimes et cherchez au moins une ligne iOS.
Faites vos propres calculs avec le calculateur ou louez un runner.