← блог

xcrun simctl not found? Две причины и как их исправить

25 октября 2026 г. · 5 мин чтения

Вы вводите xcrun simctl list и вместо симуляторов получаете ошибку. У неё две разные причины, и исправляются они по-разному. Текст ошибки подскажет, какая у вас.

Мы столкнулись со второй на целой стойке новых Mac mini. Xcode был установлен, и xcodebuild -version работал. Но любая сборка под симулятор iOS всё равно упала бы. Ниже о том, что значит каждая ошибка, и точные команды, которые её исправили.

Какая у вас ошибка?

Причина 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.

Посчитайте свои цифры в калькуляторе или арендуйте раннер.