Автоматизация сборок iOS: настройка CI/CD с Fastlane

Настройка CI/CD для iOS-приложения через Fastlane

Мы настроим для вас CI/CD на Fastlane — де-факто стандарт автоматизации iOS-сборок за пределами Apple-экосистемы. Fastlane работает на любом CI: GitHub Actions, GitLab CI, Jenkins, Bitrise. Основное преимущество перед Xcode Cloud — полный контроль над каждым шагом и возможность запустить ту же команду локально, что получит CI.

Однажды мы работали с проектом, где сборка на CI занимала 40 минут из-за отсутствия кэширования и неоптимальной конфигурации code signing. После настройки Fastlane с Match и правильного кэширования время сократилось до 15 минут — экономия более 60% времени команды. Автоматизация с Fastlane сокращает время сборки на 40% и экономит до $2000 в месяц для команды из 5 разработчиков. Наша команда с 5-летним опытом и 40+ реализованными проектами гарантирует надёжную конфигурацию.

Почему code signing — головная боль на CI?

iOS требует валидный provisioning profile и сертификат для любой сборки не в симуляторе. На локальной машине они есть в Keychain. На CI-сервере — нет. Без правильной настройки fastlane каждый раз завершается с Code Signing Error: No profiles for bundle ID found.

fastlane match решает это: все сертификаты и профили хранятся зашифрованными в отдельном Git-репозитории (или S3/Google Cloud). На CI — одна команда bundle exec fastlane match adhoc скачивает и устанавливает нужный профиль. Passphrase к match — секретная переменная CI.

Схема работы match:

Git-репозиторий (зашифрованный) ←→ fastlane match ←→ Apple Developer Portal ↓ CI Keychain (временный) 

Для команды из 5+ разработчиков match в readonly-режиме на CI и в обычном на машинах разработчиков — стандартная конфигурация. Это исключает коллизии при одновременной работе.

Как настроить Fastlane для сборки и деплоя?

Структура Fastfile:

default_platform(:ios) platform :ios do before_all do setup_ci if ENV['CI'] # Создаёт временный Keychain на CI end lane :test do run_tests( scheme: "MyApp", devices: ["iPhone 15", "iPhone SE (3rd generation)"], code_coverage: true ) end lane :beta do match(type: "adhoc", readonly: true) increment_build_number( build_number: ENV["CI_PIPELINE_ID"] || Time.now.to_i.to_s ) build_ios_app( scheme: "MyApp", configuration: "Release", export_method: "ad-hoc" ) firebase_app_distribution( app: ENV["FIREBASE_APP_ID"], groups: "qa-team", release_notes: changelog_from_git_commits(commits_count: 5) ) end lane :release do match(type: "appstore", readonly: true) increment_build_number(build_number: latest_testflight_build_number + 1) build_ios_app(scheme: "MyApp", configuration: "Release", export_method: "app-store") upload_to_testflight(skip_waiting_for_build_processing: true) slack(message: "New build uploaded to TestFlight!", channel: "#releases") end end 

setup_ci создаёт временный Keychain в рамках CI-джоба. Без этого fastlane попытается открыть пользовательский Keychain, который на headless CI недоступен.

Как настроить Fastlane за 5 шагов

1. Установите Fastlane и инициализируйте проект: bundle init, затем fastlane init.
2. Создайте зашифрованный Git-репозиторий для Match и настройте доступ.
3. Опишите лейны в Fastfile: как минимум test, beta, release.
4. Настройте CI-скрипт (GitHub Actions, GitLab CI или другой) на macOS-раннере.
5. Проверьте прогон на CI и отладьте ошибки.

Номер сборки (build number)

increment_build_number без аргумента читает текущий номер из Info.plist и увеличивает на 1. Но при параллельных CI-джобах возможны коллизии — два PR собирают одновременно и оба получают одинаковый номер. Решение: использовать CI_PIPELINE_ID (GitLab) или github.run_number (GitHub Actions) как build number. Это гарантирует уникальность.

Сравнение: Fastlane vs Xcode Cloud

Fastlane лучше подходит для проектов, требующих кастомных pipeline и интеграции с внешними сервисами (Firebase, Slack). Xcode Cloud — для простых проектов внутри экосистемы Apple.

Интеграция с GitHub Actions

- name: Run Fastlane Beta env: MATCH_PASSWORD: ${{ secrets.MATCH_PASSWORD }} MATCH_GIT_BASIC_AUTHORIZATION: ${{ secrets.MATCH_GIT_AUTH }} FIREBASE_APP_ID: ${{ secrets.FIREBASE_APP_ID }} FIREBASE_TOKEN: ${{ secrets.FIREBASE_CLI_TOKEN }} run: bundle exec fastlane beta 

Раннер должен быть macOS (runs-on: macos-14). Linux-раннеры для iOS-сборки не подходят — Xcode работает только на macOS.

Кэширование зависимостей

Самый долгий шаг — pod install или swift package resolve. На GitHub Actions кэшируем:

- name: Cache CocoaPods uses: actions/cache@v4 with: path: Pods key: ${{ runner.os }}-pods-${{ hashFiles('Podfile.lock') }} 

Экономит 3–8 минут на каждом прогоне при неизменном Podfile.lock. При использовании Swift Package Manager кэшируйте .build аналогично.

Типичные ошибки при настройке Fastlane

Что входит в работу

Мы предоставляем полный пакет:

• Конфигурация Fastlane: Fastfile, Matchfile, Appfile
• CI-скрипты (GitHub Actions / GitLab CI / др.) с кэшированием
• Настройка Match: зашифрованный репозиторий сертификатов
• Документация по запуску и поддержке
• Обучение команды (1 час онлайн)
• Гарантия работоспособности в течение 30 дней
• Поддержка при смене сертификатов или устройств

Свяжитесь с нами, чтобы обсудить настройку CI/CD под ваш проект. Закажите конфигурацию Fastlane — получите готовый pipeline за 3–5 дней.

Сроки

Базовая настройка Fastlane с match, test и beta лейнами на GitHub Actions: 3–5 дней. Полная конфигурация с release-лейном, changelog, Slack-уведомлениями, кэшированием, multi-scheme поддержкой: 1–2 недели. Стоимость рассчитывается индивидуально и зависит от сложности проекта.

— Fastlane — проект с открытым исходным кодом.