xcrun simctl not found? Две причины и как их исправить
Вы вводите xcrun simctl list и вместо симуляторов получаете ошибку. У неё две разные причины, и исправляются они по-разному. Текст ошибки подскажет, какая у вас.
Мы столкнулись со второй на целой стойке новых Mac mini. Xcode был установлен, и xcodebuild -version работал. Но любая сборка под симулятор iOS всё равно упала бы. Ниже о том, что значит каждая ошибка, и точные команды, которые её исправили.
Какая у вас ошибка?
| Вы видите | Это значит | Проверить командой | Исправление |
|---|---|---|---|
| xcrun: unable to find utility "simctl" | Выбраны Command Line Tools, а не Xcode | 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 ставит несколько системных пакетов. Один из них CoreSimulator, он лежит в /Library/Developer/PrivateFrameworks. simctl внутри Xcode это небольшой скрипт, который передаёт работу этому фреймворку. Если Xcode установили, но ни разу не открыли, фреймворка нет.
Это обычное дело на CI-машинах и Mac без монитора. На них никто не открывает Xcode. Инструменты, которые ставят Xcode за вас, например xcodes, копируют приложение, но не выполняют первый запуск. Проверить это можно так:
xcodebuild -checkFirstLaunchStatus; echo $? # 69 means first launch has not run. 0 means it has.
Исправляется двумя командами:
# 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
На наших M6 mini с Xcode 26.6 первая команда заняла 8 секунд. Вторая скачала среду iOS 26.5 примерно за четыре с половиной минуты и заняла около 9 GB на диске. Apple ID ей не понадобился. Потом:
xcrun simctl list runtimes == Runtimes == iOS 26.5 (26.5 - 23F77) - com.apple.CoreSimulator.SimRuntime.iOS-26-5
Пусть CI-Mac проверяет себя сам
Ловушка в том, что xcodebuild -version отлично работает на Mac с этой проблемой. Проверка здоровья на его основе проходит, а первая сборка под симулятор падает. Вместо этого проверяйте то, что вам на самом деле нужно:
Теперь мы запускаем эти проверки, когда Mac добавляется в наш парк. Каждая машина MacRun приходит с выполненным первым запуском Xcode и установленной средой симулятора iOS. Поэтому первая сборка на ней просто работает.
Вопросы
- Почему xcrun не может найти simctl?
- Обычно потому, что активная папка разработчика указывает на Command Line Tools, а не на Xcode. В Command Line Tools нет инструментов симулятора. Направьте xcode-select на Xcode командой sudo xcode-select -s /Applications/Xcode.app и попробуйте снова.
- Что означает "simctl: No such file or directory"?
- Xcode выбран, но пакеты первого запуска так и не установились. Эти пакеты кладут CoreSimulator в /Library/Developer/PrivateFrameworks. Чтобы их установить, выполните sudo xcodebuild -runFirstLaunch.
- Нужен ли Apple ID для xcodebuild -downloadPlatform iOS?
- Нет. На наших Mac с Xcode 26.6 команда скачала и установила среду выполнения симулятора iOS 26.5 без входа в аккаунт. Это заняло около четырёх с половиной минут и примерно 9 GB на диске.
- Как проверить, что CI-Mac готов к сборке?
- Выполните xcodebuild -checkFirstLaunchStatus. Команда возвращает 0, когда первый запуск выполнен. Затем выполните xcrun simctl list runtimes и найдите хотя бы одну строку с iOS.
Посчитайте свои цифры в калькуляторе или арендуйте раннер.