Сборка и подписание билдов игр для 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.
Entitlements. Unity генерирует Unity-iPhone.entitlements при экспорте Xcode-проекта. Если Automatically Sign включён в неправильный момент — Xcode перезаписывает entitlements, убирая вручную добавленные capabilities. PBXProject API в Unity (через UnityEditor.iOS.Xcode) позволяет программно добавлять entitlements в post-build скрипте — это надёжнее ручного редактирования.
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 (метод подписи app-store, правильный provisioning profile по bundle ID, включение bitcode при необходимости).
Загрузка в App Store Connect через xcrun altool --upload-app или через Fastlane deliver/pilot. pilot для TestFlight позволяет сразу назначить группы тестировщиков и установить release notes.
Автоматизация на CI/CD
Для игровых студий оптимально — GameCI (GitHub Actions + Unity). Workflow: триггер на push в release ветку → сборка Unity → Fastlane signing → загрузка в TestFlight → Slack-уведомление.
Секреты (сертификаты, Apple ID credentials, App Store Connect API key) хранятся в GitHub Secrets или Vault. Apple рекомендует переходить с username/password на App Store Connect API Key (JWT) — надёжнее и не требует двухфакторной аутентификации в CI.
Сроки
| Задача | Срок |
|---|---|
| Разовая сборка и загрузка в TestFlight | 0.5–1 день |
| Настройка Fastlane Match + первичная настройка signing | 1–2 дня |
| Полный CI/CD пайплайн (GameCI + Fastlane + TestFlight) | 3–7 дней |
Стоимость определяется после аудита текущей инфраструктуры CI и состояния сертификатов/профилей.