Не останавливайте сборки

Сначала проверьте текущую папку разработчика и версию, а также убедитесь, что нужная версия Xcode установлена. В примере системная папка по умолчанию меняется на /Applications/Xcode.app; для другой версии укажите фактический путь к приложению.

xcode-select -p
xcodebuild -version
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
xcodebuild -version
xcrun --find swift

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

DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer \
xcodebuild -list -workspace MyApp.xcworkspace

После переключения выведите список Scheme и выполните пробную сборку Archive. Если не хватает компонентов платформы или не завершена первоначальная настройка, сначала запустите нужные инструменты через графический интерфейс macOS, а затем возобновите автоматические задачи.

Подготовьте экспортированный сертификат с закрытым ключом, пароль к файлу и профиль подготовки, соответствующий идентификатору приложения и способу распространения. Один сертификат без связанного закрытого ключа обычно не позволяет подписать приложение.

1. Войдите в macOS под пользователем, от имени которого запускается сборка, откройте «Связку ключей» и импортируйте сертификат в его связку ключей.
2. Разверните сертификат и убедитесь, что под ним указан соответствующий закрытый ключ. Проверьте действующие идентификаторы подписи командой ниже.
3. Установите профиль подготовки в соответствии с используемой версией Xcode. В настройках подписи проекта проверьте Team, Bundle Identifier и способ распространения.
4. По отдельности проверьте настройки подписи приложения, Widget и Extension, затем выполните Archive и проверьте экспорт.

security find-identity -v -p codesigning

Окружение связки ключей у пользователя CI может отличаться от окружения пользователя удалённого рабочего стола. Для сборки без участия пользователя настройте в задаче разблокировку связки ключей и необходимые права доступа. Получайте пароль из защищённой переменной CI; не записывайте его в репозиторий, вывод команд или заявку.

Если ручная сборка проходит, а CI завершается с ошибкой, в первую очередь сравните пользователя, от имени которого выполняются задачи, и состояние связки ключей. При сообщении об ошибке подписи укажите только тип сертификата, срок действия и текст ошибки без конфиденциальных данных. Не загружайте закрытый ключ или пароль от сертификата.

Не рассчитывайте, что переустановка сохранит файлы. При ней могут быть удалены система и рабочая папка. До отправки запроса через консоль уточните объём работ и сохраните резервную копию за пределами узла. По окончании аренды диск стирается, поэтому использовать узел для восстановления после истечения срока аренды нельзя.

В резервную копию включите неотправленный в репозиторий исходный код, конфигурацию сборки, нужные артефакты, профили подготовки и защищённые материалы с ключами. Кэш DerivedData и каталоги загруженных зависимостей можно создать заново, но первая сборка после восстановления может занять больше времени.

Наличие резервной копии ещё не гарантирует, что её удастся восстановить. Распакуйте её в отдельную папку, проверьте число файлов и важные настройки, убедитесь, что можете получить последний артефакт, и только затем останавливайте задачи на исходном узле. После переустановки заново установите инструменты, восстановите среду подписи и зарегистрируйте runner.

Войдите в аккаунт, на который оформлен заказ, и проверьте в консоли экземпляр, срок аренды и доступные периоды продления. Затем оплатите выставленный счёт. Успешную оплату и новый срок аренды подтверждает актуальный ответ консоли, а не снимок экрана или страница, открытая до закрытия браузера.

Поддерживаются только USDT-TRC20 и Visa / Mastercard / Amex через Stripe. Все платежи проводятся в долларах США; доступные способы оплаты определяются ответом серверного интерфейса. Перед переводом в блокчейне проверьте сеть, сумму и реквизиты получателя. После оплаты картой вернитесь в консоль и проверьте счёт.

Если статус счёта не совпадает со статусом экземпляра, укажите номер заказа, номер счёта и данные для поиска транзакции. Не пытайтесь исправить статус повторной оплатой и не отправляйте в заявке полный номер карты. До окончания аренды сохраните артефакты и нужные файлы: продление не заменяет резервное копирование.

Сначала проверьте в консоли адрес и порт узла, имя пользователя и состояние экземпляра. Отличайте тайм-аут подключения от ошибки аутентификации: в первом случае проверьте доступность сети, во втором — имя пользователя, пароль или ключ. У SSH и VNC разные данные подключения; не используйте их порты взаимозаменяемо.

ssh -v -p PORT USER@HOST

Замените PORTнаUSERиHOST фактическими данными. Если в журнале указано, что отпечаток ключа хоста изменился, сначала выясните причину по надёжной информации в консоли или через заявку. Не отключайте проверку подлинности хоста.

Удалённый рабочий стол подходит для проверки графического интерфейса macOS, связки ключей и настроек Xcode; SSH — для командной строки и CI. Перед отправкой журнала удалите конфиденциальные имена пользователей, адреса и локальные пути, оставив только тип ошибки и последовательность событий.

Проверьте четыре вещи: подключён ли runner, совпадают ли метки задачи, разрешено ли проекту использовать этот runner и от имени нужного ли пользователя работает процесс. Успешная регистрация означает лишь, что runner связан с проектом; это не гарантирует автоматическое назначение ему всех задач.

Сначала запустите тестовую задачу, которая выводит только сведения об инструментах. Проверьте пользователя, папку и версию Xcode, а затем добавьте установку зависимостей и подпись.

whoami
pwd
xcode-select -p
xcodebuild -version
security find-identity -v -p codesigning

Укажите в метках macOS, архитектуру чипа и назначение runner, а в настройках проекта явно выберите его. При первом подключении разрешите запуск только одной задачи. Проверьте, что кэш, связка ключей и папка артефактов не перезаписывают друг друга, и лишь затем постепенно увеличивайте параллелизм. Токен регистрации — это учётные данные: не добавляйте его в заявку или журнал сборки.

Сначала убедитесь, что выбраны нужные workspace, общий Scheme и конфигурация Release. Archive и сборка для симулятора — разные процессы; подпись, архитектуру и параметры экспорта для устройства нужно проверять отдельно.

xcodebuild -list -workspace MyApp.xcworkspace
xcodebuild archive \
  -workspace MyApp.xcworkspace \
  -scheme MyApp \
  -configuration Release \
  -destination 'generic/platform=iOS' \
  -archivePath build/MyApp.xcarchive

Сохраните первую содержательную ошибку вместе с контекстом, а не только заключительное сообщение о сбое. Отдельно проверьте установку зависимостей, этапы скриптов, подпись и запись на диск. После успешного Archive проверьте экспортированный артефакт: создание архива не означает, что пакет для распространения уже готов.

Сначала проверьте использование диска и состояние задач, затем отделите кэш, который можно создать заново, от артефактов, которые нужно сохранить. Не удаляйте каталог, пока его использует выполняющаяся задача; не считайте исходный код, материалы для подписи или ещё не загруженный Archive кэшем.

df -h
du -sh ~/Library/Developer/Xcode/DerivedData
du -sh ~/Library/Developer/Xcode/Archives

Задайте отдельные правила хранения для кэша и артефактов. После очистки первая компиляция и загрузка зависимостей могут идти медленнее — считайте её проверкой сборки с чистого состояния. Если места постоянно не хватает, сначала оцените рост проекта и артефактов, затем подберите более подходящую конфигурацию или дополнительный SSD.