Acelere las compilaciones de Xcode en CI
Última actualización
Las compilaciones de Xcode en CI son lentas por razones previsibles: descargas de paquetes en frío, recompilaciones completas, tiempo de arranque del simulador y pruebas ejecutándose en una VM pequeña. Como los minutos de Mac son caros, cada una de estas causas supone un coste real. Esta guía explica qué ayuda y qué no.
Fijar el entorno
Empiece por hacer que las ejecuciones sean comparables. Fije la imagen del runner y la versión de Xcode:
runs-on: macos-15
steps:
- uses: actions/checkout@v4
- run: sudo xcode-select -s /Applications/Xcode_16.4.app
- run: xcodebuild -version
Consulte qué versiones de Xcode están instaladas en el archivo readme del repositorio runner-images para su imagen; las rutas disponibles cambian al actualizarse las imágenes. Si usa macos-latest, su compilación puede cambiar sin previo aviso cuando cambie la versión predeterminada.
Almacenar en caché las dependencias de Swift Package Manager
Resolver y clonar paquetes puede tardar un minuto o más en un runner en frío. Indique a xcodebuild dónde guardar los clones y almacene ese directorio en caché:
- uses: actions/cache@v4
with:
path: .spm
key: spm-${{ runner.os }}-${{ hashFiles('**/Package.resolved') }}
restore-keys: spm-${{ runner.os }}-
- run: |
xcodebuild -resolvePackageDependencies \
-scheme MyApp \
-clonedSourcePackagesDirPath .spm
Pase el mismo -clonedSourcePackagesDirPath .spm a los comandos build y test posteriores. Incluya Package.resolved en el control de versiones para que la clave sea estable y las compilaciones reproducibles.
En el caso de CocoaPods, almacene en caché el directorio Pods usando Podfile.lock como clave o, mejor aún, almacene ~/.cocoapods y ejecute pod install para que el lockfile siga siendo la fuente de verdad. Los usuarios de Carthage deben almacenar en caché Carthage/Build y usar XCFrameworks con --use-xcframeworks.
DerivedData: con cuidado
Almacenar en caché ~/Library/Developer/Xcode/DerivedData es la solución que tienta para compilaciones lentas, y a menudo decepciona. Las decisiones de compilación incremental de Xcode dependen de las fechas de modificación de los archivos y de las rutas absolutas. Un git checkout nuevo asigna a cada archivo fuente una nueva fecha de modificación, de modo que Xcode lo considera todo modificado y recompila, después de haber pagado por restaurar una caché de varios gigabytes.
Lo que sí funciona:
- Almacenar en caché los productos de compilación por dependencia para las dependencias que no cambian, por ejemplo XCFrameworks precompilados generados para sus pods o paquetes, usando su versión como clave.
- Usar una caché del compilador como ccache para las partes en C, C++ y Objective-C, o una caché del sistema de compilación si usa Bazel o las funciones de caché de Tuist.
- Evitar una ruta de DerivedData compartida entre trabajos, salvo que la pruebe: establezca
-derivedDataPath buildpara que la ubicación sea explícita y la misma en cada ejecución.
Si prueba una caché de DerivedData, compare una ejecución en frío con una ejecución en caliente en el registro de compilación. Si la ejecución en caliente sigue compilando la mayoría de los archivos, elimine la caché: está usando almacenamiento de su límite de 10 GB por repositorio sin ningún beneficio.
Compilar una vez, probar en paralelo
Compile una vez y ejecute las pruebas de varias formas:
- run: |
xcodebuild build-for-testing \
-scheme MyApp \
-destination 'platform=iOS Simulator,name=iPhone 16' \
-derivedDataPath build \
-clonedSourcePackagesDirPath .spm
- run: |
xcodebuild test-without-building \
-scheme MyApp \
-destination 'platform=iOS Simulator,name=iPhone 16' \
-derivedDataPath build \
-parallel-testing-enabled YES
También puede subir los productos compilados como artefacto y repartir test-without-building entre varios trabajos con filtros -only-testing:. Cada trabajo adicional factura un mínimo de un minuto a la tarifa de Mac, así que hágalo solo para suites que tarden muchos minutos.
Abaratar las pruebas
- Elija un solo simulador para las compilaciones de PR, como el iPhone más reciente, y ejecute la matriz de dispositivos más amplia por la noche. Cada destino multiplica el tiempo de ejecución.
- Arranque el simulador con antelación para que se caliente mientras resuelve los paquetes:
xcrun simctl boot "iPhone 16"como paso en segundo plano. Consulte los dispositivos disponibles conxcrun simctl list devices available. - La ejecución en paralelo (
-parallel-testing-enabled YES) clona simuladores y ejecuta clases de prueba a la vez. Requiere pruebas que no compartan estado global, y consume más memoria, lo que importa en el runner estándar de 7 GB. - Omita las pruebas de UI en cada push. Las pruebas de UI son lentas e inestables; ejecútelas al hacer merge o al aplicar una etiqueta.
- Desactive la cobertura de código y los bundles de resultados innecesarios en las ejecuciones de PR:
-enableCodeCoverage NO.
Reducir el trabajo de compilación
- Use
-skipMacroValidationy-skipPackagePluginValidationsolo si confía en las macros y plugins de sus dependencias; de lo contrario, el CI se detiene esperando aprobación. Evalúe antes la compensación de seguridad. - Establezca
COMPILER_INDEX_STORE_ENABLE=NOen las compilaciones de CI. La indexación sirve al editor, no a la compilación. - Compile la configuración Debug para las pruebas. Las compilaciones Release con optimización de módulo completo son mucho más lentas y solo son necesarias para los archivos (archives).
- Divida los targets grandes en módulos para que los cambios recompilen menos. Esto también ayuda en las máquinas de los desarrolladores.
- Especifique
ARCHS=arm64(oONLY_ACTIVE_ARCH=YES) para las compilaciones de simulador, de modo que no compile para arquitecturas que el runner no usará.
Reducir la factura, no solo el tiempo
Los minutos de Mac son caros. Combine el trabajo de velocidad con las normas de coste de runners de macOS para CI de iOS: ejecute el linting en Linux, cancele las ejecuciones que hayan quedado obsoletas, establezca timeout-minutes y mida el coste por ejecución antes de pasar a un Mac más grande. Introduzca sus cifras en la calculadora de costes para ver el efecto mensual.
Un orden razonable
- Fije Xcode y la imagen del runner.
- Almacene en caché SPM o Pods.
- Separe la compilación de las pruebas con
build-for-testing. - Reduzca los destinos y las pruebas de UI en las ejecuciones de PR.
- Pruebe un runner más grande y compare el coste por ejecución.
Preguntas frecuentes
¿Debo almacenar DerivedData en caché?
Pruébelo antes de comprometerse con él. El checkout restablece las fechas de modificación de los archivos, lo que a menudo anula la lógica incremental de Xcode. Las cachés de dependencias son un primer paso más seguro.
¿Por qué mis pruebas en simulador son más lentas en CI que en local?
Los Mac de CI tienen menos núcleos y menos memoria que un portátil de desarrollo, y el simulador arranca en frío. Inícielo con antelación y reduzca el número de workers en paralelo si observa presión de memoria.
¿Un runner más grande ayuda a Xcode?
Normalmente sí, ya que Xcode compila en paralelo. El runner M2 Pro de 5 núcleos cuesta $0.102 por minuto frente a $0.062 del estándar, por lo que tiene que ser al menos 1.65 veces más rápido para resultar más barato.
¿Cómo encuentro los targets lentos?
Añada -showBuildTimingSummary a xcodebuild y lea el resumen al final del log, o active -Xfrontend -warn-long-function-bodies=500 de Swift para encontrar las funciones que tardan demasiado en comprobarse.
Compare con su propio proyecto
Los tiempos de compilación dependen en gran medida de su proyecto. El modo de comparación de compiler.dev le permite ejecutar un workflow de macOS en sus runners M4 Pro de acceso anticipado y comparar el tiempo de ejecución y el coste con su runner actual, sin cambiar el resto de su pipeline.
Relacionado
- Acelere un monorepo de TypeScript en GitHub ActionsAcelere la comprobación de tipos y el linting en un monorepo TypeScript con GitHub Actions: tsc incremental, referencias de proyecto y cachés.
- Acelere Playwright en un monorepo con GitHub ActionsAcelere las pruebas e2e de Playwright en un monorepo Node con GitHub Actions: compile la app una vez y omita e2e si no cambió.
- Añada una insignia de velocidad de CI a su READMEMuestre la velocidad de su CI con una insignia en el README: el tiempo mediano de ejecución en GitHub Actions, actualizado automáticamente. Gratis.
- Acelere .NET en GitHub ActionsAcelere las compilaciones de .NET en GitHub Actions: caché de NuGet con setup-dotnet, --no-restore, --no-build, dotnet test en paralelo y servicios SQL.