Сборка и подписание билдов игр для App Store

Сборка и подписание билдов игр для 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.

Основные инструменты для пайплайна

Сроки

Стоимость рассчитывается после аудита текущей инфраструктуры CI и состояния сертификатов/профилей. Закажите аудит вашего пайплайна — мы оценим проект и предложим оптимальное решение. Свяжитесь с нами для деталей.

Когда ручная подготовка к релизу игр превращается в проблему?

Студия делает релиз мобильной игры. За неделю до даты менеджер вспоминает, что нужно собрать AAB, подписать, загрузить в Google Play. Сборщик вручную запускает билд, ждёт час, забывает включить IL2CPP, билд крашится на Android 12. Пересборка — ещё час. Параллельно надо переделать иконку под новые требования Google. В итоге релиз сдвигается на три дня. Наш опыт показывает: ручная подготовка к релизу игр — главный источник задержек и багов, которые не проявляются на машине разработчика.

Как настроить CI/CD для сборок мобильных игр?

Инструменты пайплайна

GameCI — open-source Docker-образы для Unity-сборок, работающие поверх GitHub Actions, GitLab CI или любого другого CI-провайдера. Ключевые компоненты: unity-builder (собирает под нужную платформу), unity-test-runner (запускает Unity Test Framework перед сборкой), unity-return-license (возвращает лицензию — критично для Pro). Unity Cloud Build проще, но менее гибок и дорог при частых сборках. Fastlane — стандарт для финальных шагов: подпись, загрузка в магазины, метаданные.

Типовой пайплайн

jobs:
  test:
    name: Run Unity Tests
    uses: game-ci/unity-test-runner@v4
    with:
      unityVersion: 2022.3.20f1
      testMode: playmode

  build-android:
    name: Build Android
    needs: test
    uses: game-ci/unity-builder@v4
    with:
      targetPlatform: Android
      androidKeystoreBase64: ${{ secrets.ANDROID_KEYSTORE_BASE64 }}
      androidKeystorePass: ${{ secrets.KEYSTORE_PASSWORD }}
      androidKeyaliasPass: ${{ secrets.KEY_PASSWORD }}

  upload-to-play:
    name: Upload to Google Play (Internal Track)
    needs: build-android
    uses: r0adkll/upload-google-play@v1
    with:
      serviceAccountJsonPlainText: ${{ secrets.SERVICE_ACCOUNT_JSON }}
      packageName: com.yourcompany.yourgame
      releaseFiles: build/Android/*.aab
      track: internal

Секреты, не переменные — все ключи в secrets CI. AAB вместо APK обязателен уже несколько лет. Треки: internal → closed → open → production. Продвижение — ручное или Fastlane supply promote.

iOS-специфика. Unity собирает Xcode-проект, затем xcodebuild. Нужны Distribution Certificate и Provisioning Profile (App Store). Fastlane Match решает проблему синхронизации сертификатов в команде:

lane :build_ios do
  match(type: "appstore", readonly: true)
  build_app(workspace: "Unity-iPhone.xcworkspace",
            scheme: "Unity-iPhone",
            export_method: "app-store")
  upload_to_testflight
end

App Store Connect API Key заменяет логин/пароль, не ломается при 2FA.

Почему App Store отклоняет около трети первых сабмишенов?

Apple отклоняет 30–40% первых сабмишенов новых студий. Частые причины:

Практика: перед сабмишеном пройти App Store Review Guidelines от начала до конца — 2–3 часа, экономящие 2–3 недели.

Google Play более лоялен: типичные причины — устаревший targetSdkVersion, избыточные разрешения, несоответствие Data Safety Form.

Что включает подготовка к релизу игр?

Автоматизация пайплайна заменяет ручную работу целого отдела. Например, настройка Continuous Integration через GameCI и Fastlane сокращает время подготовки к релизу игр втрое — с 8 рабочих часов до 2,5.

Как автоматизация пайплайна влияет на сроки и бюджет?

Ручной релиз мобильной игры стоит примерно $1200–$1500 (зарплата инженера на 2–3 дня, тестирование, переделки). Автоматизация CI/CD окупается в первые два месяца — снижает затраты на релиз на 40–60%. То есть каждый следующий релиз обходится на $500–$900 дешевле.

Сравнение подходов:

Результат: мы сокращаем цикл от коммита до публикации в 6–8 раз. Для проектов с частыми хотфиксами это разница между недельным ожиданием пользователей и исправлением за день.

После релиза: мониторинг и обновления

Краш-рейт < 1% (Firebase Crashlytics), ANR-рейт < 0.47% (Play Console) — иначе ограничения видимости. Phased rollout обязателен: сначала 10%, затем 50%, затем 100% пользователей.

Наш опыт — 30+ релизов мобильных игр, 5+ лет на рынке, более 50 проектов. Автоматизация CI/CD окупается в первые два месяца, снижая затраты на релиз на 40–60%.

Оставьте заявку — мы проанализируем ваш пайплайн и предложим решение за 2 дня. Получите консультацию инженера по подготовке к релизу игр под ключ.