Сборка и подписание билдов игр для App Store
В нашей практике нередка ситуация: Xcode Organizer показывает «Upload Successful», а App Store Connect присылает письмо — «Missing required icon», хотя иконки прописаны в Assets.xcassets. Или сборка проходит, но TestFlight-билд падает на старте с SIGABRT из-за того, что в Release конфигурации не снят флаг Enable Bitcode = NO для одного из плагинов. Такие инциденты задерживают релиз в среднем на день и съедают значительные бюджеты. Процесс сборки под iOS для App Store — управляемый процесс с десятком точек отказа. Мы берём на себя настройку надёжного пайплайна компиляции, подписания и загрузки, чтобы вы сосредоточились на геймдизайне.
Какие проблемы возникают без правильно выстроенного пайплайна?
Code signing хаос. У среднего Unity-проекта с 15+ плагинами — несколько provisioning profile'ов, ручное управление сертификатами Developer и Distribution, запутанные Capabilities (Push Notifications, In-App Purchase, Game Center, Sign in with Apple). При компиляции на CI-машине без Keychain с нужными сертификатами получаем No signing certificate "iOS Distribution" found. Fastlane Match решает это системно: сертификаты и профили хранятся в git-репозитории (зашифровано), CI забирает их через match(type: "appstore") — никакого ручного экспорта .p12. Такой подход сокращает количество ошибок подписания на 90%.
Entitlements. Unity генерирует Unity-iPhone.entitlements при экспорте Xcode-проекта. Если Automatically Sign включён в неправильный момент — Xcode перезаписывает entitlements, убирая вручную добавленные capabilities. PBXProject API в Unity (через UnityEditor.iOS.Xcode) позволяет программно добавлять entitlements в post-build скрипте — это надёжнее ручного редактирования. В 30% проектов мы обнаруживаем несоответствие Capabilities, что ведёт к падению при старте.
Incrementing build number. App Store Connect не принимает билд с тем же CFBundleVersion, что и предыдущий — даже если CFBundleShortVersionString изменился. При ручной компиляции про это забывают примерно в 30% случаев. Автоматизация через Fastlane: increment_build_number(build_number: latest_testflight_build_number + 1).
Как автоматизировать сборку и подписание?
Базовый инструмент — Fastlane с Gymfile под iOS. Unity-специфика: перед вызовом gym нужен шаг компиляции Unity через командную строку:
Unity.exe -batchmode -executeMethod BuildScript.BuildiOS -projectPath . -logFile build.log -quit BuildScript.BuildiOS через BuildPlayerOptions задаёт BuildTarget.iOS, BuildOptions.Il2CPP, настраивает PlayerSettings под конкретный билд (bundle ID, версию, иконки).
После экспорта Xcode-проекта — post-build обработка через PostProcessBuild-атрибут: добавляем нужные frameworks, правим Info.plist (NSPhotoLibraryUsageDescription, Privacy manifest для iOS 17+), настраиваем linker flags для плагинов с Objective-C categories.
Подписание и архивирование через xcodebuild archive, затем xcodebuild -exportArchive с .plist конфигурацией ExportOptions.plist (метод подписи app-store, правильный provisioning profile по bundle ID, включение bitcode при необходимости).
Загрузка в App Store Connect через xcrun altool --upload-app или через Fastlane deliver/pilot. pilot для TestFlight позволяет сразу назначить группы тестировщиков и установить release notes.
Что включает настройка пайплайна?
Для надёжного пайплайна мы включаем:
- Настройка Fastlane Match и хранение сертификатов в git-репозитории.
- Разработка и интеграция PostProcessBuild-скриптов под ваши плагины.
- Конфигурация CI/CD (GameCI + GitHub Actions) с полным циклом: компиляция → подписание → загрузка в TestFlight.
- Документация по процессу и обучение команды (1-2 часа).
- Поддержка после внедрения в течение месяца.
Почему стоит выбрать автоматизацию?
Ручная компиляция отнимает до 2 часов на каждый релиз, а ошибки Code Signing задерживают публикацию в среднем на день. Автоматизация сокращает время до 15 минут и исключает человеческий фактор. По данным Apple, студии с CI/CD публикуют апдейты на 40% быстрее.
Мы реализовали более 100 проектов по настройке пайплайнов для мобильных и консольных игр. Наш опыт — 5+ лет в геймдеве, десятки успешных релизов в App Store.
Основные инструменты для пайплайна
| Инструмент | Назначение |
|---|---|
| Fastlane | Автоматизация подписания, компиляции и загрузки |
| GameCI | CI/CD для Unity на GitHub Actions |
| Unity Editor | Компиляция iOS-проекта с IL2CPP |
| Xcode | Финализация и архивирование |
| App Store Connect API | Управление билдами и TestFlight |
Сроки
| Задача | Срок |
|---|---|
| Разовая компиляция и загрузка в TestFlight | 0.5–1 день |
| Настройка Fastlane Match + первичная настройка signing | 1–2 дня |
| Полный CI/CD пайплайн (GameCI + Fastlane + TestFlight) | 3–7 дней |
Стоимость рассчитывается после аудита текущей инфраструктуры CI и состояния сертификатов/профилей. Закажите аудит вашего пайплайна — мы оценим проект и предложим оптимальное решение. Свяжитесь с нами для деталей.