Как установить Xcode и создать первый Swift-проект

Чтобы писать Swift для Apple-платформ, нужен Xcode. Он включает редактор, компилятор, SwiftUI Preview, Simulator, debugging tools и шаблоны проектов. В этом уроке мы установим Xcode, создадим первый проект и проверим, что Swift-код запускается без борьбы с настройками

Цель простая: получить рабочую среду, а не изучить весь Xcode сразу. Важно отличать ошибку Swift-кода от ошибки установки, SDK, Simulator или выбранного шаблона

Что получится в конце

Вы создадите проект iOS App, найдете файл с Swift-кодом, запустите приложение в Simulator и увидите стартовый экран

Дополнительно можно проверить Swift в терминале:

swift --version

Если команда показывает версию, а Xcode запускает проект, среда готова для следующих уроков

Где скачивать Xcode

Безопасные варианты:

• Mac App Store
• официальный Apple Developer

Не скачивайте Xcode из случайных архивов и зеркал. Это большой инструмент с доступом к SDK, сборке и подписи приложений, поэтому источник важен

Установка может занимать много времени и места. Это нормально: Xcode содержит не только редактор, но и SDK, Simulator, инструменты сборки, документацию и отладку

Первый запуск Xcode

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

Если Xcode просит принять license или установить platform components, не пропускайте это. Иначе проект может создаться, но сборка или Simulator сломаются позже

Иногда помогает команда:

sudo xcodebuild -license

Но новичку чаще достаточно открыть Xcode и пройти его первичную настройку

Создаем первый проект

В Xcode:

1. iOS -> App
2. Создать проект в понятной папке

После создания дождитесь индексации. Xcode может некоторое время анализировать проект и готовить Preview. Не меняйте сразу все настройки, пока среда завершает первый запуск

Где находится Swift-код

В новом SwiftUI-проекте обычно есть файл ContentView.swift. В нем будет структура, похожая на:

import SwiftUI

struct ContentView: View {
    var body: some View {
        VStack {
            Image(systemName: "globe")
            Text("Hello, world!")
        }
        .padding()
    }
}

Это уже Swift-код, но он связан со SwiftUI. Если вы еще не знаете struct, View, some View, не страшно. Для первого запуска достаточно поменять строку:

Text("Hello, Swift")

и увидеть изменение в Preview или Simulator

Simulator: зачем он нужен

Simulator позволяет запускать приложение на виртуальном iPhone или iPad без физического устройства. Это стандартный путь для первых уроков

Выберите устройство в верхней панели Xcode и нажмите Run. Первый запуск может быть медленным: Xcode собирает проект, запускает Simulator и устанавливает приложение

Проверка:

• Simulator открылся
• приложение установилось
• стартовый экран виден
• в Xcode нет красной ошибки сборки

Если это выполнено, проект работает

Command Line Tools

Для части задач Swift можно использовать из терминала. Проверка:

xcode-select -p
swift --version

Если command line tools не настроены, Xcode или терминал могут предложить установить их. Для iOS-разработки все равно держите фокус на Xcode, но терминальная проверка помогает понять, видит ли система инструменты

Не путайте Command Line Tools с Xcode целиком. Для приложений Apple-платформ нужен Xcode, Simulator и SDK. Для простых Swift-скриптов может хватить меньшего набора, но рубрика ведет к SwiftUI и iOS

Домашка: проверить три точки

Сделайте три проверки:

1. swift --version в терминале
2. Запуск в Simulator или Preview

Запишите, где именно появилась ошибка, если она появилась. Это помогает не смешивать проблемы: терминал, Xcode, Preview и Simulator — разные слои

Частые ошибки и порядок проверки

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

Simulator не запускается Проверьте выбранное устройство и доступные runtimes. Иногда нужно скачать дополнительный Simulator runtime в настройках Xcode

Preview не обновляется Сначала соберите проект. Если сборка красная, Preview тоже не обязан работать

No developer tools were found Проверьте xcode-select -p и откройте Xcode хотя бы один раз после установки

Что именно устанавливает Xcode

Xcode — это не только редактор. Вместе с ним вы получаете SDK для Apple-платформ, Swift compiler, Interface Builder, SwiftUI Preview, инструменты отладки, профилирования, симуляторы и шаблоны приложений. Поэтому размер установки большой, а первый запуск может занять время

Практически это означает две вещи. Во-первых, не стоит удалять Xcode сразу после первого тяжелого запуска: часть компонентов может докачиваться и индексироваться. Во-вторых, если у вас мало места на диске, установка может сорваться не на этапе скачивания, а при распаковке или добавлении simulator runtime

Мини-чек перед установкой:

• свободное место с запасом
• актуальная версия macOS для выбранного Xcode
• стабильная сеть
• доступ к App Store или официальной странице Apple Developer

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

Проверка окружения после установки

Откройте Terminal и выполните:

xcodebuild -version

Пример вывода:

Xcode 16.x
Build version ...

Затем проверьте Swift:

swift --version

Если команда не находится, проверьте, выбран ли активный Xcode:

xcode-select -p

Обычно путь выглядит примерно так:

/Applications/Xcode.app/Contents/Developer

Если на Mac несколько версий Xcode, активная может быть не той, которую вы только что поставили. В таком случае лучше не гадать по иконке в Dock, а смотреть xcode-select -p

Как понять, что проект создан правильно

В первом проекте не нужно менять все файлы. Проверьте четыре точки:

1. В шаблоне выбран iOS App
2. Interface установлен в SwiftUI
3. Language установлен в Swift
4. В списке устройств выбран Simulator, например iPhone

После запуска в Simulator должен появиться экран приложения. Если вы поменяли Text("Hello, world!") на Text("Hello, Swift"), именно эта строка должна отобразиться на экране

Если экран не меняется, проверьте, что вы редактируете ContentView.swift в активном target, а не случайный файл из старого проекта. В Xcode это распространенная ошибка: открыто несколько окон, а правится не тот файл

Что делать, если Simulator не запускается

Сначала отделите проблему кода от проблемы окружения. Верните ContentView.swift к максимально простому виду:

import SwiftUI

struct ContentView: View {
    var body: some View {
        Text("Hello, Swift")
    }
}

Если такой экран не запускается, дело почти наверняка не в вашем Swift-коде. Проверьте выбранное устройство, установленный simulator runtime, доступное место на диске и сообщения Xcode в верхней панели

Если Simulator запускается, но build падает, откройте Issue Navigator. Читайте первую ошибку сверху, а не весь список сразу. Xcode может показать много следствий от одной первичной проблемы

Небольшая гигиена проекта

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

Developer/SwiftFirst

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

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

Что может быть еще интересно по этой теме

Можно ли начать Swift без Xcode? Да, язык можно пробовать в Playground или через Swift tools. Но для SwiftUI и iOS нужен Xcode

Нужен ли платный Apple Developer Program? Для первых уроков и запуска в Simulator не нужен. Платная программа нужна для публикации и некоторых возможностей устройства

Почему Xcode такой большой? Потому что это не только редактор. Внутри SDK, Simulator, инструменты сборки, отладка, профилирование и документация

Что открыть после установки? Optionals и базовый Swift. Чем лучше вы понимаете язык, тем легче будет читать SwiftUI-код

Что почитать дальше по Swift

• Swift с нуля: первая программа в Playground
• Optionals в Swift: ?, ! и безопасное извлечение
• SwiftUI: первый экран с Text, Button и @State
• async await в Swift: первый сетевой запрос