Configurar CI/CD de iOS en GitHub Actions desde cero

1. El esqueleto

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. Elige el Xcode

Las imágenes alojadas traen varias versiones de Xcode. Elige una de forma explícita para que una actualización de la imagen no te cambie el build sin avisar:

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

En un Mac dedicado, la versión se fija una vez en la máquina y este paso desaparece.

3. Dependencias

      - 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. Build y tests en un simulador

      - 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 }

Para las pull requests, para aquí. Todo lo que sigue es trabajo de release y va solo en main.

5. Firma de código sin compartir una cuenta del Mac

Usa una API key de App Store Connect en lugar de un Apple ID. Guarda el key ID, el issuer ID y el contenido del .p8 como secrets del repositorio. Y deja que xcodebuild firme con perfiles gestionados en la nube:

      - 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. Exporta y sube a 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 }}"

Muchos equipos envuelven los pasos 5 y 6 en fastlane. Los comandos de debajo son los mismos.

7. Adónde van los minutos, y qué runner elegir

En un runner alojado, los pasos 2 y 3 se repiten en cada job y se cobran a unos $0.062 a $0.102 el minuto. En un Mac dedicado se hacen una vez y las cachés siguen en caliente. Por eso los equipos que pasan de unos 2,242 minutos al mes llevan todo el pipeline a una máquina de precio fijo. Solo cambian la línea runs-on. La guía del pipeline en hardware dedicado cubre esa parte.