Настраиваем iOS CI/CD в GitHub Actions с нуля

1. Каркас

name: ios
on:
  pull_request:
  push:
    branches: [main]
concurrency:
  group: ios-${{ github.ref }}
  cancel-in-progress: true
jobs:
  build:
    runs-on: macos-latest      # or [self-hosted, macOS, your-label]
    timeout-minutes: 30
    steps:
      - uses: actions/checkout@v4

2. Выберите Xcode

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

      - run: sudo xcode-select -s /Applications/Xcode_26.6.app
      - run: xcodebuild -version

На выделенном Mac версия фиксируется на машине один раз, и этот шаг не нужен.

3. Зависимости

      - uses: actions/cache@v4
        with:
          path: |
            ~/Library/Caches/org.swift.swiftpm
            Pods
          key: ${{ runner.os }}-deps-${{ hashFiles('**/Package.resolved', '**/Podfile.lock') }}
      - run: pod install --repo-update   # CocoaPods projects only

4. Сборка и тесты на симуляторе

      - run: |
          xcodebuild test \
            -scheme MyApp \
            -destination 'platform=iOS Simulator,name=iPhone 17' \
            -resultBundlePath TestResults \
            | xcpretty
      - uses: actions/upload-artifact@v4
        if: failure()
        with: { name: test-results, path: TestResults }

Для pull request на этом остановитесь. Всё, что ниже, относится к релизу и запускается только на main.

5. Подпись кода без общего входа в Mac

Используйте ключ App Store Connect API вместо Apple ID. Сохраните ID ключа, issuer ID и содержимое .p8 как секреты репозитория. Пусть xcodebuild подписывает с профилями, которыми управляет облако:

      - run: echo "${{ secrets.ASC_KEY_P8 }}" > AuthKey.p8
      - run: |
          xcodebuild archive \
            -scheme MyApp -configuration Release \
            -archivePath build/MyApp.xcarchive \
            -allowProvisioningUpdates \
            -authenticationKeyPath "$PWD/AuthKey.p8" \
            -authenticationKeyID "${{ secrets.ASC_KEY_ID }}" \
            -authenticationKeyIssuerID "${{ secrets.ASC_ISSUER_ID }}"

6. Экспорт и загрузка в TestFlight

      - run: |
          xcodebuild -exportArchive \
            -archivePath build/MyApp.xcarchive \
            -exportPath build/export \
            -exportOptionsPlist ExportOptions.plist \
            -allowProvisioningUpdates \
            -authenticationKeyPath "$PWD/AuthKey.p8" \
            -authenticationKeyID "${{ secrets.ASC_KEY_ID }}" \
            -authenticationKeyIssuerID "${{ secrets.ASC_ISSUER_ID }}"
      - run: |
          xcrun altool --upload-app -f build/export/MyApp.ipa -t ios \
            --apiKey "${{ secrets.ASC_KEY_ID }}" --apiIssuer "${{ secrets.ASC_ISSUER_ID }}"

Многие команды оборачивают шаги 5 и 6 в fastlane. Команды под капотом те же.

7. Куда уходят минуты и какой раннер выбрать

На hosted раннере шаги 2 и 3 повторяются в каждой задаче и стоят примерно от $0.062 до $0.102 за минуту. На выделенном Mac они выполняются один раз, а кэши остаются прогретыми. Поэтому команды, которые тратят больше примерно 2,242 минут в месяц, переносят весь пайплайн на машину за фиксированную цену. Они меняют только строку runs-on. Руководство по пайплайну на выделенном железе описывает эту сторону.