Как обновить Xcode: подробная инструкция для macOS

Устаревшая версия Xcode часто становится причиной ошибок сборки проектов, несовместимости с новыми SDK и невозможности запустить приложение на устройстве с актуальной iOS. Проверить текущую версию среды можно прямо в терминале командой xcodebuild -version — если она отличается от той, что предлагает App Store, пора обновляться.

В этом материале разберём все рабочие способы обновления Xcode: через Mac App Store, с портала Apple Developer и через командную строку. Отдельно рассмотрим типичные проблемы — зависание загрузки, нехватку места на диске и конфликт нескольких установленных версий.

Как проверить текущую версию Xcode

Прежде чем обновляться, стоит выяснить, какая версия установлена и какая доступна. Откройте Терминал и выполните команду:

xcodebuild -version

В ответ вы получите номер версии и номер сборки, например Xcode 15.x с указанием Build version. Альтернативный способ — запустить саму среду и открыть меню Xcode → About Xcode: там отображается та же информация в графическом виде.

Также полезно проверить, какая версия Command Line Tools привязана к системе — она может отличаться от основной:

xcode-select -p

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

Способ 1: обновление через Mac App Store

Самый простой и привычный метод подходит тем, кто изначально устанавливал Xcode из магазина приложений. Откройте App Store, перейдите на вкладку «Обновления» в боковом меню и найдите Xcode в списке. Если кнопка «Обновить» отсутствует, попробуйте поискать Xcode через строку поиска — иногда обновление отображается только на странице самого приложения.

Учтите несколько особенностей этого способа:

  • 🍎 Обновление через App Store загружается целиком, а не инкрементально, поэтому потребуется стабильное интернет-соединение.
  • ⏳ Процесс может занять продолжительное время — размер дистрибутива Xcode измеряется гигабайтами.
  • 🔄 Если обновление «зависло», попробуйте приостановить и возобновить загрузку или перезапустить App Store.
  • 👤 Для загрузки потребуется авторизация под Apple ID, с которым приложение устанавливалось изначально.
⚠️ Внимание: во время обновления через App Store не закрывайте крышку MacBook и не переводите систему в сон — прерванная загрузка может привести к повреждению пакета, и установку придётся начинать заново.

Способ 2: загрузка с портала Apple Developer

Разработчики часто предпочитают ручную установку, потому что она даёт больше контроля. На портале Apple Developer в разделе загрузок доступны как стабильные релизы, так и бета-версии Xcode, которых в App Store нет. Для доступа к разделу нужен Apple ID; для некоторых загрузок — учётная запись разработчика.

Дистрибутив распространяется в формате .xip — это подписанный архив, который система распаковывает автоматически. После распаковки переместите Xcode.app в папку «Программы». Преимущество метода в том, что файл можно скачать через менеджер загрузок с возможностью докачки, а также хранить локально для установки на несколько машин.

Ручной способ также позволяет держать на диске несколько версий Xcode одновременно — например, стабильную и бета-версию. Для этого переименуйте приложения, например в Xcode-15.app и Xcode-beta.app, и переключайтесь между ними через xcode-select.

📊 Какой способ обновления Xcode вы используете чаще всего?
Mac App Store
Сайт Apple Developer
Командная строка
Держу несколько версий

Способ 3: обновление Command Line Tools через терминал

Если вам нужны только инструменты командной строки — компиляторы, git, clang — без полной среды разработки, достаточно обновить Command Line Tools. Это делается одной командой:

xcode-select --install

Если инструменты уже установлены, система сообщит об этом, а обновления будут приходить через стандартный механизм обновления macOS: Системные настройки → Основные → Обновление ПО. В некоторых версиях macOS обновления инструментов разработчика отображаются отдельной строкой в списке доступных апдейтов.

После установки новой версии полного Xcode обязательно переключите активную директорию инструментов:

sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

Затем примите лицензионное соглашение — без этого сборка проектов из терминала будет падать с ошибкой:

sudo xcodebuild -license accept

☑️ Чек-лист после обновления Xcode

Выполнено: 0 / 5

Сравнение способов обновления

Чтобы выбрать подходящий метод, ориентируйтесь на свои задачи. Ниже — сводная таблица по основным вариантам.

СпособСкорость и удобствоДоступ к бета-версиямНесколько версий
Mac App StoreПросто, но загрузка без докачкиНетНет
Apple Developer (.xip)Требует ручной установкиДаДа
Терминал (CLT)Быстро, только инструментыНетНе применимо
Обновление ПО macOSАвтоматически, в фонеНетНет

Типичные проблемы при обновлении и их решение

Обновление Xcode редко проходит идеально гладко — вот ситуации, с которыми сталкиваются чаще всего. Уточним: точное поведение зависит от версии macOS, поэтому приведённые шаги стоит рассматривать как общую диагностику.

  • 💾 Недостаточно места на диске. Для распаковки и установки требуется заметно больше свободного пространства, чем занимает само приложение. Освободите место: удалите старые симуляторы, архивы проектов иDerivedData.
  • 🐢 Загрузка зависла или идёт очень медленно. Приостановите и возобновите скачивание, смените сеть или используйте загрузку .xip через браузер вместо App Store.
  • 🔑 Ошибка лицензии при сборке. Выполните sudo xcodebuild -license accept и повторите попытку.
  • 🧩 Конфликт версий. Проверьте путь через xcode-select -p и при необходимости переключите активную версию вручную.
⚠️ Внимание: перед удалением старой версии Xcode убедитесь, что новая корректно собирает ваши рабочие проекты. Откат на предыдущую версию возможен только при наличии сохранённого установщика.
Как освободить место перед обновлением

Удалите неиспользуемые симуляторы: open /Library/Developer/CoreSimulator — но лучше через Xcode → Settings → Platforms. Очистите папку DerivedData: ~/Library/Developer/Xcode/DerivedData. Удалите старые архивы в Organizer, если они не нужны для отладки.

Откат на предыдущую версию

Иногда новая версия ломает совместимость с проектом или сторонними инструментами — тогда нужен откат. Если вы обновлялись через App Store и не сохранили старый установщик, скачайте нужную версию в формате .xip с портала Apple Developer: там доступен архив предыдущих релизов.

Порядок действий простой: удалите текущий Xcode.app из папки «Программы», распакуйте архив с нужной версией, переместите приложение на место и переключите xcode-select на него. После этого заново примите лицензию и проверьте сборку проекта.

Часто задаваемые вопросы

Можно ли обновить Xcode без учётной записи Apple Developer?

Да. Обновление через Mac App Store не требует платной учётной записи разработчика — достаточно обычного Apple ID. Загрузка стабильных версий с портала Apple Developer также доступна с бесплатным аккаунтом.

Почему Xcode не обновляется через App Store?

Возможные причины: нехватка свободного места, сбой загрузки, авторизация под другим Apple ID или устаревшая версия macOS, не поддерживающая новый Xcode. Проверьте системные требования на странице приложения и попробуйте ручную установку через .xip.

Нужно ли обновлять macOS для новой версии Xcode?

Как правило, свежие версии Xcode требуют относительно актуальную версию macOS. Точные системные требования указаны в примечаниях к релизу конкретной версии — сверьтесь с ними перед обновлением.

Как удалить старую версию Xcode полностью?

Переместите Xcode.app в корзину. Дополнительно можно очистить вспомогательные данные в ~/Library/Developer, но делайте это осознанно: там хранятся симуляторы, архивы и DerivedData, которые могут понадобиться.

Что делать, если после обновления проект не собирается?

Сначала очистите сборочную папку через Product → Clean Build Folder, затем проверьте активную версию инструментов командой xcode-select -p. Если проблема сохраняется, изучите примечания к релизу — возможно, изменились требования к версии Swift или настройкам проекта.