Ошибка установки Xcode 27: чек-лист для удалённого Mac

Симптом: Xcode 27 не устанавливается, не запускается, не видит симулятор или xcodebuild продолжает работать со старой версией.

Быстрый путь: не переустанавливайте Xcode вслепую — сначала проверьте Apple silicon и версию macOS, затем пакет установки, активный каталог разработчика и платформенные компоненты. Если аппаратная или системная совместимость не выполняется, переносите среду на совместимый Apple silicon Mac; если базовые условия выполнены, проблему обычно следует искать в конфигурации инструментов и незавершённых компонентах.

Кому пригодится этот материал

Он предназначен для независимых разработчиков, которые используют Intel Mac или старую версию macOS и после перехода на Xcode 27 не могут установить или запустить IDE. Также инструкция полезна тем, кто поддерживает удалённый Mac через SSH, VNC или автоматические сценарии.

Если вам нужно параллельно сохранять стабильную версию Xcode и тестовую beta-версию, рассматривайте эту статью как процедуру приёмки среды, а не как обычное руководство по установке.

Важно: по состоянию на 12 августа 2026 года Xcode 27 находится на стадии beta. Перед каждым обновлением сверяйте официальные требования и release notes: последующая beta, RC или финальный выпуск может изменить совместимость и поведение компонентов.

Ошибка установки Xcode 27: сначала определите слой сбоя

Ошибка установки Xcode 27 — это не один сценарий. Одинаковое сообщение «Xcode не работает» может означать несовместимый Intel Mac, неполный архив, неправильный путь DEVELOPER_DIR, отсутствие iOS Simulator Runtime или ошибку непосредственно в проекте.

Разделите проблему на шесть уровней:

1. загрузка или распаковка приложения не завершилась;
2. приложение установлено, но macOS не позволяет его запустить;
3. Xcode открывается, однако терминал вызывает другую версию;
4. отсутствует поддержка нужной платформы или runtime симулятора;
5. минимальная сборка проходит, но ваш проект не собирается;
6. удалённый сеанс, пользователь или автоматический скрипт используют другую среду.

Зафиксируйте до исправлений:

• полный текст ошибки;
• способ воспроизведения: Finder, команда в Terminal, SSH, CI-сценарий или VNC;
• фактический путь к приложению;
• вывод uname -m;
• вывод sw_vers;
• результат xcode-select -p;
• версию, которую возвращают xcodebuild -version и xcrun --find xcodebuild.

Эта запись предотвращает типичную ошибку: удаление Xcode из-за сбоя CocoaPods, Swift Package Manager или настроек проекта, хотя сама среда разработки установлена корректно.

Шаг 1. Проверьте аппаратную и системную совместимость

Наиболее важный фильтр нужно выполнить до повторной загрузки большого установочного файла. Apple прямо указывает, что Xcode 27 beta устанавливается и запускается только на Mac с Apple silicon. В release notes также указано требование macOS Tahoe 26.4 или более новой версии. На странице системных требований для Xcode 27 beta 4 сейчас указано то же минимальное системное условие. (developer.apple.com)

Проверьте устройство:

uname -m
system_profiler SPHardwareDataType | grep -E "Chip|Processor"
sw_vers

Интерпретация результата:

• arm64 означает, что Mac использует Apple silicon;
• x86_64 означает Intel Mac, на котором Xcode 27 beta запускаться не будет;
• значение ProductVersion ниже 26.4 не соответствует опубликованному требованию для текущей beta;
• подключение по VNC или SSH не меняет физическую архитектуру удалённого Mac.

Почему Xcode 27 нельзя установить на Intel Mac?
Причина не в качестве удалённого подключения и не в выбранной версии Rosetta. Apple заявила ограничение на установку и запуск Xcode 27 beta на Apple silicon. При этом macOS SDK остаётся универсальным для обратной поддержки, поэтому старые Intel-среды могут оставаться полезными для отдельных проектов, но они не становятся совместимыми с самим Xcode 27. (developer.apple.com)

Если результат x86_64, не тратьте время на смену xcode-select, очистку DerivedData или повторную распаковку. Ваши варианты:

• оставить стабильную версию Xcode на Intel Mac, если текущий проект ещё собирается;
• перенести только Xcode 27 и связанные задачи на совместимый Apple silicon Mac;
• организовать двухконтурную среду: стабильный инструмент для публикации и отдельный контур для проверки новых SDK;
• перейти на удалённый Mac, если покупка отдельного устройства ради beta-ветки не оправдана.

Шаг 2. Отделите повреждённую загрузку от ошибки установки

Если архитектура и macOS подходят, проверьте, где именно остановился процесс. Не удаляйте сразу все версии из /Applications: сначала определите состояние приложения.

ls -ld /Applications/Xcode*.app
find /Applications/Xcode*.app -maxdepth 2 -name Info.plist -print
mdfind "kMDItemCFBundleIdentifier == 'com.apple.dt.Xcode'"

Признаки неполного или повреждённого пакета:

• приложение отсутствует в /Applications, хотя загрузка показывала завершение;
• каталог существует, но внутри нет ожидаемого Contents/Developer;
• Finder показывает приложение, а запуск завершается немедленно;
• имя содержит несколько суффиксов вроде Xcode 27 beta 2, и скрипт обращается не к тому пути;
• удалённая сессия оборвалась во время распаковки, после чего процесс не продолжился.

Используйте только официальный канал загрузки Xcode. Apple указывает, что Xcode доступен через Mac App Store, а beta-версии распространяются через сайт Apple Developer. (developer.apple.com)

На удалённом Mac проверьте не только свободное место, но и место назначения, права текущего пользователя и наличие незавершённых процессов:

df -h /
ps aux | grep -i "[x]code"
ls -ld /Applications
id

Не ориентируйтесь на одно уведомление графической сессии. После разрыва VNC или браузерного подключения загрузка могла завершиться, остановиться или продолжиться в фоне. Подтвердите результат через наличие приложения, размер каталога, журнал установки и фактический запуск.

Также проверьте, не запущена ли установка под одним пользователем, а дальнейшая работа — под другим. В таком случае приложение может быть доступно в Finder, но автоматический пользователь не сможет записать компоненты, кэш или данные симулятора.

Шаг 3. Настройте активный каталог разработчика

Открывающийся Xcode не доказывает, что командная строка использует тот же экземпляр. На Mac могут одновременно находиться стабильная версия, beta-версия и копия с изменённым именем.

Сначала получите фактические значения:

xcode-select -p
xcodebuild -version
xcrun --find xcodebuild
xcrun --sdk iphoneos --show-sdk-path

Если активный путь указывает на старый каталог, переключите глобальную среду:

sudo xcode-select --switch /Applications/Xcode-27-beta.app
sudo xcodebuild -runFirstLaunch

Затем проверьте результат теми же командами. Команда xcodebuild -runFirstLaunch нужна не только для отображения версии: она выполняет первоначальную настройку необходимых системных компонентов, включая инструменты, используемые командной строкой. Apple документирует выбор версии через xcode-select и установку компонентов через xcodebuild. (developer.apple.com)

Для автоматической задачи лучше не менять глобальное состояние без необходимости. Одно задание можно направить на конкретную версию:

DEVELOPER_DIR=/Applications/Xcode-27-beta.app/Contents/Developer \
xcodebuild -version

Для сборочного сценария:

DEVELOPER_DIR=/Applications/Xcode-27-beta.app/Contents/Developer \
xcodebuild \
  -workspace Sample.xcworkspace \
  -scheme Sample \
  -sdk iphoneos \
  -configuration Release \
  build

Глобальный xcode-select подходит для одного основного инструмента на машине. DEVELOPER_DIR безопаснее для двухконтурной среды, где публикация должна продолжать использовать стабильную версию, а отдельная задача проверяет Xcode 27.

Почему удалённый Mac после установки Xcode 27 всё ещё вызывает старый xcodebuild?
Обычно SSH-сеанс, VNC-сеанс и автоматический агент получают разные переменные окружения или используют системный путь, сохранённый до переключения. Проверьте xcode-select -p отдельно в интерактивном терминале и внутри самого скрипта. Если значения различаются, задайте DEVELOPER_DIR непосредственно в задаче и сохраняйте абсолютный путь к приложению.

Шаг 4. Установите платформы и runtime симулятора

Установка Xcode не означает, что все платформы и симуляторы уже готовы. В настройках Xcode откройте раздел Components и проверьте Platform Support и Other Installed Platforms. Apple описывает simulator runtime как отдельный компонент, который загружается и устанавливается отдельно от приложения Xcode. Пока загрузка не завершена, проект нельзя полноценно запускать или собирать для соответствующей платформы. (developer.apple.com)

Проверьте доступные SDK и устройства:

xcodebuild -showsdks
xcrun simctl list runtimes
xcrun simctl list devices

Различайте три ситуации:

• iOS SDK отсутствует — проблема относится к platform support;
• runtime установлен, но устройства не отображаются — проверьте состояние CoreDevice и перезапустите Mac или соответствующие службы;
• симулятор есть, но проект не запускается — сравните deployment target, схему и выбранное устройство.

Для загрузки платформы из Terminal Apple предлагает использовать xcodebuild:

xcodebuild -downloadPlatform iOS -exportPath ~/Downloads

После выбора нужного Xcode установите обязательные компоненты:

sudo xcode-select --switch /Applications/Xcode-27-beta.app
sudo xcodebuild -runFirstLaunch

В beta release notes Apple отдельно отмечает проблему, из-за которой устройства Simulator могут не появляться в Device Hub из-за сбоя установочного пакета; для указанного случая предложена перезагрузка или перезапуск CoreDeviceService. Это конкретная проблема текущей beta, а не универсальное объяснение всех случаев отсутствия симулятора. (developer.apple.com)

Что делать, если Xcode 27 не видит iOS Simulator Runtime?
Сначала выполните xcrun simctl list runtimes. Если нужной версии нет в списке, установите её через Components или команду загрузки платформы. Если runtime есть, но список устройств пуст, перезапустите Mac и повторите проверку. Если устройство отображается, но схема его не предлагает, проверяйте deployment target и поддержку платформы в самом проекте.

Чек-лист удалённой среды перед первой сборкой

Не считайте удалённый Mac готовым только потому, что окно Xcode открывается через VNC. Для постоянной сборки проверяйте каждый канал отдельно:

• [ ] uname -m возвращает arm64.
• [ ] sw_vers показывает macOS Tahoe 26.4 или более новую совместимую версию.
• [ ] Путь xcode-select -p указывает на требуемый Xcode.
• [ ] xcodebuild -version возвращает ожидаемую версию.
• [ ] xcrun --find xcodebuild указывает внутрь выбранного Contents/Developer.
• [ ] xcodebuild -showsdks содержит SDK, нужный проекту.
• [ ] xcrun simctl list runtimes показывает установленный iOS runtime.
• [ ] автоматический скрипт использует тот же DEVELOPER_DIR, что и ручная проверка.
• [ ] сборка запускается после нового SSH-сеанса.
• [ ] сборка запускается после выхода из VNC.
• [ ] после перезагрузки повторная проверка не возвращает старый путь.
• [ ] каталог проекта и кэш сборки доступны пользователю, под которым работает автоматизация.
• [ ] на машине сохранена рабочая стабильная версия, если Xcode 27 используется для тестирования beta-возможностей.

Если ваша среда размещена через KVMFLUX, перед арендой или переносом проверьте на странице сценариев использования удалённого Mac, подходит ли выбранный вариант для интерактивной разработки, постоянной сборки и доступа по SSH. Это не заменяет техническую приёмку, но помогает не путать среду для разового запуска с машиной для непрерывного процесса.

Минимальная сборка решает: исправлять, откатывать или переносить

После устранения очевидных проблем не переходите сразу к большому рабочему проекту. Создайте минимальное приложение без сторонних зависимостей и пройдите четыре проверки:

xcodebuild -version
xcrun simctl list devices
xcodebuild -project Sample.xcodeproj \
  -scheme Sample \
  -sdk iphonesimulator \
  -destination 'platform=iOS Simulator,name=iPhone' \
  build

Затем проверьте сборку для устройства:

xcodebuild -project Sample.xcodeproj \
  -scheme Sample \
  -sdk iphoneos \
  -configuration Release \
  build

Если Xcode не запускается уже на первом шаге, проблема находится в совместимости, установке или системных компонентах. Если терминальная версия отличается от графической, исправляйте путь инструментов. Если сборка для Simulator не проходит из-за отсутствующего runtime, не меняйте проект — сначала завершите установку платформы.

Если минимальный проект собирается, а рабочий проект нет, переходите к зависимостям, настройкам signing, скриптам и deployment target. Apple отдельно отмечает, что Simulator не воспроизводит все характеристики физического устройства, поэтому финальную проверку поведения приложения нельзя полностью заменить симуляцией. (developer.apple.com)

Примите решение по условиям:

• Исправляйте текущую среду, если Mac — Apple silicon, macOS соответствует требованию, Xcode запускается, а ошибка связана с путём, компонентом или окружением.
• Откатывайтесь, если beta ломает действующий релизный процесс, но стабильная версия продолжает собирать и подписывать приложение.
• Сохраняйте две версии, если вам нужно тестировать новый SDK, не рискуя публикацией.
• Переносите среду, если Mac использует Intel, система не обновляется до требуемой версии или удалённая машина не позволяет стабильно поддерживать SSH, VNC и автоматические задания.

Когда текущая машина уже не лучший вариант

Если причина — только неверно выбранный Xcode, локальная переустановка не нужна. Но Intel Mac или устаревшая система не станут совместимыми после смены пути инструментов. Самостоятельное обновление оборудования также имеет скрытые издержки: первоначальная покупка, ожидание доставки, обслуживание, занятое место и необходимость держать отдельную машину включённой для автоматических сборок.

Удалённый Mac может быть разумнее для временной beta-проверки, миграции проекта или небольшого командного контура, однако он не решает задачу без проверки архитектуры, версии macOS, прав пользователя, сетевого доступа и сохранения состояния после перезагрузки. Если вам нужна временная среда, сначала сверяйте технические условия, а затем выбирайте срок аренды через доступные варианты KVMFLUX. Для постоянной тяжёлой нагрузки и сценариев, требующих физических устройств или локальных интерфейсов, собственный Mac может оказаться предсказуемее.

Главный критерий здесь не сам факт запуска Xcode 27, а повторяемость: после нового SSH-сеанса, выхода из VNC, перезагрузки и запуска автоматической задачи должны использоваться тот же Xcode, SDK и simulator runtime. Если текущая среда не проходит эту проверку, перенос на совместимый удалённый Mac с последующей минимальной сборкой обычно надёжнее, чем бесконечная переустановка одного и того же пакета.