Компиляция Flutter под iOS: от кода до App Store

• В разделе Profiles нажмите + и выберите тип профиля (App Store для релиза)
• Привяжите профиль к App ID и сертификату
• Для Development-профиля добавьте UDID тестовых устройств
• Скачайте профиль и перетащите его в Xcode (или в папку проекта)

4. Настройка сборки в Xcode

Теперь, когда сертификаты и профили на месте, вернёмся к Xcode. В верхней панели выберите целевое устройство (Any iOS Device для релизной сборки) и схему (Runner). Затем:

1. Выберите команду сборки:
   • Для отладки: Product → Archive (но предварительно подключите физическое устройство или выберите симулятор)
   • Для релиза: Product → Archive (соберёт .ipa для App Store)
2. Настройте схему подписи:
   • Откройте Runner → Signing & Capabilities
   • В поле Team выберите ваш Apple Developer Account
   • Убедитесь, что Bundle Identifier совпадает с App ID из профиля
   • В разделе Provisioning Profile выберите ранее созданный профиль

• Перейдите во вкладку Build Settings
• Найдите Code Signing Identity и выберите соответствующий сертификат (Apple Distribution для релиза)
• Убедитесь, что Enable Bitcode установлен в No (требование Flutter)

Если всё настроено правильно, при нажатии Product → Archive Xcode начнёт сборку. Процесс может занять от 1 до 10 минут в зависимости от сложности проекта. По завершении откроется окно Organizer, где вы сможете просмотреть архив и загрузить его в App Store Connect.

5. Сборка и экспорт .ipa-файла

После успешной архивации в Xcode Organizer вы увидите список архивов. Выберите последний и нажмите Distribute App. Далее следуйте шагам мастера:

1. Выберите метод распространения:
   • 📱 App Store Connect — для загрузки в магазин
   • 📦 Ad Hoc — для тестирования на ограниченном числе устройств
   • 🔗 Development — для отладки
   • 💾 Enterprise — для внутреннего распространения (требует Enterprise Account)
2. Настройте параметры экспорта:
   • Для App Store выберите Automatic signing (если профили настроены правильно)
   • Укажите App Store Connect API key (если используете fastlane или CI/CD)
   • Проверьте, что Rebuild from Bitcode отключён (если используется Flutter)

• Нажмите Export и сохраните файл в удобное место
• Для App Store дождитесь завершения загрузки в App Store Connect

Критическая деталь: если вы используете плагины с нативным кодом (например, firebase_messaging или google_sign_in), убедитесь, что они поддерживают arm64-архитектуру. В 2026 году App Store отклоняет приложения, собранные без поддержки 64-битных процессоров.

После экспорта вы получите файл app.ipa, который можно:

• 📤 Загрузить в App Store Connect через Transporter или Xcode
• 📱 Установить на тестовые устройства через TestFlight или Diawi
• 🔍 Проанализировать на ошибки через flutter analyze

6. Загрузка в App Store Connect и публикация

Перед загрузкой в App Store убедитесь, что:

• 📋 В App Store Connect создано приложение с тем же Bundle ID, что и в проекте
• 📸 Загружены все необходимые скриншоты (для всех поддерживаемых устройств и локализаций)
• 📝 Заполнено описание, ключевые слова и контактная информация
• 🔞 Указан возрастной рейтинг (требуется для всех приложений)
• 💳 Настроена цена и доступность (даже для бесплатных приложений)

Для загрузки архива:

1. Откройте App Store Connect и перейдите в раздел Мое приложение → [Ваше приложение] → TestFlight / App Store
2. Нажмите + рядом с Сборки и выберите загруженный архив
3. Дождитесь обработки (может занять до 30 минут)
4. После проверки нажмите Отправить на ревью

Среднее время модерации в App Store — 24–48 часов, но в пиковые периоды (например, перед праздниками) может растянуться до 3–5 дней. Частые причины отклонения:

• 🚫 Отсутствие поддержки iOS 15+ (проверьте в Info.plist)
• 🚫 Несоответствие скриншотов реальному интерфейсу
• 🚫 Отсутствие политики конфиденциальности (обязательно для всех приложений)
• 🚫 Использование недокументированных API (проверяется автоматически)

7. Решение типичных ошибок при сборке

Даже у опытных разработчиков сборка под iOS часто сопровождается ошибками. Вот самые распространённые и способы их исправления:

Если ошибка не из таблицы, попробуйте:

1. Очистить проект в Xcode: Product → Clean Build Folder
2. Удалить папку ios/Pods/ и выполнить pod install заново
3. Обновить Flutter и плагины: flutter upgrade + flutter pub upgrade
4. Проверьте логи сборки в Xcode (вкладка Report Navigator)

8. Автоматизация сборки с помощью CI/CD

Если вы планируете часто обновлять приложение, ручная сборка через Xcode станет утомительной. Для автоматизации используйте CI/CD-сервисы:

• 🤖 GitHub Actions — бесплатно для публичных репозиториев
• 🔄 Bitrise — специализирован для мобильной разработки
• 🚀 Codemagic — оптимизирован под Flutter
• 🌐 Fastlane — инструмент для автоматизации загрузки в App Store

Пример конфигурации для GitHub Actions (.github/workflows/ios_build.yml):

name: iOS Build and Deploy

on:
push:
branches: [ main ]

jobs:
build:
runs-on: macos-latest
steps:
- uses: actions/checkout@v3
- uses: subosito/flutter-action@v2
with:
flutter-version: '3.13.0'
- run: flutter pub get
- run: cd ios && pod install --repo-update
- run: flutter build ios --release --no-codesign
- run: xcodebuild -workspace ios/Runner.xcworkspace -scheme Runner -configuration Release archive -archivePath $PWD/build/Runner.xcarchive
- run: xcodebuild -exportArchive -archivePath $PWD/build/Runner.xcarchive -exportOptionsPlist ios/ExportOptions.plist -exportPath $PWD/build

Для Fastlane создайте файл Fastfile в папке ios:

default_platform(:ios)

platform :ios do
desc "Build and upload to App Store Connect"
lane :beta do
build_app(
scheme: "Runner",
export_method: "app-store",
output_name: "app_#{Time.now.strftime('%Y%m%d')}.ipa"
)
upload_to_app_store
end
end

Преимущества CI/CD:

• ⏱️ Сборка запускается автоматически при каждом коммите
• 🔍 Тесты и линтинг выполняются до сборки
• 📦 Автоматическая загрузка в TestFlight или App Store
• 📊 Логи сборки сохраняются для анализа

FAQ: Частые вопросы по сборке Flutter под iOS

flutter build ios --release --export-method ad-hoc