В документации Unity для версии 6.6 указана ветка редактора 6000.6 — официальные материалы по iOS-сборке Unity 6.6 описывают переход от проекта Xcode к сборке средствами Xcode. Практический вывод: Unity формирует проект, а окончательные сборка, кодовая подпись и архивация выполняются в macOS. Подготовьте проект на своей рабочей станции, безопасно перенесите его на удалённый Mac, затем проверьте подпись и архив отдельно от факта загрузки в App Store Connect.
Эта инструкция для вас, если вы разрабатываете игру в Unity 6.6 на Windows или Linux и готовите выпуск для iOS.
Она также пригодится, если проект Xcode уже экспортирован и вы ищете среду для подписания, архивации и проверки перед загрузкой.
Небольшой команде она поможет превратить ручную сборку в воспроизводимый процесс на удалённом Mac.
Подготовьте Unity-проект и параметры выпуска
До экспорта определите, для какого устройства и типа сборки вы готовите проект. Проверьте идентификатор приложения, настройки ориентации и необходимые разрешения, а также выясните, использует ли игра нативные плагины или собственные скрипты сборки. Ошибка на этом этапе может проявиться не при экспорте, а позже — например, при настройке Xcode target или подписи.
Документация по настройкам сборки iOS в Unity 6.6 описывает параметры, которые влияют на создаваемый проект. Сверяйте названия и поведение настроек с документацией именно той версии редактора, которой пользуется ваша команда: не переносите на Unity 6.6 инструкции для другой версии без проверки.
| Что проверить до экспорта | Где сверить | Почему это важно на удалённом Mac |
|---|---|---|
| Идентификатор приложения и настройки целевой сборки | Настройки проекта Unity и документация Unity | Xcode должен получить параметры, соответствующие приложению и плану выпуска |
| Нативные плагины и связанные файлы | Документация каждого плагина и состав проекта | Одного файла проекта Xcode может быть недостаточно для сборки |
| Цель экспорта и создаваемая структура | Описание структуры Xcode-проекта Unity | По структуре нужно определить, какой проект или workspace открывать и что передавать |
Разделяйте два результата. Экспорт из Unity создаёт основу проекта Xcode; он сам по себе не означает, что приложение уже собрано, подписано или готово к распространению. Затем Xcode использует этот проект вместе с доступной средой разработки и настройками подписи. Это различие задаёт порядок диагностики: сначала выясняйте, корректно ли Unity подготовила проект, и только потом ищите причину в Xcode.
Что передавать, если Xcode-проект сгенерирован на другой машине? Передавайте весь экспортированный проект вместе с файлами, которые нужны для его сборки: ресурсами, исходным кодом плагинов и конфигурацией, если они входят в проект. Не ограничивайтесь файлом проекта Xcode. Состав зависимостей зависит от конкретной игры, поэтому сверяйте его с каталогами проекта, настройками версий и документацией используемых компонентов.
Сформируйте переносимую и безопасную копию
Передайте проект на удалённый Mac через систему контроля версий или защищённый канал передачи файлов. В обоих случаях цель одна: получить на Mac согласованную рабочую копию, соответствующую определённому состоянию проекта. Зафиксируйте, из какой ветки или ревизии создан экспорт, а после передачи проверьте, что на удалённой машине присутствуют нужные каталоги и файлы.
Условный пример передачи архива по SSH:
scp ./ios-export.zip user@remote-mac:/path/to/incoming/
Здесь user, адрес узла и путь — заполнители, которые нужно заменить параметрами вашего доступа. Команда передаёт архив, но не доказывает, что он распакован полностью или содержит все зависимости. После переноса распакуйте проект в рабочий каталог, сравните состав с исходной копией и откройте нужный файл проекта или workspace, ориентируясь на структуру, созданную Unity и зависимостями.
| Способ подготовки копии | Что он упрощает | Что проверить перед сборкой |
|---|---|---|
| Клонирование репозитория | Сохраняет историю изменений и связь с исходным кодом | Все нужные файлы включены в репозиторий или восстановлены отдельно |
| Защищённая передача архива | Позволяет передать конкретное состояние экспортированного проекта | Архив распакован, а пути и ресурсы доступны |
| Передача только файла проекта | Удобна лишь как способ переноса самого файла | Не подходит как замена полной передаче зависимостей и ресурсов |
Секреты подписи не должны становиться частью проекта. Не добавляйте в репозиторий сертификаты с закрытым ключом, приватные ключи, пароли или иные конфиденциальные данные. Apple отдельно описывает типы сертификатов и необходимость защищать связанные с ними материалы в руководстве по сертификатам Apple Developer. Перенос исходного кода и перенос полномочий на подпись — разные задачи; ограничьте доступ к секретам тем, кому он действительно нужен.
Перед передачей проверьте, как устроены удалённый доступ и хранение рабочих материалов. Эти детали влияют на безопасность не меньше, чем выбор способа экспорта.
Проверьте Xcode и зависимости до компиляции
Когда проект окажется на удалённом Mac, сначала проверьте фактическое состояние среды. Не делайте вывод о совместимости только по номеру Unity: версия Xcode, целевой SDK, плагины и собственные скрипты могут внести дополнительные требования. Сверьте рекомендации Unity по настройке iOS-среды, а затем отдельно проверьте официальные инструкции для используемых плагинов и зависимостей.
В терминале можно посмотреть установленную версию Xcode и перечень схем проекта:
xcodebuild -version
xcodebuild -list -project /path/to/Unity-iOS.xcodeproj
Если Unity или зависимость создала workspace, укажите его соответствующим параметром вместо -project. Путь в примере условный: выберите реальный файл в экспортированной структуре. Первая команда показывает версию установленного Xcode; вторая помогает увидеть, какие схемы доступны для переданного проекта. Сам вывод этих команд не подтверждает, что все плагины совместимы или что настройки подписи корректны.
| Компонент | Что зафиксировать | Как действовать при несоответствии |
|---|---|---|
| Xcode | Установленная версия и выбранный рабочий проект или workspace | Сверить требования проекта и официальные материалы Apple и Unity |
| SDK и параметры цели | Значения, с которыми собирается приложение | Проверить настройки проекта, target и документацию Unity |
| Плагины и нативный код | Требования и шаги первоначальной настройки | Повторить описанную поставщиком процедуру и подтвердить её на целевом проекте |
| Pods или иные зависимости | Наличие файлов конфигурации и ожидаемый способ установки | Не угадывать команду; использовать инструкцию конкретной зависимости |
Если проект использует Pods или собственные скрипты, запишите, что именно запускается при первоначальной настройке. Не заменяйте эту проверку универсальной командой из чужого проекта: конфигурация зависит от конкретных зависимостей. Сначала выполните документированные для проекта действия, затем откройте Xcode и проверьте, что схема сборки и необходимые файлы доступны.
Как передать экспорт Unity на удалённый Mac без потери связей? Передавайте целую рабочую копию, а не отдельный .xcodeproj. Если проект использует workspace, Pods или внешние ресурсы, они должны быть доступны на целевой машине по правилам этого проекта. После клонирования или распаковки зафиксируйте ревизию и повторите установку зависимостей по их официальным инструкциям.
Для постоянной сборочной машины дополнительно оцените, кто может подключаться к ней и как хранятся учётные данные. Не передавайте доступ к системе как замену отдельному управлению сертификатами и ключами.
Настройте кодовую подпись в соответствии с выпуском
Перед сборкой сопоставьте параметры Unity, настройки target в Xcode и материалы Apple Developer. Идентификатор приложения должен соответствовать задаче выпуска; выбранная команда, entitlements и профиль должны относиться к этому приложению и целевому сценарию. Если проект имеет несколько targets, проверяйте каждый из них отдельно, а не исходите из того, что настройка основного приложения автоматически подходит всем компонентам.
| Элемент проверки | На что смотреть | Типичная ошибка в процессе |
|---|---|---|
| Bundle Identifier | Совпадает ли идентификатор с ожидаемым приложением | В проекте остался идентификатор от тестовой конфигурации |
| Team и сертификат | Выбрана ли нужная команда и доступна ли идентичность подписи | На удалённом Mac отсутствует подходящий сертификат или закрытый ключ |
| Provisioning Profile | Соответствует ли профиль приложению и выбранному сценарию | Профиль не согласован с идентификатором или требуемыми возможностями |
| Entitlements | Совпадают ли включённые возможности с настройками приложения | В подписи отсутствуют необходимые разрешения или присутствуют лишние |
| Конфигурация сборки | Выбран ли target и вариант, предназначенный для текущей задачи | Архив собирается не из того target или не с теми параметрами |
Для разработки профиль создаётся с учётом приложения и сертификата; соответствующий порядок описан в руководстве Apple по профилям разработки. Для распространения проверьте актуальные требования Apple к выбранному сценарию и настройкам проекта в документации по подготовке приложения к распространению. Не переносите параметры профиля разработки на выпуск автоматически: назначение профиля имеет значение.
Какие настройки подписи проверить прежде всего? Сверьте идентификатор приложения, команду, сертификат, provisioning profile и entitlements на уровне нужного target. Затем убедитесь, что выбран подходящий вариант сборки для текущего этапа. Если подпись не проходит, сохраните сообщение Xcode и сначала определите, какой именно элемент не согласован, вместо случайной смены нескольких настроек одновременно.
Не путайте API-ключи App Store Connect с материалами кодовой подписи. Ключ авторизации для доступа к сервису не заменяет сертификат, закрытый ключ и профиль, которыми подписывается приложение. Не вставляйте содержимое приватных ключей и сертификатов в логи, тикеты или демонстрационные команды. При работе на удалённой машине проверьте, кто имеет доступ к сессии и к файлам, где хранятся материалы подписи.
Выполните сборку и создайте архив Xcode
Когда схема проекта открывается, зависимости доступны, а параметры подписи проверены, сначала выполните репрезентативную сборку. Её задача — выявить проблемы компиляции и конфигурации до перехода к архиву. Если она завершается ошибкой, определите этап по журналу: генерация Unity-проекта, подключение зависимости, компиляция Xcode или подписание. Исправляйте причину в соответствующем слое и сохраняйте исходный журнал до повторной попытки.
Для архивации используйте Xcode и его предусмотренный для проекта сценарий. Apple описывает подготовку архива и дальнейшие варианты в инструкции по распространению приложения для бета-тестирования и выпусков. Созданный архив — результат выполнения этапа архивации, а не свидетельство успешной загрузки или прохождения проверки со стороны App Store Connect.
Записывайте данные, которые позволят повторить сборку: ревизию проекта, используемую версию Unity, версию Xcode, выбранную схему, тип конфигурации и существенные изменения зависимостей. Включайте в заметки текст ошибки и этап, на котором она возникла, но удаляйте из журналов секреты. Это помогает сравнить попытки и не спутать результат изменения исходного кода с результатом изменения подписи.
Как получить архив, если Unity уже создала Xcode-проект? Откройте соответствующий проект или workspace на удалённом Mac, проверьте схему и параметры подписи, затем выполните сборку и используйте процесс архивации Xcode для выбранной цели. Если Xcode не может собрать приложение, вернитесь к журналу именно неудачного этапа: исправлять параметры архивации бессмысленно, пока не разрешена ошибка компиляции или зависимости.
Чтобы сделать ручной процесс воспроизводимым, храните рядом с результатом сборки заметку о ревизии и изменениях конфигурации, но не сами закрытые ключи. Для повторной попытки используйте ту же рабочую копию, если исправление не требует нового экспорта из Unity. Если изменились настройки экспорта, плагины или генерируемый код, заново сформируйте проект и повторите передачу, чтобы Xcode не собирал устаревшее состояние.
Проверьте архив и выберите следующий шаг
Перед загрузкой откройте архив в Xcode Organizer и проверьте, что он соответствует нужному приложению, конфигурации и текущей задаче выпуска. Затем выполните доступную проверку и изучите результат Xcode. Если проверка указывает на проблему с подписью, метаданными или настройками, вернитесь к соответствующему этапу, а не считайте архив готовым только потому, что он появился в Organizer.
| Результат проверки | Что он подтверждает | Чего он не подтверждает |
|---|---|---|
| Проект компилируется | Текущая конфигурация прошла компиляцию | Готовность архива к распространению |
| Xcode создал архив | Этап архивации завершился | Успешную загрузку в App Store Connect |
| Xcode выполнил доступную проверку архива | Архив прошёл конкретную проверку, результат которой показан в Xcode | Принятие сборки сервисом или одобрение приложения |
| Сборка видна в App Store Connect | Сервис получил запись о загрузке, состояние которой можно проверить | Завершение дальнейшей обработки или одобрение выпуска |
После загрузки отдельно проверьте состояние сборки и метаданных по справке App Store Connect о просмотре сборок. Не описывайте успешную архивацию как успешную загрузку; не описывайте появление сборки в сервисе как прохождение обработки или одобрение. Это отдельные статусы, и следующий шаг выбирайте по тому, что фактически показывает интерфейс.
Для решения, подходит ли удалённая среда под текущий проект, используйте условия, а не общее обещание совместимости:
- Если на удалённом Mac доступен требуемый для проекта Xcode и вы можете установить нужные зависимости, то перенесите полную рабочую копию и сначала проверьте сборку.
- Если подпись должна выполняться с вашей командой и необходимыми закрытыми ключами, то до запуска согласуйте безопасный способ их установки и хранения. Иначе остановитесь на проверке проекта без передачи секретов.
- Если сборка проходит, архив создаётся и проверка Xcode не сообщает блокирующих проблем, то переходите к загрузке и отдельно отслеживайте состояние сборки в App Store Connect.
- Если обнаружена ошибка компиляции, подписи или обработки, то вернитесь к журналу соответствующего этапа; не меняйте одновременно настройки Unity, Xcode и профиля без установленной причины.
- Если проект требует постоянной нагрузки, локального физического подключения или непрерывного контроля на вашей площадке, то сначала оцените собственное оборудование. Удалённая машина не устраняет требования, связанные с физическим доступом и особенностями проекта.
Подробности обработки проекта и доступа к данным стоит оценить до передачи исходников. В описании конфиденциальности VPSOmni можно сверить информацию, относящуюся к работе с данными. При выборе удалённой машины сопоставляйте её с реальной задачей: наличием подходящего Xcode, нужным способом доступа, безопасной передачей проекта и контролем секретов.
Текущая рабочая станция на Windows или Linux удобна для разработки Unity, но не заменяет среду macOS на этапе Xcode-сборки. Покупка собственного Mac даёт постоянный физический доступ, однако требует отдельного бюджета и обслуживания; публичный облачный конвейер может ограничивать доступ к инструментам, настройкам или секретам, нужным именно вашему проекту. Если вам нужно временно подготовить подпись и архив, удалённый Mac VPSOmni позволяет проверить эту часть процесса без покупки отдельного устройства. Перед выбором сопоставьте требования проекта с информацией о Mac mini; если же необходимы локальные порты, постоянный тяжёлый процесс или физический контроль, собственный Mac может оказаться практичнее.
Итоговый критерий для Unity 6.6 iOS-проекта на удалённом Mac — не сам факт экспорта, а подтверждённая цепочка: целая копия проекта, проверенные зависимости, согласованные настройки подписи, успешный архив и отдельно проверенный статус загрузки. Сначала проверьте требования конкретного проекта и среды, затем переходите к подписи и архивации; так вы сможете локализовать сбой и не перепутать готовый архив с принятым выпуском.
Читайте также
Подпишите и подготовьте архив проекта на удалённом компьютере VPSOmni
Выполните необходимые для iOS сборки и подписи в выделенной среде macOS без локального компьютера.
Арендовать удалённый Mac