Blog › Desarrollo iOS

Por qué fallan las builds de iOS en CI: las causas más comunes

· 2 min de lectura

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

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

  1. Lee el primer error, no el último. Los siguientes suelen ser consecuencia.
  2. Compara con la última build correcta: ¿qué cambió?
  3. Reproduce en limpio: clona el repositorio en una carpeta nueva y compila.
  4. 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.