Сборка игры для iOS в Unity: полное руководство от А до Я

• В разделе Profiles выберите Development или Distribution.
• Привяжите профиль к вашему App ID и сертификату.
• Для Development добавьте UDID тестовых устройств (найти их можно в iTunes или через Xcode).

Внимание! Если вы используете Unity Cloud Build или CI/CD (например, GitHub Actions), потребуется экспортировать сертификаты в формате .p12 и загрузить их в систему сборки. Без этого автоматическая сборка не сработает.

После создания сертификатов и профилей скачайте их и установите на Mac двойным кликом. Unity автоматически обнаружит их при сборке, но иногда приходится указывать путь вручную в Player Settings → Publishing Settings.

4. Оптимизация производительности для iOS-устройств

iPhone и iPad имеют разные технические характеристики, и ваша игра должна хорошо работать как на iPhone 15 Pro с чипом A17 Pro, так и на iPhone SE 2020. Вот ключевые моменты оптимизации:

• 🎮 Графика:
  • Используйте Addressables для динамической загрузки текстур (экономит память).
  • Для 2D-игр отключите Mipmaps для спрайтов, если они не нужны.
  • Настройте Quality Settings в Unity под разные устройства (например, уменьшайте разрешение теней на слабых девайсах).
• 🔋 Производительность:
  • Включите Multithreaded Rendering в Player Settings (ускоряет рендеринг на многоядерных чипах).
  • Ограничьте FPS до 60 или 30 (в зависимости от жанра игры) с помощью Application.targetFrameRate.
  • Используйте Object Pooling вместо постоянного создания/уничтожения объектов.

Критическая ошибка многих новичков: игнорирование Metal API. С 2020 года Apple требует, чтобы все игры на iOS использовали Metal вместо OpenGL ES. В Unity это настраивается автоматически при выборе IL2CPP, но если вы используете кастомные шейдеры, проверьте их совместимость!

Для тестирования производительности:

1. Соберите билд в режиме Development Build (галочка в Build Settings).
2. Подключите iPhone к Mac и запустите игру через Xcode (так вы увидите логи в реальном времени).
3. Используйте Unity Profiler для анализа загрузки CPU/GPU и памяти.

{

QualitySettings.SetQualityLevel(2, true); // Средние настройки для A11 (iPhone 8/X)

}-->

5. Сборка и тестирование на устройстве

Когда проект настроен, пора собирать первый билд. Вот пошаговая инструкция:

1. Подключите iPhone или iPad к Mac через USB (разблокируйте устройство и подтвердите доверие компьютеру).
2. В Unity откройте Build Settings и нажмите Build (или Build And Run для автоматического запуска).
3. Выберите папку для сохранения .xcodeproj-файла (например, Builds/iOS).
4. После сборки Unity откроет проект в Xcode. Здесь нужно:

• 🔧 Выбрать целевое устройство в верхнем меню (рядом с кнопкой Play).
• 📱 Убедиться, что в Signing & Capabilities указан правильный Team и Bundle Identifier.
• 🔄 Нажать Build (или Cmd+B) для компиляции.

Если сборка прошла успешно, игра установится на устройство. Типичные ошибки на этом этапе:

• ❌ No signing certificate found → проверьте сертификаты в Keychain Access.
• ❌ Provisioning profile doesn't match bundle identifier → исправьте Bundle ID в Unity и Apple Developer Portal.
• ❌ Missing entitlements → добавьте недостающие Capabilities в Xcode (например, Keychain Sharing для сохранений).

Для ускорения тестирования используйте TestFlight:

1. Соберите билд в режиме Release (в Build Settings снимите галочку Development Build).
2. В Xcode выберите Generic iOS Device и архивируйте проект (Product → Archive).
3. В открывшемся окне нажмите Distribute App → TestFlight & App Store и загрузите архив.

6. Загрузка в App Store: требования и лайфхаки

Перед отправкой в App Store убедитесь, что ваше приложение соответствует правилам Apple. Вот ключевые моменты для игр:

• 📋 Метadata:
  • Название игры — до 30 символов (в App Store Connect).
  • Описание — минимум 2-3 абзаца, с ключевыми словами (но без спама!).
  • Скриншоты: 6.5" (iPhone), 5.5" (старые iPhone), 12.9" (iPad Pro).
  • Превью (видео) — до 30 секунд, показывающее геймплей.
• 🎯 Технические требования:
  • Поддержка Dark Mode (обязательно с 2023 года).
  • Нет жёсткой привязки к разрешению экрана (игра должна адаптироваться под iPhone 15 и iPad Mini).
  • Если есть покупки — тестовые аккаунты для Sandbox (настраивается в App Store Connect).

Процесс загрузки:

1. Архивируйте проект в Xcode (Product → Archive).
2. В окне Organizer выберите Distribute App → App Store Connect.
3. После загрузки перейдите в App Store Connect, выберите приложение и заполните все поля (включая цену, категорию, возрастной рейтинг).
4. Отправьте на ревью. Срок проверки — от 24 часов до 3 дней (иногда дольше).

Внимание! Если ваша игра использует Unity IAP для покупок, убедитесь, что:

• В App Store Connect добавлены все In-App Purchases (с теми же Product ID, что и в коде).
• Покупки протестированы в Sandbox (используйте тестовые аккаунты, не основной Apple ID!).
• Отключена опция Cleared for Sale до одобрения приложения.

После одобрения вы сможете выпустить игру вручную или настроить автоматический релиз. Не забывайте следить за отзывами и метриками в App Store Connect — Apple может заблокировать приложение, если пользователи жалуются на баги или мошенничество.

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

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

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

1. Поискать решение на официальном форуме Unity (используйте фильтр по тегу ios).
2. Проверьте логи в Xcode (View → Navigators → Show Report Navigator).
3. Соберите проект с флагом Development Build и проанализируйте ошибки в Unity Profiler.

Некоторые ошибки связаны с конкретными плагинами. Например, Firebase или Facebook SDK могут конфликтовать с настройками Unity. В таком случае:

• Проверьте документацию плагина на предмет совместимости с вашей версией Unity и iOS.
• Обновите плагин до последней версии.
• Если проблема остаётся — обратитесь в поддержку плагина (многие разработчики быстро отвечают на GitHub Issues).

8. Автоматизация сборки: CI/CD для iOS в Unity

Если вы работаете в команде или часто обновляете игру, ручная сборка становится утомительной. Автоматизировать процесс можно с помощью:

• 🤖 Unity Cloud Build:
  • Интегрируется с Apple Developer Account.
  • Поддерживает автоматическую загрузку в TestFlight.
  • Платный сервис (бесплатный тариф ограничен 1 сборкой в месяц).
• 🔄 GitHub Actions:
  • Бесплатно для публичных репозиториев.
  • Требует настройки yaml-конфига для сборки iOS.
  • Пример конфига можно найти в Marketplace.
• 🏗️ Jenkins или Bitrise:
  • Более гибкие решения для крупных проектов.
  • Позволяют тестировать билд на нескольких устройствах одновременно.

Для настройки CI/CD потребуется:

1. Экспортировать сертификаты и Provisioning Profiles в формате .p12 и .mobileprovision.
2. Зашифровать их и добавить в репозиторий (или использовать Secrets в GitHub Actions).
3. Написать скрипт для автоматической подстановки сертификатов в Xcode проект.

Пример базового скрипта для GitHub Actions:

name: Build iOS

on:
push:
branches: [ main ]

jobs:
build:
runs-on: macos-latest
steps:
- uses: actions/checkout@v2
- uses: game.ci/unity-builder@v2
with:
targetPlatform: iOS
- name: Decrypt certificates
run: |
openssl aes-256-cbc -d -in certs.p12.enc -out certs.p12 -k ${{ secrets.CERTS_PASSWORD }}
openssl aes-256-cbc -d -in profile.mobileprovision.enc -out profile.mobileprovision -k ${{ secrets.PROFILE_PASSWORD }}
- name: Build Xcode project
run: |
xcodebuild -project Builds/iOS/Unity-iPhone.xcodeproj -scheme Unity-iPhone -configuration Release

Автоматизация экономит время, но требует начальных затрат на настройку. Если у вас небольшой проект — возможно, проще собирать вручную.

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