← Nesim Apps

El número de compilación de iOS que se quedó en 1: tres arreglos fallidos y uno que funcionó

Por Nesim Razon, desarrollador móvil independiente · 2026-11-17

#Notas de desarrollo#iOS

Cada subida a App Store Connect necesita un número de compilación mayor que el anterior. Nuestra canalización en la nube seguía produciendo un paquete con número de compilación 1, cambiáramos lo que cambiáramos. Hicieron falta tres intentos para descubrir por qué. Esta es la historia y la solución, para quien compile apps de iOS desde un proyecto de Xcode generado sin tener un Mac propio.

El síntoma

El paso de subida falló con un error que decía que la versión del paquete debe ser mayor que la subida anteriormente. La primera subida de una app siempre funciona, así que el problema solo aparece desde la segunda compilación. El número mostrado para la compilación en la tienda era 1 cada vez.

Intervienen dos números. La versión de marketing, como 1.0, es la que ven las personas. El número de compilación, CFBundleVersion, solo tiene que aumentar con cada subida de la misma versión de marketing.

Primer intento: opciones del archivo

La herramienta de compilación permite pasar opciones adicionales al comando de archivado, así que pasamos allí el número de compilación. No cambió nada. La opción se aceptó sin efecto alguno sobre el valor que acababa en el paquete.

Segundo intento: editar la descripción del proyecto

El proyecto se genera con XcodeGen a partir de un pequeño archivo de descripción, que tiene un campo para el número de compilación. Lo reescribimos con sed antes de generar el proyecto, con el número de ejecución de la integración continua. El proyecto generado contenía el valor nuevo, pero el paquete seguía diciendo 1.

El motivo es que el Info.plist que produce XcodeGen no toma el número de compilación de ese ajuste. Tiene su propio valor, y ese es el que se empaqueta.

Tercer intento y una idea mejor

Una tercera variante de la misma idea falló igual. Lo que había que cambiar no eran los ajustes de compilación, sino el archivo que realmente se lee: el Info.plist.

La solución: escribirlo en el Info.plist

Una vez generado el proyecto, un solo comando fija el valor directamente: PlistBuddy con Set :CFBundleVersion y el número. El número es 1000 más el contador de compilaciones del servicio de integración continua, de modo que siempre crece y no choca con subidas anteriores.

La segunda mitad de la solución es demostrarlo. Antes de subir, el script lee CFBundleVersion del paquete terminado y lo imprime en el registro. Si el valor es incorrecto, lo ves en un minuto y no después de una subida fallida.

Qué llevarse

Preguntas frecuentes

¿Cuál es la diferencia entre la versión y el número de compilación?

La versión es el número que ven los usuarios, por ejemplo 1.0. El número de compilación solo tiene que subir con cada subida de esa versión.

¿Por qué no funcionó editar la descripción del proyecto?

El Info.plist generado por XcodeGen no tomó el número de compilación de ese ajuste, así que el paquete conservó su propio valor.

¿Cómo se comprueba el valor empaquetado?

Se lee CFBundleVersion del Info.plist dentro del paquete terminado y se imprime en el registro de compilación antes de subir.

Más del blog