Blog › Desarrollo iOS
Por qué fallan las builds de iOS en CI: las causas más comunes
Las razones habituales por las que una compilación de iOS falla en el servidor y funciona en tu Mac, y cómo diagnosticar cada una.
«En mi máquina funciona.» En desarrollo iOS, la frase tiene casi siempre explicación: el servidor de integración continua parte de un entorno limpio, y tu Mac lleva años acumulando configuración. Estas son las causas más frecuentes.
1. Firma de código
Certificados caducados, perfiles de aprovisionamiento que no incluyen una capacidad nueva o identificadores que no coinciden. Si el error menciona firma, certificados o perfiles, empieza por aquí.
2. Versión de Xcode distinta
El servidor usa otra versión de Xcode o del SDK. Código que compila con la última versión puede fallar con la anterior, y al revés. Fija la versión de forma explícita.
3. Dependencias
- Versiones no bloqueadas que se actualizan solas.
- Archivos de resolución de paquetes que no se han subido al repositorio.
- Repositorios privados a los que el servidor no tiene acceso.
4. Archivos que faltan en el repositorio
Un archivo de configuración ignorado por git, un recurso sin añadir, una clave que solo existe en tu Mac. En local funciona porque lo tienes; el servidor clona y no lo encuentra.
5. Tests inestables
Tests que dependen del orden de ejecución, de la hora, de la red o de animaciones. Pasan nueve veces y fallan la décima.
6. Tiempos de espera y recursos
El servidor puede ser más lento que tu máquina. Tests de interfaz con esperas ajustadas o compilaciones muy largas alcanzan el tiempo máximo.
7. Número de build repetido
Al subir a TestFlight, cada build necesita un número mayor que el anterior. Si no se incrementa automáticamente, la subida se rechaza.
8. Scripts de compilación
Fases de script que suponen herramientas instaladas en tu Mac y ausentes en el servidor.
Cómo diagnosticar
- Lee el primer error, no el último. Los siguientes suelen ser consecuencia.
- Compara con la última build correcta: ¿qué cambió?
- Reproduce en limpio: clona el repositorio en una carpeta nueva y compila.
- Relanza una vez para descartar un fallo puntual. Si falla de forma intermitente, hay un problema real.
Enterarte a tiempo
Cuanto antes sepas que una build ha fallado, más fácil es relacionarlo con el cambio que lo causó. Con Cloudbuild recibes avisos push de tus builds de Xcode Cloud en el iPhone, ves el historial por workflow y puedes relanzar una compilación sin abrir el Mac.
Prevención
Bloquea versiones, sube los archivos de resolución, automatiza los números de build y trata cada test inestable como un error.