Установка Xcode на Mac упирается в два системных требования: совместимую версию macOS и достаточный объём свободного места на диске — при нехватке хотя бы одного из условий App Store откажется загружать среду разработки или зависнет на этапе распаковки. Прежде чем нажимать кнопку «Загрузить», стоит проверить версию операционной системы через → Об этом Mac и убедиться, что на накопителе есть заметный запас свободного пространства с учётом будущих симуляторов и производных данных.
Xcode — официальная интегрированная среда разработки Apple для создания приложений под iOS, iPadOS, macOS, watchOS и tvOS. Без неё невозможна ни сборка проекта на Swift, ни подпись приложения, ни публикация в App Store. В этом материале разберём установку, первичную настройку, работу с симулятором и типичные проблемы, с которыми сталкиваются разработчики на Mac.
Способы установки Xcode на macOS
Самый простой путь — установка через Mac App Store. Откройте магазин приложений, найдите Xcode в поиске и нажмите «Загрузить». Пакет весит много гигабайт, поэтому загрузка и последующая «распаковка» могут занять продолжительное время даже на быстром соединении — это нормальное поведение, а не зависание.
Альтернативный вариант — ручная загрузка архива .xip с портала для разработчиков Apple. Этот способ полезен, когда нужна конкретная версия среды, отличная от актуальной в App Store, или когда требуется держать на одном Mac несколько версий Xcode одновременно. Для скачивания потребуется учётная запись Apple ID, привязанная к программе разработчиков — бесплатной или платной.
- 🍎 Mac App Store — автоматические обновления, минимум ручных действий;
- 📦 Портал разработчика Apple — доступ к beta-версиям и старым релизам;
- 🔀 Несколько версий рядом — переименуйте приложение, например в
Xcode-15.xipперед распаковкой, чтобы сборки не перезаписывали друг друга; - 🛠 Command Line Tools — отдельный облегчённый пакет для тех, кому нужны только компиляторы и git без полной IDE.
Первый запуск и базовая настройка
При первом открытии Xcode предложит установить дополнительные компоненты и принять лицензионное соглашение. Без этого шага среда не запустится, а сборка из терминала будет выдавать ошибку лицензии. Если вы работаете через командную строку, принять соглашение можно так:
sudo xcodebuild -license acceptДалее необходимо указать системе активную версию инструментов разработчика, особенно если на Mac установлено несколько копий Xcode. Это делается командой sudo xcode-select -s с путём к нужному приложению. Проверить текущий выбор поможет xcode-select -p.
☑️ Первичная настройка Xcode
После этого откройте настройки среды через Xcode → Settings и добавьте свой Apple ID на вкладке Accounts. Это необходимо для автоматического управления сертификатами подписи и профилями обеспечения — без учётной записи запуск приложения на реальном устройстве будет недоступен.
Системные требования и свободное место
Каждая новая версия Xcode требует определённую минимальную версию macOS, и это требование со временем повышается. Если ваш Mac не обновлялся давно, App Store может предложить вместо свежей версии последнюю совместимую — это нормальный механизм, позволяющий работать на старом оборудовании.
Отдельная боль разработчиков — дисковое пространство. Сама среда, симуляторы, кэши сборки и папка DerivedData суммарно могут занимать десятки гигабайт. Каталог ~/Library/Developer/Xcode/DerivedData безопасно очищается вручную — Xcode пересоздаст его содержимое при следующей сборке, а освобождённое место нередко исчисляется десятками гигабайт.
| Компонент | Где находится | Можно ли очищать |
|---|---|---|
| DerivedData | ~/Library/Developer/Xcode/DerivedData | Да, полностью |
| Архивы сборок | ~/Library/Developer/Xcode/Archives | Только старые, если не нужны для отладки |
| Симуляторы iOS | ~/Library/Developer/CoreSimulator | Неиспользуемые версии — да |
| Кэши модулей | ~/Library/Developer/Xcode/DerivedData/ModuleCache | Да, пересоздаются автоматически |
Работа с симулятором iOS
Симулятор позволяет тестировать приложения на виртуальных моделях iPhone и iPad без физических устройств. Загрузка образов выполняется через Xcode → Settings → Platforms (в старых версиях — вкладка Components) либо автоматически при первом запуске проекта под нужную платформу.
Если симулятор не запускается, зависает на чёрном экране или выдаёт ошибку, начните с безопасных шагов: перезапустите сам симулятор, затем Xcode, а при повторении проблемы — весь Mac. Более радикальный вариант — сброс устройства через меню симулятора Device → Erase All Content and Settings, который удаляет все данные виртуального аппарата, но не трогает проекты.
⚠️ Внимание: команда xcrun simctl erase all удаляет данные всех симуляторов сразу, включая установленные тестовые приложения и их настройки. Перед выполнением убедитесь, что в виртуальных устройствах нет нужных данных.
Типичные ошибки и их решение
Одна из самых частых жалоб — ошибка подписи кода вида «Signing requires a development team». Она означает, что в настройках таргета проекта не выбрана команда разработчика. Откройте настройки проекта, перейдите на вкладку Signing & Capabilities и выберите свою команду в выпадающем списке Team — для личных проектов достаточно бесплатной учётной записи Apple ID.
Вторая распространённая ситуация — бесконечная индексация проекта или подвисание автодополнения. Возможная причина — повреждённый кэш: помогает очистка DerivedData и перезапуск среды. Если проблема сохраняется, проверьте, не открыт ли проект одновременно в двух копиях Xcode разных версий.
Ошибка «Command PhaseScriptExecution failed»
Чаще всего она связана со скриптами сборки — например, с устаревшими путями к CocoaPods или SwiftLint. Откройте лог сборки (иконка в виде списка в навигаторе отчётов), найдите строку с конкретной ошибкой скрипта и проверьте, что все внешние инструменты установлены и доступны по указанным путям. После обновления зависимостей через pod install или pod repo update ошибка обычно уходит.
Если Xcode не видит подключённый iPhone, проверьте по порядку: кабель (некоторые кабели передают только питание), доверие компьютеру на устройстве (диалог «Доверять этому компьютеру») и версию Xcode — старая среда может не поддерживать новую версию iOS на устройстве.
⚠️ Внимание: не удаляйте содержимое папки ~/Library/Developer целиком — там, помимо очищаемых кэшей, хранятся профили обеспечения, ключи и архивы. Удаляйте только конкретные подкаталоги, назначение которых вам понятно.
Обновление и удаление Xcode
При установке через App Store обновления приходят автоматически или по запросу из раздела «Обновления». Учтите, что мажорные обновления могут менять версию компилятора Swift, и старый проект иногда требует миграции кода — среда предложит конвертер при первом открытии.
Для полного удаления Xcode недостаточно перетащить приложение в корзину: останутся симуляторы, кэши и инструменты в ~/Library/Developer. Если цель — освободить максимум места, удалите приложение, а затем вручную очистите упомянутые каталоги, предварительно убедившись, что архивы и профили вам больше не нужны.
Часто задаваемые вопросы
Можно ли разрабатывать под iOS без Xcode?
Полноценно — нет. Сторонние редакторы вроде VS Code подходят для написания кода, но сборка, подпись и публикация приложения требуют инструментов Xcode. Минимальная альтернатива — Command Line Tools, но они не включают симулятор и Interface Builder.
Почему Xcode так долго устанавливается из App Store?
Дистрибутив имеет большой размер, а после загрузки система выполняет проверку и распаковку пакета, которая может выглядеть как зависание. Дайте процессу завершиться; если прогресс не меняется очень долго, попробуйте установку через .xip-архив с портала разработчика.
Нужен ли платный аккаунт разработчика Apple?
Для обучения, разработки и запуска приложений на собственном устройстве достаточно бесплатного Apple ID. Платная программа Apple Developer Program нужна для публикации в App Store и распространения сборок через TestFlight.
Xcode не видит iPhone после обновления iOS — что делать?
Вероятная причина — установленная версия Xcode не поддерживает новую версию iOS на устройстве. Обновите Xcode до актуальной версии, совместимой с вашей macOS, и переподключите устройство, подтвердив доверие компьютеру.
Как освободить место, занимаемое Xcode, без потери проектов?
Проекты хранятся отдельно и не пострадают. Очистите папку DerivedData, удалите неиспользуемые симуляторы и старые архивы сборок — эти данные либо пересоздаются автоматически, либо не нужны для текущей работы.