Xcode для Flutter: iPhone, симулятор и программы для macOS

Чтобы запускать Flutter-приложение на iPhone, в симуляторе iPhone или как программу для macOS, нужен Xcode — среда разработки Apple. Xcode работает только на Mac, поэтому и собрать приложение для iPhone можно только на Mac.

Содержание:

1. Установка Xcode
2. Команды настройки
3. Платформа iOS и симулятор
4. Свой iPhone
5. Подпись приложения
6. Swift Package Manager и CocoaPods
7. Программа для macOS
8. Итог

1. Установка Xcode

Установите последнюю версию Xcode из Mac App Store . Другие версии Xcode и инструменты командной строки есть на developer.apple.com/download — для загрузки нужен Apple Account, платное членство в Apple Developer Program не требуется.

Xcode 27 требует macOS Tahoe 26.6 или новее. Flutter 3.47 работает с Xcode 15 и новее, а рекомендует — от Xcode 16.

Если у вас Mac на процессоре Intel: Flutter постепенно прекращает их поддержку — будущие версии будут требовать Mac на Apple Silicon.

2. Команды настройки

После установки выполните в Терминале (как его открыть и вставить команду — на странице Установка Git ). sudo попросит пароль вашей учётной записи Mac. Команда выбирает установленный Xcode и ставит нужные системные компоненты:

sudo sh -c 'xcode-select -s /Applications/Xcode.app/Contents/Developer && xcodebuild -runFirstLaunch'

Если Xcode лежит не в «Программах», замените /Applications/Xcode.app на свой путь. Затем примите лицензию Xcode:

sudo xcodebuild -license

Команда покажет лицензии — прочитайте их и согласитесь.

Проверить версию:

xcodebuild -version

Xcode 27.2
Build version 27B52

3. Платформа iOS и симулятор

Для iPhone скачайте поддержку iOS и симуляторы последней версии:

xcodebuild -downloadPlatform iOS

Запуск симулятора — в Xcode 27 он называется Device Hub :

open -a DeviceHub

В Xcode 26 и более ранних команда — open -a Simulator . Симулятор виден и Flutter:

flutter emulators

Id                  • Name          • Manufacturer • Platform

apple_ios_simulator • iOS Simulator • Apple        • ios

4. Свой iPhone

1. Подключите iPhone кабелем к Mac. На телефоне появится вопрос «Доверять этому компьютеру?» — нажмите Доверять .
2. Включите режим разработчика (Developer Mode): Настройки → Конфиденциальность и безопасность → Developer Mode (так пункт называет Apple), перезагрузите телефон и после перезагрузки подтвердите включение. Пункт появляется в настройках только после того, как телефон хоть раз подключали к Mac с Xcode — если его нет, откройте Xcode с подключённым телефоном.

5. Подпись приложения

Чтобы поставить приложение на iPhone, Xcode должен его подписать. Для проверки на своём телефоне хватит бесплатного Apple Account.

1. Откройте проект в Xcode — выполните в папке своего Flutter-проекта (его создадим в Уроке 1 ):

open ios/Runner.xcworkspace

1. Войдите в Apple Account: Xcode → Settings → Apple Accounts .
2. Выберите цель Runner , вкладку Signing & Capabilities , включите Automatically manage signing , в поле Team выберите свой Apple Account и задайте уникальный Bundle Identifier .
3. Запуск: в папке проекта выполните flutter devices — в списке будет iPhone и его id, — затем flutter run -d <id> . Если macOS спросит «codesign wants to access key…», введите пароль Mac и нажмите Always Allow .
4. Если iPhone не открывает приложение от неизвестного разработчика: Настройки → Основные → VPN и управление устройством , выберите свой профиль разработчика и нажмите Доверять , затем запустите приложение снова.

6. Swift Package Manager и CocoaPods

С Flutter 3.44 нативный код плагинов для iOS и macOS подключается через Swift Package Manager , он включён по умолчанию. CocoaPods Flutter использует только для плагинов, которые ещё не поддерживают Swift Package Manager; сам CocoaPods переведён в режим поддержки, а его каталог с 2 декабря 2026 станет доступен только для чтения.

flutter doctor по-прежнему проверяет CocoaPods: без него у строки Xcode стоит [!] и предупреждение CocoaPods not installed . Если вашим плагинам он понадобится, поставьте его по инструкции CocoaPods :

sudo gem install cocoapods

( sudo нужен, если вы используете Ruby, встроенный в macOS.)

7. Программа для macOS

Для программы под macOS нужен тот же Xcode с командами из раздела 2 — платформу iOS и симулятор качать не нужно. Запуск:

flutter run -d macos

Подпись для запуска на своём Mac не нужна, пока приложение не использует возможности, требующие профиля.

8. Итог

• Xcode — только на Mac; после установки: xcode-select … -runFirstLaunch и xcodebuild -license .
• Для iPhone: xcodebuild -downloadPlatform iOS , симулятор — open -a DeviceHub .
• Свой iPhone: доверие компьютеру, режим разработчика, подпись в Xcode (бесплатный Apple Account).
• Плагины — через Swift Package Manager; CocoaPods нужен только старым плагинам.

Установка самого Flutter — в Уроке 0 .