04
Первый шаг: подготовьте минимальный проект, а не большой учебный репозиторий
Новичку не стоит сразу подключать курсовой проект с несколькими библиотеками. Сначала лучше создать небольшой пример с одним экраном и одной проверяемой функцией. Это не требует отдельного сложного курса по CI/CD: задача состоит в том, чтобы проверить связку «Xcode — репозиторий — Xcode Cloud — результат».
Второй шаг: проверьте, что проект собирается в Xcode
Откройте проект на локальном или удалённом Mac, выберите нужную Scheme и соберите приложение без облака. Если локальная сборка уже завершается ошибкой, Xcode Cloud лишь покажет ту же проблему в другом месте.
Проверьте не только отсутствие красных ошибок, но и наличие всех файлов, правильную целевую платформу и выбранную конфигурацию. При работе с учебным шаблоном полезно сначала сделать чистую копию, чтобы не потерять исходное состояние.
Третий шаг: убедитесь, что зависимости доступны сборочной среде
Библиотеки и пакеты проекта должны быть доступны Xcode Cloud. Apple отдельно объясняет, как сделать зависимости доступными для облачной сборки (официальная документация по зависимостям).
Проверьте:
- откуда загружается каждая зависимость;
- не требует ли она локального файла, которого нет в репозитории;
- не закрыт ли доступ к нужному источнику;
- совпадают ли настройки проекта и репозитория;
- не зависит ли сборка от ручного действия на конкретном компьютере.
Если библиотека хранится только на школьном компьютере, облачная среда её не найдёт. Если проект использует секреты, ключи или сертификаты, их нельзя бездумно загружать в репозиторий. Доступы следует хранить по правилам курса и платформы, не передавать общий Apple-аккаунт другим участникам и не пытаться обходить ограничения школьного компьютера.
Четвёртый шаг: настройте первый workflow из Xcode
На этом этапе нужен именно Xcode. Вы выбираете проект, схему, события запуска и действия, которые должна выполнить система. Первый workflow — это не команда в браузере, а связка настроек проекта с автоматизированной сборкой.
Название workflow можно сделать понятным для учебной группы: например, отделить проверку тестов от подготовки архива. Не следует добавлять много действий до первой успешной сборки. Каждый лишний параметр создаёт ещё одну причину, по которой новичок не поймёт сообщение об ошибке.
Пятый шаг: дождитесь результата и изучите журнал
После запуска смотрите не только на итог «успешно» или «ошибка». Важны этап, на котором произошёл сбой, название Scheme, проблема зависимости и сообщение компилятора. Apple рекомендует проверять журналы и типовые причины конфигурационных ошибок, а не бесконечно повторять запуск (руководство по распространённым ошибкам сборки).
Сборочный артефакт, или архив, можно представить как упакованную версию курсовой работы: это уже не отдельные файлы исходников, а подготовленный результат, который можно передать для следующего этапа. Но архив не заменяет ручную проверку запуска приложения.
Шестой шаг: сравните облачную проверку с реальным запуском
После успешной сборки вернитесь в Xcode на Mac и повторите ключевой сценарий в симуляторе. Если задание связано с камерой, Bluetooth, уведомлениями, жестами или физическим устройством, особенно важно не ограничиваться журналом Cloud.
Этот этап показывает, где заканчивается автоматизация. Xcode Cloud хорошо выполняет одинаковую процедуру много раз, но не может догадаться, что кнопка перекрыта клавиатурой или что экран выглядит плохо на конкретном размере дисплея.